Integracja CI/CD
Na tej stronie
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,frameworkiapi-keynie istnieją wopenai/codex-action@v1(zastąpione przezopenai-api-key,prompt/prompt-file,sandbox,output-fileitp.). Akcja nie publikuje komentarzy samodzielnie. Wyrażenie== failurebez cudzysłowu nie działało. Flaga--applyzostała zastąpiona przezcodex 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ściowe | Rola |
|---|---|
openai-api-key | Klucz przechowywany jako sekret GitHub (np. OPENAI_API_KEY) |
prompt lub prompt-file | Instrukcja wpisana bezpośrednio lub plik w repozytorium – jedno lub drugie, nie oba |
sandbox | read-only, workspace-write lub danger-full-access: wybierz najwęższy zakres, który wystarczy |
model, effort | Model i wysiłek rozumowania; jeśli puste, zastosowane zostaną wartości domyślne |
output-file | Zapisuje końcową wiadomość Codex dla kolejnych kroków |
codex-args | Dodatkowe opcje dla codex exec |
safety-strategy | Domyś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/CD | Zadanie Codex | Wyzwalacz |
|---|---|---|
| Otwarcie PR | Automatyczny przegląd | pull_request opened |
| Otwarcie PR | Generowanie testów | pull_request opened |
| Awaria CI | Analiza i naprawa | workflow_run failure |
| Wydanie (Release) | Automatyczny changelog | tag push |
| Aktualizacja zależności | Sprawdzenie kompatybilności | Dependabot 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