Как настроить CI/CD?

Как настроить CI/CD

CI/CD (Continuous Integration / Continuous Deployment) — это один из самых важных инструментов в современной разработке. За 10+ лет я настраивал CI/CD для проектов разного размера.

Что такое CI/CD

• CI (Continuous Integration): автоматические тесты и проверки на каждый коммит
• CD (Continuous Deployment): автоматическое развёртывание в production

Минимальный стек для Python проекта

Инструменты:

• GitHub Actions (бесплатно для публичных репо)
• pytest для тестов
• ruff / black для линтинга
• Docker для контейнеризации (опционально)

Пошаговая настройка

Шаг 1: Структура проекта

my-project/
├── .github/
│   └── workflows/
│       ├── test.yml
│       ├── lint.yml
│       └── deploy.yml
├── src/
├── tests/
├── pyproject.toml
├── requirements.txt
└── Dockerfile

Шаг 2: GitHub Actions для тестирования

name: Tests

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ['3.9', '3.10', '3.11']
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python-version }}
      
      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
          pip install pytest pytest-cov
      
      - name: Run tests
        run: pytest tests/ --cov=src --cov-report=xml
      
      - name: Upload coverage
        uses: codecov/codecov-action@v3
        with:
          files: ./coverage.xml

Шаг 3: Проверка качества кода

name: Code Quality

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]

jobs:
  lint:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      
      - name: Install linters
        run: |
          pip install ruff black mypy
      
      - name: Run ruff
        run: ruff check .
      
      - name: Run black
        run: black --check .
      
      - name: Run mypy
        run: mypy src/

Шаг 4: Развёртывание на сервер

name: Deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/main'
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Deploy to production
        env:
          SSH_KEY: ${{ secrets.SSH_KEY }}
          SERVER_HOST: ${{ secrets.SERVER_HOST }}
          SERVER_USER: ${{ secrets.SERVER_USER }}
        run: |
          mkdir -p ~/.ssh
          echo "$SSH_KEY" > ~/.ssh/deploy_key
          chmod 600 ~/.ssh/deploy_key
          ssh-keyscan -H $SERVER_HOST >> ~/.ssh/known_hosts
          ssh -i ~/.ssh/deploy_key $SERVER_USER@$SERVER_HOST 'cd /app && git pull origin main && make deploy'

Практический пример: Django проект

name: Django Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    
    services:
      postgres:
        image: postgres:14
        env:
          POSTGRES_DB: test_db
          POSTGRES_PASSWORD: password
        options: >
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
        ports:
          - 5432:5432
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'
      
      - name: Install dependencies
        run: |
          pip install -r requirements.txt
          pip install pytest pytest-django pytest-cov
      
      - name: Run migrations
        env:
          DATABASE_URL: postgresql://postgres:password@localhost/test_db
        run: python manage.py migrate
      
      - name: Run tests
        env:
          DATABASE_URL: postgresql://postgres:password@localhost/test_db
        run: pytest --cov=src --cov-report=xml
      
      - name: Upload coverage
        uses: codecov/codecov-action@v3

Продвинутые техники

1. Параллельное выполнение тестов:

jobs:
  test:
    strategy:
      matrix:
        test-group: [unit, integration, e2e]
    steps:
      - name: Run ${{ matrix.test-group }} tests
        run: pytest tests/${{ matrix.test-group }}/

2. Кеширование зависимостей:

- name: Cache pip packages
  uses: actions/cache@v3
  with:
    path: ~/.cache/pip
    key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
    restore-keys: |
      ${{ runner.os }}-pip-

3. Уведомления при ошибке:

- name: Notify Slack on failure
  if: failure()
  uses: slackapi/slack-github-action@v1
  with:
    payload: |
      {
        "text": "CI/CD failed on ${{ github.repository }}",
        "blocks": [
          {
            "type": "section",
            "text": {
              "type": "mrkdwn",
              "text": "GitHub Action failed"
            }
          }
        ]
      }

Ключевые практики

• Тесты первыми: не позволяй коду в main без тестов
• Параллелизм: запускай разные проверки одновременно
• Кеширование: ускоряй сборки с помощью кеша зависимостей
• Семантическое версионирование: используй git tags для релизов
• Secrets: хранить чувствительные данные в secrets, не в коде
• Мониторинг: слушай Slack/email при ошибках
• Rollback: всегда имей план отката при падении в production

Частые ошибки

• Тесты, которые иногда падают (flaky tests) — это красный флаг
• Игнорирование coverage — помни про 90%+
• Медленные тесты — оптимизируй или запускай параллельно
• Отсутствие security checks — всегда проверяй зависимости и secrets
• Ручное развёртывание в production — полностью автоматизируй