DevOps инструменты

В этой директории находятся инструменты для автоматизации DevOps-задач проекта.

Внесенные изменения

Централизация конфигурации

• ✅ Создан единый файл конфигурации config.json для всех инструментов
• ✅ Создан файл-пример config.example.json с комментариями
• ✅ Разработан модуль config_loader.py для загрузки конфигурации в Python-скриптах
• ✅ Создан скрипт export_config.sh для использования конфигурации в bash-скриптах
• ✅ Удалены захардкоженные данные из скриптов GitLab и Vercel
• ✅ Обновлены все скрипты для использования централизованной конфигурации

Организация файловой структуры

• ✅ Создана структура директорий для логов: logs/gitlab и logs/vercel
• ✅ Добавлены правила по работе с логами в logs/README.md
• ✅ Очищены тестовые и временные файлы

Документация

• ✅ Создан подробный справочник по конфигурации CONFIG_REFERENCE.md
• ✅ Обновлена инструкция по установке SETUP.md
• ✅ Создана инструкция по обновлению HOW_TO_UPDATE.md

Структура директорий

devops-tools/
├── ci/                     # Инструменты CI/CD (Python)
│   ├── im_automation.py    # Инструменты для IM.js
│   ├── logger.py           # Модуль логирования
│   ├── logs_utils.py       # Утилиты для работы с логами
│   ├── mcp_checker.py      # Проверка MCP
│   └── run_diagnostics.py  # Диагностика проекта
├── docs/                   # Документация
│   └── reports/            # Автоматически сгенерированные отчеты
├── gitlab/                 # Инструменты для GitLab (Bash)
│   ├── auto_gitlab.sh      # Автоматизация работы с GitLab
│   ├── auto_gitlab_cron.sh # Cron-версия скрипта
│   ├── fix_pipeline_errors.sh # Исправление ошибок в pipeline
│   └── gitlab_tools.py     # Python-утилиты для GitLab API
├── logs/                   # Логи работы инструментов
│   ├── gitlab/             # Логи GitLab скриптов
│   └── vercel/             # Логи Vercel скриптов
├── vercel/                 # Инструменты для Vercel
├── config.json             # Основной конфигурационный файл
├── config.example.json     # Пример конфигурационного файла
├── config_loader.py        # Модуль для загрузки конфигурации
├── CONFIG_REFERENCE.md     # Справочник по конфигурации
├── export_config.sh        # Скрипт для экспорта конфигурации
├── HOW_TO_UPDATE.md        # Инструкция по обновлению
├── README.md               # Этот файл
└── SETUP.md                # Инструкция по установке

Быстрый старт

1. Создайте свой конфигурационный файл на основе примера:

cp config.example.json config.json

2. Отредактируйте config.json, заполнив необходимые поля для вашего проекта

3. Запустите диагностику для проверки настройки:

python ci/run_diagnostics.py

Документация

• CONFIG_REFERENCE.md - подробное описание всех полей конфигурации
• SETUP.md - инструкция по установке и настройке
• HOW_TO_UPDATE.md - инструкция по обновлению инструментов

Использование конфигурации

В Python-скриптах

from config_loader import ConfigLoader

# Получение конфигурации GitLab
gitlab_config = ConfigLoader.get_gitlab_config()
project_id = ConfigLoader.get_gitlab_project_id()

# Получение путей к файлам проекта
paths = ConfigLoader.get_project_paths()
project_path = paths.get("project_path")

В Bash-скриптах

source /path/to/export_config.sh

# Теперь у вас доступны переменные:
echo $GITLAB_PROJECT_ID
echo $GITLAB_PROJECT_PATH
echo $VERCEL_ID

Запуск инструментов

GitLab

# Проверка статуса pipeline
./gitlab/auto_gitlab.sh check

# Автоматическое исправление ошибок
./gitlab/fix_pipeline_errors.sh

Диагностика проекта

python ci/run_diagnostics.py