Премини към основното съдържание
Български— Изберете език
Меню

Интеграция на CI/CD

Урок 14 от 20 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Codex във Вашия доставочен конвейер
  2. Официалното действие за GitHub
  3. Автоматизиране на прегледа за всяка PR
  4. Попълване на липсващи тестове
  5. Реагиране на неуспех в CI
  6. Извикване на Codex от Вашите собствени скриптове
  7. Картографиране на точките на интеграция
  8. Запазете контрол над автоматизацията
  9. Ключови изводи

Обновено на 3 ноември 2026 г. въз основа на страниците Codex GitHub Action и Non-interactive mode от документацията на Codex: наследените входни параметри task, criteria, scope, framework и api-key не съществуват в openai/codex-action@v1 (заменени са от openai-api-key, prompt/prompt-file, sandbox, output-file и др.). Действието не публикува коментари самостоятелно. Изразът == failure без кавички не работеше. Флагът --apply е заменен от codex exec --sandbox workspace-write. Източници: Codex GitHub Action · Non-interactive mode.

Codex във Вашия доставочен конвейер

Codex не се ограничава до задачи, стартирани ръчно от разработчик. Той се интегрира във Вашите CI/CD конвейери, за да автоматизира задачите по разработване на всеки етап от цикъла на доставка. Тази промяна надхвърля спестяването на време: прегледът на кода, генерирането на тестове и поправките на грешки престават да зависят от индивидуалната дисциплина и се превръщат в стъпки от конвейера, задействани от събития, а не от добрата воля в петък следобед.

Официалното действие за GitHub

OpenAI публикува действие, openai/codex-action@v1, което инсталира CLI, стартира прокси сървъра на Responses API, когато предоставите ключ, и изпълнява codex exec с разрешенията, които зададете. Неговите основни входни параметри:

ВходРоля
openai-api-keyКлючът, съхранен като GitHub секрет (например OPENAI_API_KEY)
prompt или prompt-fileИнструкцията в линията или файл в хранилището – едното или другото, но не и двете
sandboxread-only, workspace-write или danger-full-access: изберете най-тесния обхват, който е достатъчен
model, effortМоделът и усилието за разсъждение; ако са празни, се прилагат стойностите по подразбиране
output-fileЗапазва крайното съобщение на Codex за следващите стъпки
codex-argsДопълнителни опции за codex exec
safety-strategyПо подразбиране е drop-sudo, което премахва sudo преди изпълнение и защитава секретите в паметта

Действието се изпълнява на Linux или macOS runners (на Windows се нуждаете от safety-strategy: unsafe) след actions/checkout на кода. То не публикува нищо самостоятелно: излага последното съобщение на Codex в изхода final-message, което последваща стъпка може да публикува.

Автоматизиране на прегледа за всяка PR

Работният поток по-долу следва структурата на официалния пример: първата задача стартира Codex в режим само за четене, а втората, получила права за запис върху PR, публикува резултата като коментар. Вашите критерии отиват в подкана (prompt).

# .github/workflows/codex-review.yml
name: Codex Review
on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  codex:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    outputs:
      final_message: ${{ steps.run_codex.outputs.final-message }}
    steps:
      - uses: actions/checkout@v5
        with:
          ref: refs/pull/${{ github.event.pull_request.number }}/merge
          fetch-depth: 0
          persist-credentials: false
      - name: Run Codex
        id: run_codex
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          sandbox: read-only
          prompt: |
            Review the changes in this pull request against the base branch.
            Priorities: security (injections, missing authentication), performance
            (N+1 queries), types (no any), tests (coverage of changes).
            Cite the files and lines involved.

  post_feedback:
    runs-on: ubuntu-latest
    needs: codex
    if: needs.codex.outputs.final_message != ''
    permissions:
      issues: write
      pull-requests: write
    steps:
      - uses: actions/github-script@v7
        with:
          github-token: ${{ github.token }}
          script: |
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.payload.pull_request.number,
              body: process.env.CODEX_FINAL_MESSAGE,
            });
        env:
          CODEX_FINAL_MESSAGE: ${{ needs.codex.outputs.final_message }}

Подканата заслужава повече внимание от останалата част на файла: тя превръща общия преглед в такъв, който отговаря на Вашите приоритети. Можете да я изнесете от YAML във версиониран файл, например .github/codex/prompts/review.md, към който се прави препратка чрез prompt-file. За прост преглед на PR, автоматичният преглед, вграден в GitHub (Урок 11), избягва писането на работен поток изцяло.

Попълване на липсващи тестове

Втори работен поток се занимава с код, доставен без тестове. Тук Codex трябва да пише в работното пространство (sandbox: workspace-write), но резултатът остава предложение: работният поток го превръща в изтегляем кръпка (patch), която разработчикът преглежда и прилага сам.

# .github/workflows/codex-tests.yml
name: Codex Generate Tests
on:
  pull_request:
    types: [opened]

jobs:
  generate-tests:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v5
        with:
          fetch-depth: 0
          persist-credentials: false
      - name: Generate missing tests
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          sandbox: workspace-write
          prompt: |
            For every file modified in this pull request that lacks a test,
            write the missing tests using Vitest, then run them.
      - name: Save the proposed tests as a patch
        run: git diff > codex-tests.patch
      - uses: actions/upload-artifact@v4
        with:
          name: codex-tests
          path: codex-tests.patch

Разработчикът запазва контрол от началото до края: той изтегля кръпката, я адаптира или я отхвърля. Документацията на действието препоръчва стартирането на Codex като последно в задачата, така че следващите стъпки да не наследят неочаквани промени – тук единствената следваща стъпка просто чете разликата (diff).

Реагиране на неуспех в CI

Третият работен поток се свързва с резултата от друг работен поток. Когато CI се провали, Codex възпроизвежда тестовете върху съответния комит, открива причината и предоставя диагноза, без да-push-ва нищо:

# .github/workflows/codex-diagnose.yml
name: Codex Diagnose CI
on:
  workflow_run:
    workflows: ["CI"]
    types: [completed]

jobs:
  diagnose:
    if: ${{ github.event.workflow_run.conclusion == 'failure' }}
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v5
        with:
          ref: ${{ github.event.workflow_run.head_sha }}
          persist-credentials: false
      - name: Analyze the CI failure
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          sandbox: workspace-write
          output-file: codex-diagnostic.md
          prompt: |
            CI failed on this commit. Run the tests, identify the cause of the failure,
            and propose a fix without modifying the test logic.
      - uses: actions/upload-artifact@v4
        with:
          name: codex-diagnostic
          path: codex-diagnostic.md

Този случай изисква най-голямо внимание. Провалил се тест понякога сигнализира за дефект в дизайна и правдоподобна автоматична поправка може да го накара да изчезне от екрана, без да го реши: CI отново става зелено, но проблемът остава. Оттук и изборът на диагноза за преглед, вместо автоматично push-нат комит.

Извикване на Codex от Вашите собствени скриптове

Извън GitHub Actions, codex exec се вписва във всеки скрипт. По подразбиране той работи в sandbox само за четене; дайте му разрешение за запис с --sandbox workspace-write, когато задачата го изисква. Хукът преди комит (pre-commit hook) по-долу открива TypeScript файлове без тестове и генерира такъв на момента:

#!/bin/bash
# Pre-commit hook script

# Check that modified files have tests
CHANGED=$(git diff --cached --name-only --diff-filter=ACM | grep '\.ts$' | grep -v '\.test\.ts$')
for file in $CHANGED; do
  test_file="${file%.ts}.test.ts"
  if [ ! -f "$test_file" ]; then
    echo "⚠️ File without test: $file"
    codex exec --sandbox workspace-write "Write tests for $file in $test_file"
    git add "$test_file"
  fi
done

В CI, codex exec използва запазената автентикация по подразбиране; вместо това, предоставете удостоверителни данни изрично, използвайки специализиран API ключ.

Картографиране на точките на интеграция

След като тези градивни елементи са на място, мислете в термините на събития от цикъла на доставка, а не на YAML файлове. Петте сценария по-долу покриват най-честите случаи:

Етап на CI/CDЗадача на CodexТригер
Отворена PRАвтоматичен прегледpull_request opened
Отворена PRГенериране на тестовеpull_request opened
Неуспех на CIАнализ и поправкаworkflow_run failure
РелийзАвтоматичен дневник на променитеtag push
Обновяване на зависимостиПроверка за съвместимостDependabot PR

Запазете контрол над автоматизацията

Интеграцията с CI/CD работи без надзор, което изисква някои основни предпазни мерки. Ограничете кой може да задейства работни потоци – по подразбиране само потребители с права за запис могат да стартират действието (използвайте allow-users, allow-bots, за да разширите това изрично). Почиствайте входа от PR, съобщения за комитове или_issues_, преди да го предадете на Codex: скритият текст може да съдържа инжекция на подкана. Използвайте API ключ, предназначен за минимални разрешения, вместо личния ключ на разработчик, който той ще вземе със себе си, когато напусне компанията, прекъсвайки Вашите конвейери. Никога не сливайте автоматично поправка, произведена от Codex: човешкият преглед остава портата към основния клон. Задайте изрични лимити за броя задачи на ден и максимална цена, така че грешно конфигуриран цикъл на корекция да не изгори месечния Ви бюджет за една нощ. Накрая, пазете история на задачите на Codex, изпълнени в CI: в деня, в който се появи неочаквано поведение в продукцията, тези логове ще бъдат единствената Ви солидна следа.

Ключови изводи

  • Codex се интегрира в GitHub Actions и други CI/CD системи
  • Автоматичният преглед на PR е най-честият случай на употреба
  • Codex може автоматично да поправя неуспехи в CI
  • CLI позволява интеграция в персонализирани скриптове
  • Винаги запазвайте човек в цикъла, за да валидира поправките