Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Integrace CI/CD

Lekce 14 z 20 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Codex ve tvém dodávacím potrubí
  2. Oficiální GitHub Action
  3. Automatizuj kontrolu pro každý PR
  4. Doplň chybějící testy
  5. Reaguj na selhání CI
  6. Volání Codexu z vlastních skriptů
  7. Mapuj integrační body
  8. Udržuj kontrolu nad automatizací
  9. Klíčové poznatky

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, framework a api-key v openai/codex-action@v1 neexistují (nahrazeny vstupy openai-api-key, prompt/prompt-file, sandbox, output-file atd.). Akce sama o sobě nepřidává komentáře. Výraz == failure bez uvozovek nefungoval. Příznak --apply byl nahrazen příkazem codex 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:

VstupRole
openai-api-keyKlíč uložený jako GitHub secret (například OPENAI_API_KEY)
prompt nebo prompt-filePokyn přímo v kódu nebo soubor v repozitáři – jedno nebo druhé, ne obojí
sandboxread-only, workspace-write nebo danger-full-access: zvol nejužší rozsah, který stačí
model, effortModel a úsilí při odvozování; pokud jsou prázdné, použijí se výchozí hodnoty
output-fileUloží závěrečnou zprávu Codexu pro následné kroky
codex-argsDalší možnosti pro codex exec
safety-strategyVý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 CodexuSpouštěč
Otevření PRAutomatická kontrolapull_request opened
Otevření PRGenerování testůpull_request opened
Selhání CIAnalýza a opravaworkflow_run failure
Vydání verzeAutomatický changelogtag push
Aktualizace závislostíKontrola kompatibilityDependabot 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