Integracija CI/CD
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi strani Codex GitHub Action in Non-interactive mode v dokumentaciji Codex: podedovani vhodi
task,criteria,scope,frameworkinapi-keyne obstajajo vopenai/codex-action@v1(nadomeščeni zopenai-api-key,prompt/prompt-file,sandbox,output-fileitd.). Akcija sama po sebi ne objavlja komentarjev. Izraz== failurebrez narekovajev ni deloval. Zastavica--applyje nadomeščena zcodex exec --sandbox workspace-write. Viri: Codex GitHub Action · Non-interactive mode.
Codex v tvojem dobavnem toku
Codex ni omejen na opravila, ki jih razvijalec zažene ročno. Integrira se v tvoje CI/CD cevovode, da avtomatizira razvojna opravila na vsaki stopnji dobavnega cikla. Ta premik presega zgolj varčevanje s časom: pregled kode, generiranje testov in popravki napak prenehajo biti odvisni od posameznikove discipline in postanejo koraki v cevovodu, sproženi z dogodki, ne pa z dobro voljo petek popoldne.
Uradna GitHub akcija
OpenAI objavlja akcijo openai/codex-action@v1, ki namesti CLI, zažene proxy Responses API, ko priskrbiš ključ, in zažene codex exec z dovoljenji, ki jih nastaviš. Njeni glavni vhodi:
| Vhod | Vloga |
|---|---|
openai-api-key | Ključ, shranjen kot GitHub skrivnost (npr. OPENAI_API_KEY) |
prompt ali prompt-file | Navodilo v vrstici ali datoteka v repozitoriju – eno ali drugo, ne oboje hkrati |
sandbox | read-only, workspace-write ali danger-full-access: izberi najožji obseg, ki zadošča |
model, effort | Model in trud razmišljanja; če sta prazna, veljajo privzete vrednosti |
output-file | Shrani končno sporočilo Codexa za nadaljnje korake |
codex-args | Dodatne možnosti za codex exec |
safety-strategy | Privzeto drop-sudo, kar odstrani sudo pred izvajanjem in ščiti skrivnosti v pomnilniku |
Akcija teče na izvajalcih Linux ali macOS (na Windows potrebuješ safety-strategy: unsafe) po actions/checkout kode. Sama po sebi ne objavi ničesar: zadnje sporočilo Codexa izpostavi v izhodu final-message, ki ga lahko objavi naslednji korak.
Avtomatiziraj pregled za vsak PR
Spodnji delovni tok sledi strukturi uradnega primera: prvo opravilo zažene Codex v načinu samo za branje, drugo, ki ima dodeljena dovoljenja za zapisovanje na PR-je, pa objavi rezultat kot komentar. Tvoja merila vnesi v poziv.
# .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 }}
Poziv si zasluži več pozornosti kot preostanek datoteke: generični pregled spremeni v takšnega, ki ustreza tvojim prioritetam. Lahko ga premakneš iz YAML-a v verzionirano datoteko, na primer .github/codex/prompts/review.md, na katero se sklicuješ z prompt-file. Za preprost pregled PR se avtomatski pregled, vgrajen v GitHub (Lekcija 11), izogne pisanju delovnega toka.
Zapolni manjkajoče teste
Drugi delovni tok obravnava kodo, dostavljeno brez testov. Codex mora tu pisati v delovni prostor (sandbox: workspace-write), vendar rezultat ostane predlog: delovni tok ga spremeni v prenosljiv obliž, ki ga razvijalec pregleda in sam uporabi.
# .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
Razvijalec ohranja nadzor od začetka do konca: prenese obliž, ga prilagodi ali zavrne. Dokumentacija akcije priporoča, da Codex zaženeš zadnjega v opravilu, da nadaljnji koraki ne podedujejo nepričakovanih sprememb – tu naslednji korak le prebere razliko.
Reagiraj na neuspeh CI
Tretji delovni tok se poveže z rezultatom drugega delovnega toka. Ko CI odpove, Codex ponovno zažene teste na ustreznem commitu, izsledi vzrok in pripravi diagnozo brez potiskanja česar koli:
# .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
Ta zahteva največ previdnosti. Neuspešen test včasih signalizira napako v zasnovi in verjeten samodejni popravek ga lahko odstrani z zaslona, ne da bi ga rešil: CI se spet obarva zeleno, težava pa ostane. Zato izbira diagnoze za pregled namesto samodejno potisnjenega commita.
Klici Codex iz tvojih skript
Zunaj GitHub Actions se codex exec prilega v katero koli skripto. Privzeto teče v peskovniku samo za branje; daj mu dovoljenje za zapis z --sandbox workspace-write, ko opravilo to zahteva. Spodnji hook pred commitom označi datoteke TypeScript brez testov in sproti generira enega:
#!/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 privzeto ponovno uporabi shranjeno avtentikacijo; namesto tega priskrbi poverilnice izrecno z uporabo namenskega ključa API.
Preslikaj integracijske točke
Ko so ti gradniki na mestu, razmišljaj v smislu dogodkov dobavnega cikla in ne datotek YAML. Pet spodnjih scenarijev pokriva najpogostejše primere:
| Stopnja CI/CD | Opravilo Codex | Sprožilec |
|---|---|---|
| Odprt PR | Samodejni pregled | pull_request opened |
| Odprt PR | Generiranje testov | pull_request opened |
| Neuspeh CI | Analiza in popravek | workflow_run failure |
| Izdaja | Samodejni dnevnik sprememb | tag push |
| Posodobitev odvisnosti | Preverjanje združljivosti | Dependabot PR |
Ohrani nadzor nad avtomatizacijo
Integracija CI/CD teče brez nadzora, kar zahteva nekaj osnovnih previdnostnih ukrepov. Omeji, kdo lahko sproži delovne toke – privzeto lahko akcijo zaženejo le uporabniki z dovoljenji za zapis (uporabi allow-users, allow-bots za izrecno razširitev). Prečisti vhodne podatke iz PR-jev, sporočil commitov ali težav, preden jih posreduješ Codexu: skrito besedilo lahko vsebuje vbrizgan poziv. Uporabi ključ API, namenjen minimalnim dovoljenjem, namesto osebnega ključa razvijalca, ki ga bo ta odnesel s seboj, ko zapusti podjetje, in s tem porušil tvoje cevovode. Nikoli samodejno ne združi popravka, ki ga ustvari Codex: človeški pregled ostaja vrata v glavno vejo. Nastavi izrecne omejitve števila opravil na dan in največjih stroškov, da napačno konfigurirana zanka popravkov čez noč ne porabi tvojega mesečnega proračuna. Nazadnje, vodi zgodovino opravil Codex, izvršenih v CI: dan, ko se v produkciji pojavi nepričakovano vedenje, bodo ti dnevniki tvoja edina trdna sled.
Ključne ugotovitve
- Codex se integrira v GitHub Actions in druge sisteme CI/CD
- Samodejni pregled na PR-jih je najpogostejši primer uporabe
- Codex lahko samodejno popravi neuspehe CI
- CLI omogoča integracijo v prilagojene skripte
- Vedno ohrani človeka v zanki za validacijo popravkov