Przejdź do głównej treści
Polski— Wybierz język
Menu

Integracja CI/CD

Lekcja 14 z 20 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Codex w Twoim potoku dostawczym
  2. Oficjalna akcja GitHub
  3. Automatyzuj przegląd dla każdego PR
  4. Uzupełnij brakujące testy
  5. Reaguj na awarię CI
  6. Wywołuj Codex z własnych skryptów
  7. Zmapuj punkty integracji
  8. Zachowaj kontrolę nad automatyzacją
  9. Kluczowe wnioski

Zaktualizowano 3 listopada 2026 r. na podstawie stron dokumentacji Codex dotyczących Codex GitHub Action oraz Tryb nieinteraktywny: przestarzałe dane wejściowe task, criteria, scope, framework i api-key nie istnieją w openai/codex-action@v1 (zastąpione przez openai-api-key, prompt/prompt-file, sandbox, output-file itp.). Akcja nie publikuje komentarzy samodzielnie. Wyrażenie == failure bez cudzysłowu nie działało. Flaga --apply została zastąpiona przez codex exec --sandbox workspace-write. Źródła: Codex GitHub Action · Tryb nieinteraktywny.

Codex w Twoim potoku dostawczym

Codex nie ogranicza się do zadań uruchamianych ręcznie przez programistę. Integruje się z Twoimi potokami CI/CD, aby automatyzować zadania deweloperskie na każdym etapie cyklu dostawczego. Ta zmiana wykracza poza oszczędność czasu: przegląd kodu, generowanie testów i naprawianie błędów przestają zależeć od indywidualnej dyscypliny, a stają się krokami potoku wyzwalanymi przez zdarzenia, a nie dobrą wolą w piątkowe popołudnie.

Oficjalna akcja GitHub

OpenAI publikuje akcję openai/codex-action@v1, która instaluje CLI, uruchamia serwer proxy Responses API po podaniu klucza i wykonuje codex exec z ustawionymi przez Ciebie uprawnieniami. Jej główne dane wejściowe:

Dane wejścioweRola
openai-api-keyKlucz przechowywany jako sekret GitHub (np. OPENAI_API_KEY)
prompt lub prompt-fileInstrukcja wpisana bezpośrednio lub plik w repozytorium – jedno lub drugie, nie oba
sandboxread-only, workspace-write lub danger-full-access: wybierz najwęższy zakres, który wystarczy
model, effortModel i wysiłek rozumowania; jeśli puste, zastosowane zostaną wartości domyślne
output-fileZapisuje końcową wiadomość Codex dla kolejnych kroków
codex-argsDodatkowe opcje dla codex exec
safety-strategyDomyślnie drop-sudo, co usuwa sudo przed wykonaniem i chroni sekrety w pamięci

Akcja działa na runnerach Linux lub macOS (w systemie Windows potrzebujesz safety-strategy: unsafe) po wykonaniu actions/checkout kodu. Nie publikuje niczego samodzielnie: udostępnia ostatnią wiadomość Codex w danych wyjściowych final-message, które kolejny krok może opublikować.

Automatyzuj przegląd dla każdego PR

Poniższy przepływ pracy follows strukturę oficjalnego przykładu: pierwsze zadanie uruchamia Codex w trybie tylko do odczytu, a drugie, posiadające uprawnienia do zapisu dla PR, publikuje wynik jako komentarz. Twoje kryteria trafiają 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 zasługuje na większą uwagę niż reszta pliku: przekształca on ogólny przegląd w taki, który odpowiada Twoim priorytetom. Możesz przenieść go z YAML do wersjonowanego pliku, np. .github/codex/prompts/review.md, i odwołać się do niego za pomocą prompt-file. W przypadku prostego przeglądu PR, automatyczny przegląd wbudowany w GitHub (Lekcja 11) pozwala całkowicie uniknąć pisania przepływu pracy.

Uzupełnij brakujące testy

Drugi przepływ pracy zajmuje się kodem dostarczonym bez testów. Codex musi tutaj zapisywać do obszaru roboczego (sandbox: workspace-write), ale wynik pozostaje propozycją: przepływ pracy zamienia go w plik patch do pobrania, który programista przegląda i stosuje samodzielnie.

# .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

Programista zachowuje pełną kontrolę: pobiera patch, dostosowuje go lub odrzuca. Dokumentacja akcji zaleca uruchamianie Codex jako ostatniego kroku w zadaniu, aby kolejne kroki nie dziedziczyły nieoczekiwanych zmian – tutaj jedynym następnym krokiem jest jedynie odczyt różnicy (diff).

Reaguj na awarię CI

Trzeci przepływ pracy podłącza się do wyniku innego przepływu. Gdy CI zawiedzie, Codex ponownie uruchamia testy na odpowiednim commicie, namierza przyczynę i generuje diagnozę bez wypychania czegokolwiek:

# .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

Ten przypadek wymaga największej ostrożności. Nieudany test czasami sygnalizuje wadę projektową, a prawdopodobna automatyczna naprawa może sprawić, że zniknie ona z ekranu, nie rozwiązując problemu: CI znów świeci się na zielono, ale problem pozostaje. Stąd wybór diagnozy do przeglądu, a nie automatycznie wypchanego commita.

Wywołuj Codex z własnych skryptów

Poza GitHub Actions, codex exec pasuje do dowolnego skryptu. Domyślnie działa w piaskownicy tylko do odczytu; nadaj mu uprawnienia do zapisu za pomocą --sandbox workspace-write, gdy zadanie tego wymaga. Poniższy hook pre-commit wykrywa pliki TypeScript bez testów i generuje jeden w locie:

#!/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

W środowisku CI, codex exec domyślnie korzysta z zapisanej autentyfikacji; zamiast tego podaj poświadczenia jawnie, używając dedykowanego klucza API.

Zmapuj punkty integracji

Gdy te elementy konstrukcyjne są już na miejscu, myśl w kategoriach zdarzeń cyklu dostawczego, a nie plików YAML. Poniższych pięć scenariuszy obejmuje najczęstsze przypadki:

Etap CI/CDZadanie CodexWyzwalacz
Otwarcie PRAutomatyczny przeglądpull_request opened
Otwarcie PRGenerowanie testówpull_request opened
Awaria CIAnaliza i naprawaworkflow_run failure
Wydanie (Release)Automatyczny changelogtag push
Aktualizacja zależnościSprawdzenie kompatybilnościDependabot PR

Zachowaj kontrolę nad automatyzacją

Integracja CI/CD działa bez nadzoru, co wymaga zachowania podstawowych środków ostrożności. Ogranicz liczbę osób mogących uruchamiać przepływy pracy – domyślnie mogą to robić tylko użytkownicy z uprawnieniami do zapisu (użyj allow-users, allow-bots, aby to wyraźnie rozszerzyć). Oczyść dane wejściowe z PR, wiadomości commit lub zgłoszeń przed przekazaniem ich do Codex: ukryty tekst może zawierać wstrzyknięcie promptu (prompt injection). Użyj klucza API dedykowanego do minimalnych uprawnień, a nie osobistego klucza programisty, który zabierze ze sobą, odchodząc z firmy, łamiąc Twoje potoki. Nigdy nie scalaj automatycznie naprawy wygenerowanej przez Codex: przegląd przez człowieka pozostaje bramą do głównej gałęzi. Ustaw wyraźne limity liczby zadań dziennie i maksymalnego kosztu, aby źle skonfigurowana pętla naprawcza nie spaliła miesięcznego budżetu w ciągu jednej nocy. Na koniec prowadź historię zadań Codex wykonanych w CI: dnia, gdy w produkcji pojawi się nieoczekiwane zachowanie, te logi będą Twoim jedynym solidnym tropem.

Kluczowe wnioski

  • Codex integruje się z GitHub Actions i innymi systemami CI/CD
  • Automatyczny przegląd w PR to najczęstszy przypadek użycia
  • Codex może automatycznie naprawiać awarie CI
  • CLI umożliwia integrację z własnymi skryptami
  • Zawsze保持uj człowieka w pętli, aby zatwierdzać naprawy