CI/CD integráció
Ezen az oldalon
Frissítve: 2026. november 3. a Codex dokumentációjának Codex GitHub Action és Nem interaktív mód oldalai alapján: az
openai/codex-action@v1akcióban a régitask,criteria,scope,frameworkésapi-keybemenetek már nem léteznek (helyettük:openai-api-key,prompt/prompt-file,sandbox,output-filestb.). Az akció önmagában nem tesz közzé megjegyzéseket. Az idézőjelek nélküli== failurekifejezés nem működött. A--applykapcsolót acodex exec --sandbox workspace-writeparancs váltotta fel. Források: Codex GitHub Action · Nem interaktív mód.
Codex a kézbesítési folyamatodban
A Codex használata nem korlátozódik a fejlesztők által manuálisan indított feladatokra. Integrálható a CI/CD folyamataidba, hogy automatizálja a fejlesztési feladatokat a kézbesítési ciklus minden szakaszában. Ez a váltás túlmutat az időmegtakarításon: a kódreview, a tesztek generálása és a hibajavítások többé nem függnek az egyéni fegyelemtől; a folyamat lépéseivé válnak, amelyeket események indítanak el, nem pedig a péntek délutáni jóindulat.
A hivatalos GitHub Action
Az OpenAI közzétett egy openai/codex-action@v1 nevű akciót, amely telepíti a CLI-t, elindítja a Responses API proxyt, ha megadsz egy kulcsot, és a általad beállított jogosultságokkal futtatja a codex exec parancsot. Fő bemenetei:
| Bemenet | Szerep |
|---|---|
openai-api-key | A kulcs, GitHub titokként tárolva (például OPENAI_API_KEY) |
prompt vagy prompt-file | A utasítás beágyazva, vagy egy fájl a tárolóban – csak az egyik, nem mindkettő |
sandbox | read-only, workspace-write vagy danger-full-access: válaszd a legszűkebb hatókört, ami elegendő |
model, effort | A modell és a következtetési erőfeszítés; ha üres, az alapértelmezett értékek érvényesülnek |
output-file | Elmenti a Codex végső üzenetét a következő lépések számára |
codex-args | További opciók a codex exec parancshoz |
safety-strategy | Alapértelmezés szerint drop-sudo, amely eltávolítja a sudo hívásokat a végrehajtás előtt, és védi a titkos adatokat a memóriában |
Az akció Linux vagy macOS futtatókon működik (Windows esetén safety-strategy: unsafe szükséges), miután az actions/checkout lekérte a kódot. Önmagában semmit nem tesz közzé: a final-message kimenetben teszi elérhetővé a Codex utolsó üzenetét, amelyet egy későbbi lépés tehet közzé.
Automatikus review minden PR-hez
Az alábbi munkafolyamat követi a hivatalos példa szerkezetét: egy első feladat read-only módban futtatja a Codexet, egy második, a PR-ekre írási jogosultsággal rendelkező feladat pedig megjegyzésként teszi közzé az eredményt. A kritériumaidat a promptba írhatod.
# .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 }}
A prompt több figyelmet érdemel, mint a fájl többi része: ez alakítja az általános review-t olyanná, amely igazodik a te prioritásaidhoz. Kiemelheted a YAML-ból egy verziókezelt fájlba, például a .github/codex/prompts/review.md helyre, és a prompt-file segítségével hivatkozhatsz rá. Egy egyszerű PR review esetén a GitHubba épített automatikus review (11. lecke) teljesen kiválthatja a munkafolyamat megírását.
Hiányzó tesztek pótlása
Egy második munkafolyamat a tesztek nélkül szállított kód kezelésére szolgál. Itt a Codexnek írnia kell a munkaterületre (sandbox: workspace-write), de az eredmény továbbra is csak javaslat marad: a munkafolyamat letölthető patch-fájllá alakítja, amelyet a fejlesztő saját maga vizsgál át és alkalmaz.
# .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
A fejlesztő végig kézben tartja az irányítást: letölti a patchet, módosítja vagy elutasítja azt. Az akció dokumentációja azt javasolja, hogy a Codexet a feladat legvégén futtasd, hogy a következő lépések ne örököljenek váratlan változásokat – itt a következő lépés csupán olvassa a diffet.
Reakció CI-hibára
A harmadik munkafolyamat egy másik munkafolyamat eredményére reagál. Ha a CI sikertelen, a Codex újra lefuttatja a teszteket az érintett commiton, felkutatja a hiba okát, és diagnózist készít anélkül, hogy bármit pusholna:
# .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
Ez igényli a legnagyobb óvatosságot. Egy sikertelen teszt néha tervezési hibára utal, és egy hihető automatikus javítás eltüntetheti a képernyőről a problémát anélkül, hogy megoldaná azt: a CI újra zölddé válik, de a hiba megmarad. Ezért választottuk a diagnózis átnézését az automatikusan pusholt commit helyett.
Codex hívása saját scriptekből
A GitHub Actionsön kívül a codex exec bármilyen scriptbe illeszthető. Alapértelmezés szerint read-only sandboxban fut; ha a feladat megköveteli, a --sandbox workspace-write kapcsolóval adhatsz neki írási jogosultságot. Az alábbi pre-commit hook flageli a tesztek nélküli TypeScript fájlokat, és helyben generál egyet:
#!/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 környezetben a codex exec alapértelmezés szerint a mentett hitelesítést használja; ehelyett érdemes egy dedikált API-kulcs segítségével explicit módon megadni a hitelesítő adatokat.
Integrációs pontok feltérképezése
Ha ezek az építőkövek a helyükre kerültek, gondolkodj a kézbesítési ciklus eseményeiben, ne csak YAML-fájlokban. Az alábbi öt forgatókönyv lefedi a leggyakoribb eseteket:
| CI/CD szakasz | Codex feladat | Trigger |
|---|---|---|
| PR megnyitva | Automatikus review | pull_request opened |
| PR megnyitva | Tesztgenerálás | pull_request opened |
| CI hiba | Elemzés és javítás | workflow_run failure |
| Release | Automatikus changelog | tag push |
| Függőségfrissítés | Kompatibilitás ellenőrzése | Dependabot PR |
Tartsd kézben az automatizálást
A CI/CD integráció felügyelet nélkül fut, ami alapvető óvintézkedéseket tesz szükségessé. Korlátozd, ki indíthat munkafolyamatokat – alapértelmezés szerint csak írási jogosultsággal rendelkező felhasználók futtathatják az akciót (használd az allow-users, allow-bots beállításokat a kör explicit szélesítéséhez). Tisztítsd meg a PR-okból, commit üzenetekből vagy issue-kból származó bemenetet, mielőtt átadnád a Codexnek: a rejtett szöveg tartalmazhat prompt-injekciót. Használj minimális jogosultságokkal rendelkező, dedikált API-kulcsot a fejlesztők személyes kulcsai helyett, amelyeket magukkal visznek, amikor elhagyják a céget, ezzel tönkretéve a folyamataidat. Soha ne egyesíts automatikusan a Codex által készített javítást: az emberi review marad a fő ágba való belépés kapuja. Állíts be explicit korlátokat a napi feladatok számára és a maximális költségre, hogy egy rosszul konfigurált javítási ciklus ne égesse fel egy éjszaka alatt a havi költségkeretedet. Végül vezess naplót a CI-ban végrehajtott Codex feladatokról: ha váratlan viselkedés jelenik meg élesben, ezek a naplók lesznek az egyetlen megbízható nyomod.
Főbb megállapítások
- A Codex integrálható GitHub Actions és egyéb CI/CD rendszerekbe
- A PR-eken végzett automatikus review a leggyakoribb használati eset
- A Codex képes automatikusan javítani a CI-hibákat
- A CLI lehetővé teszi az integrációt egyedi scriptekbe
- Mindig tarts embert a folyamatban a javítások validálásához