Integracija CI/CD
Na ovoj stranici
Ažurirano 3. studenoga 2026. na temelju stranica Codex GitHub Action i Non-interactive mode u Codex dokumentaciji: naslijeđeni ulazni parametri
task,criteria,scope,frameworkiapi-keyne postoje uopenai/codex-action@v1(zamijenjeni su sopenai-api-key,prompt/prompt-file,sandbox,output-fileitd.). Akcija sama po sebi ne objavljuje komentare. Izraz== failurebez navodnika nije funkcionirao. Zastavica--applyzamijenjena je scodex exec --sandbox workspace-write. Izvori: Codex GitHub Action · Non-interactive mode.
Codex u tvom isporučnom kanalu
Codex nije ograničen na zadatke koje programer pokreće ručno. Integrira se u tvoje CI/CD kanale kako bi automatizirao razvojne zadatke u svakoj fazi ciklusa isporuke. Ovaj pomak nadilazi uštedu vremena: pregled koda, generiranje testova i ispravljanje grešaka više ne ovise o individualnoj disciplini, već postaju koraci u kanalu koje pokreću događaji, a ne dobra volja petkom poslijepodne.
Službena GitHub akcija
OpenAI objavljuje akciju openai/codex-action@v1 koja instalira CLI, pokreće proxy za Responses API kada dostaviš ključ i izvršava codex exec s dopuštenjima koja postaviš. Njezini glavni ulazni parametri:
| Ulazni parametar | Uloga |
|---|---|
openai-api-key | Ključ pohranjen kao GitHub tajna (npr. OPENAI_API_KEY) |
prompt ili prompt-file | Uputa u liniji ili datoteka u repozitoriju – jedno ili drugo, nikako oboje |
sandbox | read-only, workspace-write ili danger-full-access: odaberi najuži mogući opseg koji je dovoljan |
model, effort | Model i napor rezoniranja; ako su prazni, primjenjuju se zadane vrijednosti |
output-file | Sprema konačnu poruku Codexa za naredne korake |
codex-args | Dodatne opcije za codex exec |
safety-strategy | Zadana vrijednost je drop-sudo, koja uklanja sudo prije izvršavanja i štiti tajne u memoriji |
Akcija se izvršava na Linux ili macOS runnerima (na Windowsima ti treba safety-strategy: unsafe) nakon actions/checkout koda. Sama ništa ne objavljuje: izlaže posljednju poruku Codexa u izlazu final-message, koju naknadni korak može objaviti.
Automatiziraj pregled za svaki PR
Tijek rada u nastavku slijedi strukturu službenog primjera: prvi posao pokreće Codex u načinu samo za čitanje, a drugi, s dodijeljenim dopuštenjima za pisanje na PR-ovima, objavljuje rezultat kao komentar. Tvoji kriteriji idu u upitu (prompt).
# .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 }}
Upit zaslužuje više pažnje od ostatka datoteke: on pretvara generički pregled u onaj koji odgovara tvojim prioritetima. Možeš ga izmjestiti iz YAML-a u verzioniranu datoteku, primjerice .github/codex/prompts/review.md, na koju se referenciraš putem prompt-file. Za jednostavan pregled PR-a, automatski pregled ugrađen u GitHub (Lekcija 11) izbjegava potrebu za pisanjem tijeka rada.
Popuni nedostajuće testove
Drugi tijek rada bavi se kodom isporučenim bez testova. Ovdje Codex mora pisati u radni prostor (sandbox: workspace-write), ali rezultat ostaje prijedlog: tijek rada ga pretvara u preuzimljiv patch koji programer sam pregledava i primjenjuje.
# .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
Programer zadržava kontrolu od početka do kraja: preuzima patch, prilagođava ga ili odbija. Dokumentacija akcije preporučuje pokretanje Codexa kao posljednjeg koraka u poslu kako naredni koraci ne bi naslijedili neočekivane promjene – ovdje jedini sljedeći korak samo čita razliku (diff).
Reagiraj na neuspjeh CI-ja
Treći tijek rada povezuje se s rezultatom drugog tijeka rada. Kada CI ne uspije, Codex ponovno pokreće testove na relevantnom commitu, otkriva uzrok i generira dijagnozu bez guranja bilo čega:
# .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
Ovaj zahtijeva najveći oprez. Neuspjeli test ponekad signalizira dizajnersku manu, a uvjerljivo automatsko ispravljanje može ga ukloniti s ekrana bez da ga zapravo riješi: CI ponovno postaje zelen, ali problem ostaje. Stoga izbor dijagnoze za pregled umjesto automatski gurnutog commita.
Pozovi Codex iz vlastitih skripti
Izvan GitHub Actions, codex exec staje u bilo koju skriptu. Zadano se izvršava u sandboxu samo za čitanje; daj mu dopuštenje za pisanje s --sandbox workspace-write kada zadatak to zahtijeva. Donji pre-commit hook označava TypeScript datoteke bez testova i generira jednu u letu:
#!/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
U CI-u, codex exec zadano ponovno koristi spremljenu autentifikaciju; umjesto toga, eksplicitno dostavi vjerodajnice koristeći namjenski API ključ.
Mapiraj točke integracije
Kada su ti gradivni blokovi na mjestu, razmišljaj u smislu događaja ciklusa isporuke, a ne YAML datoteka. Pet scenarija u nastavku pokriva najčešće slučajeve:
| Faza CI/CD | Zadatak Codexa | Okidač |
|---|---|---|
| PR otvoren | Automatski pregled | pull_request opened |
| PR otvoren | Generiranje testova | pull_request opened |
| Neuspjeh CI-ja | Analiza i popravak | workflow_run failure |
| Izdanje (Release) | Automatski dnevnik promjena | tag push |
| Ažuriranje ovisnosti | Provjera kompatibilnosti | Dependabot PR |
Zadrži kontrolu nad automatizacijom
Integracija CI/CD radi nenadzirano, što zahtijeva neke osnovne mjere opreza. Ograniči tko može pokrenuti tijekove rada – zadano samo korisnici s dopuštenjima za pisanje mogu pokrenuti akciju (koristi allow-users, allow-bots za eksplicitno proširenje). Pročisti ulazne podatke iz PR-ova, poruka commita ili issuea prije nego ih predaš Codexu: skriveni tekst može sadržavati injekciju upita. Koristi API ključ namijenjen minimalnim dopuštenjima umjesto osobnog ključa programera, koji će ponijeti sa sobom kada napusti tvrtku i time slomiti tvoje kanale. Nikada automatski ne spajaj (merge) popravak koji je proizveo Codex: ljudski pregled ostaje kapija prema glavnoj grani. Postavi eksplicitna ograničenja na broj zadataka dnevno i maksimalni trošak kako konfiguracijska petlja greške ne bi potrošila tvoj mjesečni budžet preko noći. Naposljetku, vodi povijest Codex zadataka izvršenih u CI-u: dana kada se u produkciji pojavi neočekivano ponašanje, ti će zapisi biti tvoj jedini čvrst trag.
Ključne točke
- Codex se integrira u GitHub Actions i druge CI/CD sustave
- Automatski pregled na PR-ovima najčešći je slučaj upotrebe
- Codex može automatski popraviti neuspjehe CI-ja
- CLI omogućuje integraciju u prilagođene skripte
- Uvijek zadrži čovjeka u petlji za validaciju popravaka