Интеграция на CI/CD
На тази страница
Обновено на 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 | Инструкцията в линията или файл в хранилището – едното или другото, но не и двете |
sandbox | read-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 позволява интеграция в персонализирани скриптове
- Винаги запазвайте човек в цикъла, за да валидира поправките