Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

CI/CD integráció

14. lecke 20 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Codex a kézbesítési folyamatodban
  2. A hivatalos GitHub Action
  3. Automatikus review minden PR-hez
  4. Hiányzó tesztek pótlása
  5. Reakció CI-hibára
  6. Codex hívása saját scriptekből
  7. Integrációs pontok feltérképezése
  8. Tartsd kézben az automatizálást
  9. Főbb megállapítások

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@v1 akcióban a régi task, criteria, scope, framework és api-key bemenetek már nem léteznek (helyettük: openai-api-key, prompt/prompt-file, sandbox, output-file stb.). Az akció önmagában nem tesz közzé megjegyzéseket. Az idézőjelek nélküli == failure kifejezés nem működött. A --apply kapcsolót a codex exec --sandbox workspace-write parancs 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:

BemenetSzerep
openai-api-keyA kulcs, GitHub titokként tárolva (például OPENAI_API_KEY)
prompt vagy prompt-fileA utasítás beágyazva, vagy egy fájl a tárolóban – csak az egyik, nem mindkettő
sandboxread-only, workspace-write vagy danger-full-access: válaszd a legszűkebb hatókört, ami elegendő
model, effortA modell és a következtetési erőfeszítés; ha üres, az alapértelmezett értékek érvényesülnek
output-fileElmenti a Codex végső üzenetét a következő lépések számára
codex-argsTovábbi opciók a codex exec parancshoz
safety-strategyAlapé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 szakaszCodex feladatTrigger
PR megnyitvaAutomatikus reviewpull_request opened
PR megnyitvaTesztgeneráláspull_request opened
CI hibaElemzés és javításworkflow_run failure
ReleaseAutomatikus changelogtag push
FüggőségfrissítésKompatibilitás ellenőrzéseDependabot 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