Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Integrácia CI/CD

Lekcia 14 z 20 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Codex vo vašom doručovacom pipeline
  2. Oficiálna akcia pre GitHub
  3. Automatizácia kontroly pre každý PR
  4. Doplnenie chýbajúcich testov
  5. Reakcia na zlyhanie CI
  6. Volanie Codexu z vlastných skriptov
  7. Mapovanie integračných bodov
  8. Zachovanie kontroly nad automatizáciou
  9. Kľúčové poznatky

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, framework a api-key v openai/codex-action@v1 neexistujú (nahradené vstupmi openai-api-key, prompt/prompt-file, sandbox, output-file atď.). Akcia sama o sebe nepridáva komentáre. Výraz == failure bez úvodzoviek nefungoval. Príznak --apply bol nahradený príkazom codex 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-keyKľúč uložený ako tajomstvo GitHubu (napríklad OPENAI_API_KEY)
prompt alebo prompt-fileInštrukcia priamo v kóde alebo súbor v repozitári – jedno alebo druhé, nie obe
sandboxread-only, workspace-write alebo danger-full-access: vyberte najužší možný rozsah, ktorý stačí
model, effortModel a úsilie pri logickom uvažovaní; ak sú prázdne, použijú sa predvolené hodnoty
output-fileUloží záverečnú správu Codexu pre nasledujúce kroky
codex-argsĎalšie možnosti pre codex exec
safety-strategyPredvolená 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 CodexuSpúšťač
Otvorenie PRAutomatická kontrolapull_request opened
Otvorenie PRGenerovanie testovpull_request opened
Zlyhanie CIAnalýza a opravaworkflow_run failure
ReleaseAutomatický changelogtag push
Aktualizácia závislostíKontrola kompatibilityDependabot 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