Integrácia CI/CD
Na tejto strane
Aktualizované 3. novembra 2026 na základe stránok Codex GitHub Action a Non-interactive mode v dokumentácii Codexu: staršie vstupy
task,criteria,scope,frameworkaapi-keyvopenai/codex-action@v1neexistujú (nahradené vstupmiopenai-api-key,prompt/prompt-file,sandbox,output-fileatď.). Akcia sama o sebe nepridáva komentáre. Výraz== failurebez úvodzoviek nefungoval. Príznak--applybol nahradený príkazomcodex exec --sandbox workspace-write. Zdroje: Codex GitHub Action · Non-interactive mode.
Codex vo vašom doručovacom pipeline
Codex nie je obmedzený len na úlohy, ktoré spúšťa vývojár manuálne. Integruje sa do vašich CI/CD pipelineov, aby automatizoval vývojové úlohy v každej fáze doručovacieho cyklu. Tento posun znamená viac než len úsporu času: kontrola kódu, generovanie testov a opravy chýb prestanú závisieť od individuálnej disciplíny a stanú sa krokmi pipeline spúšťanými udalosťami, nie dobrou vôľou v piatok popoludní.
Oficiálna akcia pre GitHub
OpenAI publikuje akciu openai/codex-action@v1, ktorá nainštaluje CLI, spustí proxy server Responses API, keď poskytnete kľúč, a vykoná codex exec s vami nastavenými oprávneniami. Jej hlavné vstupy:
| Vstup | Úloha |
|---|---|
openai-api-key | Kľúč uložený ako tajomstvo GitHubu (napríklad OPENAI_API_KEY) |
prompt alebo prompt-file | Inštrukcia priamo v kóde alebo súbor v repozitári – jedno alebo druhé, nie obe |
sandbox | read-only, workspace-write alebo danger-full-access: vyberte najužší možný rozsah, ktorý stačí |
model, effort | Model a úsilie pri logickom uvažovaní; ak sú prázdne, použijú sa predvolené hodnoty |
output-file | Uloží záverečnú správu Codexu pre nasledujúce kroky |
codex-args | Ďalšie možnosti pre codex exec |
safety-strategy | Predvolená hodnota drop-sudo, ktorá pred vykonaním odstráni sudo a chráni tajomstvá v pamäti |
Akcia beží na runneroch Linux alebo macOS (na Windows potrebujete safety-strategy: unsafe) po vykonaní actions/checkout kódu. Sama nič nepridáva: vystavuje poslednú správu Codexu vo výstupe final-message, ktorú môže zverejniť následný krok.
Automatizácia kontroly pre každý PR
Nasledujúci workflow nasleduje štruktúru oficiálneho príkladu: prvá úloha spustí Codex v režime len na čítanie a druhá, ktorá má udelené práva na zápis do PR, zverejní výsledok ako komentár. Vaše kritériá zadáte 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 zaslúži väčšiu pozornosť než zvyšok súboru: transformuje všeobecnú kontrolu na takú, ktorá zodpovedá vašim prioritám. Môžete ho presunúť z YAML do verziovateľného súboru, napríklad .github/codex/prompts/review.md, na ktorý sa odvoláte pomocou prompt-file. Pre jednoduchú kontrolu PR sa vyhnete písaniu workflow úplne využitím automatickej kontroly zabudovanej priamo v GitHub-e (Lekcia 11).
Doplnenie chýbajúcich testov
Druhý workflow rieši kód doručený bez testov. Codex tu potrebuje zapisovať do pracovného priestoru (sandbox: workspace-write), ale výsledok zostáva len návrhom: workflow ho prevedie na stiahnuteľnú záplatu (patch), ktorú vývojár skontroluje a aplikuje sám.
# .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ár si zachováva kontrolu od začiatku do konca: stiahne si záplatu, upraví ju alebo odmietne. Dokumentácia akcie odporúča spustiť Codex ako posledný krok v úlohe, aby nasledujúce kroky nezdedili neočakávané zmeny – tu ďalší krok len číta diff.
Reakcia na zlyhanie CI
Tretí workflow sa napája na výsledok iného workflow. Keď CI zlyhá, Codex znovu spustí testy na príslušnom commite, vypátra príčinu a vytvorí diagnózu bez toho, aby niečo pushol:
# .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 prípad si vyžaduje najväčšiu opatrnosť. Zlyhaný test niekedy signalizuje chybu v návrhu a vierohodná automatická oprava ho môže odstrániť z obrazovky bez toho, aby ho vyriešila: CI sa opäť sfarbí na zeleno, ale problém pretrváva. Preto sme sa rozhodli pre diagnózu na kontrolu namiesto automaticky pushnutého commitu.
Volanie Codexu z vlastných skriptov
Mimo GitHub Actions zapadá codex exec do ľubovoľného skriptu. Predvolene beží v sandboxe len na čítanie; právo na zápis mu udelíte pomocou --sandbox workspace-write, keď to úloha vyžaduje. Nasledujúci hák pre-commit označí súbory TypeScriptu bez testov a jeden vygeneruje za behu:
#!/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 codex exec predvolene znovu používa uložené overenie; namiesto toho explicitne poskytnite poverenia pomocou vyhradeného API kľúča.
Mapovanie integračných bodov
Keď máte tieto stavebné kamene hotové, myslite skôr na udalosti v doručovacom cykle než na súbory YAML. Päť nižšie uvedených scenárov pokrýva najbežnejšie prípady:
| Fáza CI/CD | Úloha Codexu | Spúšťač |
|---|---|---|
| Otvorenie PR | Automatická kontrola | pull_request opened |
| Otvorenie PR | Generovanie testov | pull_request opened |
| Zlyhanie CI | Analýza a oprava | workflow_run failure |
| Release | Automatický changelog | tag push |
| Aktualizácia závislostí | Kontrola kompatibility | Dependabot PR |
Zachovanie kontroly nad automatizáciou
Integrácia CI/CD beží bez obsluhy, čo si vyžaduje základné bezpečnostné opatrenia. Obmedzte, kto môže spúšťať workfow – predvolene môžu akciu spustiť len používatelia s právami na zápis (na explicitné rozšírenie použite allow-users, allow-bots). Pred odovzdaním vstupov Codexu očistite dáta z PR, správ o commitech alebo issue: skrytý text môže obsahovať vstrekovanie promptu (prompt injection). Použite API kľúč vyhradený s minimálnymi oprávneniami namiesto osobného kľúča vývojára, ktorý si ho vezme so sebou, keď firmu opustí, a tým rozbije vaše pipeline. Nikdy automaticky nezlučujte (merge) opravu vytvorenú Codexom: ľudská kontrola zostáva bránou do hlavnej vetvy. Nastavte explicitné limity na počet úloh za deň a maximálne náklady, aby chybná korekčná slučka nespálila váš mesačný rozpočet cez noc. Nakoniec si uchovávajte históriu úloh Codexu vykonaných v CI: v deň, keď sa vo produkcii objaví neočakávané správanie, budú tieto logy vašou jedinou pevnou stopou.
Kľúčové poznatky
- Codex sa integruje do GitHub Actions a ďalších systémov CI/CD
- Automatická kontrola pri PR je najbežnejším prípadom použitia
- Codex dokáže automaticky opraviť zlyhania CI
- CLI umožňuje integráciu do vlastných skriptov
- Vždy udržávajte človeka v slučke, aby validoval opravy