Integrace CI/CD
Na této stránce
Aktualizováno 3. listopadu 2026 na základě stránek Codex GitHub Action a Non-interactive mode v dokumentaci Codexu: staré vstupy
task,criteria,scope,frameworkaapi-keyvopenai/codex-action@v1neexistují (nahrazeny vstupyopenai-api-key,prompt/prompt-file,sandbox,output-fileatd.). Akce sama o sobě nepřidává komentáře. Výraz== failurebez uvozovek nefungoval. Příznak--applybyl nahrazen příkazemcodex exec --sandbox workspace-write. Zdroje: Codex GitHub Action · Non-interactive mode.
Codex ve tvém dodávacím potrubí
Codex se neomezuje jen na úkoly, které vývojář spouští ručně. Integruje se do tvých CI/CD pipeline, aby automatizoval vývojové úkoly v každé fázi dodávacího cyklu. Tento posun znamená víc než jen úsporu času: kontrola kódu, generování testů a opravy chyb přestávají záviset na individuální kázni a stávají se kroky pipeline spouštěnými událostmi, nikoliv dobrou vůlí v pátek odpoledne.
Oficiální GitHub Action
OpenAI publikuje akci openai/codex-action@v1, která nainstaluje CLI, spustí proxy server Responses API, když poskytneš klíč, a provede codex exec s oprávněními, která nastavíš. Její hlavní vstupy:
| Vstup | Role |
|---|---|
openai-api-key | Klíč uložený jako GitHub secret (například OPENAI_API_KEY) |
prompt nebo prompt-file | Pokyn přímo v kódu nebo soubor v repozitáři – jedno nebo druhé, ne obojí |
sandbox | read-only, workspace-write nebo danger-full-access: zvol nejužší rozsah, který stačí |
model, effort | Model a úsilí při odvozování; pokud jsou prázdné, použijí se výchozí hodnoty |
output-file | Uloží závěrečnou zprávu Codexu pro následné kroky |
codex-args | Další možnosti pro codex exec |
safety-strategy | Výchozí hodnota je drop-sudo, která před spuštěním odstraní sudo a chrání tajemství v paměti |
Akce běží na Linuxu nebo macOS runneru (na Windows potřebuješ safety-strategy: unsafe) po provedení actions/checkout kódu. Sama nic nepublikuje: vystavuje poslední zprávu Codexu ve výstupu final-message, kterou může zveřejnit následující krok.
Automatizuj kontrolu pro každý PR
Následující workflow vychází ze struktury oficiálního příkladu: první úloha spustí Codex v režimu pouze pro čtení a druhá, která má udělena práva zápisu pro PR, výsledek zveřejní jako komentář. Tvá kritéria patří do promptu.
# .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 }}
Prompt si zaslouží více pozornosti než zbytek souboru: promění obecnou kontrolu v takovou, která odpovídá tvým prioritám. Můžeš jej přesunout z YAML do verzované souboru, například .github/codex/prompts/review.md, na který se odkážeš pomocí prompt-file. Pro jednoduchou kontrolu PR se vyhneš psaní workflow úplně díky automatické kontrole vestavěné v GitHubu (Lekce 11).
Doplň chybějící testy
Druhé workflow řeší kód dodaný bez testů. Codex zde musí zapisovat do pracovního prostoru (sandbox: workspace-write), ale výsledek zůstává návrhem: workflow z něj vytvoří stahovatelnou záplatu (patch), kterou vývojář zkontroluje a sám aplikuje.
# .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
Vývojář si udržuje kontrolu od začátku do konce: stáhne si záplatu, upraví ji, nebo odmítne. Dokumentace akce doporučuje spouštět Codex jako poslední v úloze, aby následné kroky nedědily neočekávané změny – zde další krok pouze čte diff.
Reaguj na selhání CI
Třetí workflow se napojuje na výsledek jiného workflow. Když CI selže, Codex znovu přehraje testy na příslušném commitu, vypátrá příčinu a vytvoří diagnózu, aniž by cokoli odesílal:
# .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
Tento případ vyžaduje největší opatrnost. Selhávající test někdy signalizuje chybu v návrhu a věrohodná automatická oprava může problém odstranit z obrazovky, aniž by jej vyřešila: CI opět zezelená, ale problém přetrvává. Proto volba diagnózy ke kontrole místo automaticky odeslaného commitu.
Volání Codexu z vlastních skriptů
Mimo GitHub Actions zapadá codex exec do jakéhokoli skriptu. Ve výchozím nastavení běží v sandboxu pouze pro čtení; pokud úkol vyžaduje zápis, uděl mu oprávnění pomocí --sandbox workspace-write. Následující hook před commitem označí soubory TypeScriptu bez testů a jeden rovnou vygeneruje:
#!/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
V CI využívá codex exec ve výchozím nastavení uložené ověření; místo toho explicitně poskytni pověření pomocí vyhrazeného API klíče.
Mapuj integrační body
Jakmile máš tyto stavební kameny na místě, přemýšlej spíše v termínech událostí dodávacího cyklu než souborů YAML. Následujících pět scénářů pokrývá nejčastější případy:
| Fáze CI/CD | Úkol Codexu | Spouštěč |
|---|---|---|
| Otevření PR | Automatická kontrola | pull_request opened |
| Otevření PR | Generování testů | pull_request opened |
| Selhání CI | Analýza a oprava | workflow_run failure |
| Vydání verze | Automatický changelog | tag push |
| Aktualizace závislostí | Kontrola kompatibility | Dependabot PR |
Udržuj kontrolu nad automatizací
Integrace CI/CD běží bez obsluhy, což vyžaduje některá základní bezpečnostní opatření. Omez, kdo může spouštět workflow – ve výchozím nastavení mohou akci spustit pouze uživatelé s právy zápisu (použij allow-users, allow-bots pro explicitní rozšíření). Před předáním dat Codexu očisti vstupy z PR, zpráv commitů nebo issue: skrytý text může obsahovat injekci promptu. Použij API klíč věnovaný minimálním oprávněním místo osobního klíče vývojáře, který si ho odnese při odchodu z firmy a rozbije ti pipeline. Nikdy automaticky neslučuj opravu vytvořenou Codexem: lidská kontrola zůstává branou do hlavní větve. Nastav explicitní limity na počet úkolů za den a maximální náklady, aby špatně nakonfigurovaná opravná smyčka přes noc nespálila tvůj měsíční rozpočet. Nakonec si veď historii úkolů Codexu spuštěných v CI: v den, kdy se ve výrobě objeví neočekávané chování, budou tyto logy tvou jedinou solidní stopou.
Klíčové poznatky
- Codex se integruje do GitHub Actions a dalších systémů CI/CD
- Automatická kontrola u PR je nejčastějším případem použití
- Codex dokáže automaticky opravit selhání CI
- CLI umožňuje integraci do vlastních skriptů
- Vždy udržuj člověka ve smyčce, aby validoval opravy