CI/CD-integration
På denne side
Opdateret 3. november 2026 baseret på siderne Codex GitHub Action og Non-interactive mode i Codex-dokumentationen: De ældre inputs
task,criteria,scope,frameworkogapi-keyfindes ikke iopenai/codex-action@v1(erstattet afopenai-api-key,prompt/prompt-file,sandbox,output-fileosv.). Action’en poster ikke kommentarer af sig selv. Udtrykket== failureuden anførselstegn fungerede ikke. Flaget--applyer erstattet afcodex exec --sandbox workspace-write. Kilder: Codex GitHub Action · Non-interactive mode.
Codex i din leveringspipeline
Codex er ikke begrænset til opgaver, som en udvikler starter manuelt. Det integreres i dine CI/CD-pipelines for at automatisere udviklingsopgaver i hvert trin af leveringscyklussen. Dette skift handler om mere end bare tidsbesparelse: kodegennemgang, testgenerering og fejlrettelser afhænger ikke længere af individuel disciplin, men bliver til pipelinetrin, der udløses af begivenheder – ikke af god vilje en fredag eftermiddag.
Den officielle GitHub Action
OpenAI udgiver en action, openai/codex-action@v1, der installerer CLI’en, starter Responses API-proxyen, når du angiver en nøgle, og kører codex exec med de tilladelser, du definerer. Dens vigtigste inputs:
| Input | Rolle |
|---|---|
openai-api-key | Nøglen, gemt som en GitHub-hemmelighed (f.eks. OPENAI_API_KEY) |
prompt eller prompt-file | Instruktionen inline eller en fil i repository’et – det ene eller det andet, ikke begge |
sandbox | read-only, workspace-write eller danger-full-access: vælg det snævreste omfang, der er tilstrækkeligt |
model, effort | Modellen og ræsonnementsindsatsen; hvis tomme, gælder standardværdier |
output-file | Gemmer Codex’ sidste besked til efterfølgende trin |
codex-args | Yderligere indstillinger til codex exec |
safety-strategy | Standard er drop-sudo, hvilket fjerner sudo før eksekvering og beskytter hemmeligheder i hukommelsen |
Action’en kører på Linux- eller macOS-runners (på Windows skal du bruge safety-strategy: unsafe) efter en actions/checkout af koden. Den poster intet af sig selv: den eksponerer Codex’ sidste besked i outputtet final-message, som et efterfølgende trin kan poste.
Automatisér gennemgang for hver PR
Workflowet nedenfor følger strukturen i det officielle eksempel: et første job kører Codex i read-only-tilstand, og et andet, der har skriveadgang til PR’er, poster resultatet som en kommentar. Dine kriterier kommer ind i prompten.
# .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 }}
Prompten fortjener mere opmærksomhed end resten af filen: den transformerer en generisk gennemgang til en, der matcher dine prioriteter. Du kan flytte den ud af YAML’en til en versioneret fil, f.eks. .github/codex/prompts/review.md, som refereres til via prompt-file. Til en simpel PR-gennemgang undgår den automatiske gennemgang, der er indbygget i GitHub (Lektion 11), at skulle skrive et workflow overhovedet.
Udfyld manglende tests
Et andet workflow tager sig af kode, der leveres uden tests. Her skal Codex kunne skrive til workspace’et (sandbox: workspace-write), men resultatet forbliver et forslag: workflowet gør det til en downloadbar patch, som udvikleren gennemgår og anvender selv.
# .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
Udvikleren beholder kontrollen fra start til slut: de henter patchen, tilpasser den eller afviser den. Action-dokumentationen anbefaler at køre Codex sidst i et job, så efterfølgende trin ikke arver uventede ændringer – her læser det eneste næste trin blot diffen.
Reagér på en CI-fejl
Det tredje workflow kobler sig på resultatet af et andet workflow. Når CI fejler, afspiller Codex testene på det relevante commit, finder årsagen og udarbejder en diagnose uden at pushe noget:
# .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
Denne kræver mest forsigtighed. En fejlslagen test signalerer nogle gange en designfejl, og en plausibel automatisk rettelse kan få den til at forsvinde fra skærmen uden at løse problemet: CI bliver grøn igen, men problemet består. Derfor valget af en diagnose til gennemgang frem for et automatisk pushet commit.
Kald Codex fra dine egne scripts
Uden for GitHub Actions passer codex exec ind i ethvert script. Som standard kører det i en read-only sandbox; giv det skriveadgang med --sandbox workspace-write, når opgaven kræver det. Pre-commit-hooket nedenfor flagger TypeScript-filer uden tests og genererer én på farten:
#!/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
I CI genbruger codex exec som standard gemt autentificering; angiv i stedet legitimationsoplysninger eksplicit ved hjælp af en dedikeret API-nøgle.
Kortlæg integrationspunkter
Når disse byggesten er på plads, så tænk i termer af begivenheder i leveringscyklussen frem for YAML-filer. De fem scenarier nedenfor dækker de mest almindelige tilfælde:
| CI/CD-trin | Codex-opgave | Udløser |
|---|---|---|
| PR åbnet | Automatisk gennemgang | pull_request opened |
| PR åbnet | Testgenerering | pull_request opened |
| CI-fejl | Analyse og rettelse | workflow_run failure |
| Release | Automatisk changelog | tag push |
| Opdatering af afhængigheder | Kompatibilitetscheck | Dependabot PR |
Behold kontrollen over automatiseringen
En CI/CD-integration kører uden opsyn, hvilket kræver nogle grundlæggende forholdsregler. Begræns, hvem der kan udløse workflows – som standard kan kun brugere med skriveadgang køre action’en (brug allow-users, allow-bots til eksplicit at udvide dette). Rens input fra PR’er, commit-beskeder eller issues, før du giver det til Codex: skjult tekst kan indeholde en prompt-injection. Brug en API-nøgle dedikeret til minimale tilladelser frem for en udviklers personlige nøgle, som de tager med sig, når de forlader virksomheden, hvilket vil bryde dine pipelines. Merge aldrig automatisk en rettelse produceret af Codex: menneskelig gennemgang forbliver porten til hovedgrenen. Sæt eksplicitte grænser for antallet af opgaver per dag og maksimale omkostninger, så en fejlkonfigureret rettelsessløjfe ikke brænder dit månedlige budget af over natten. Hold endelig en historik over Codex-opgaver udført i CI: den dag en uventet adfærd optræder i produktion, vil disse logs være dit eneste solide spor.
Vigtige pointer
- Codex integreres i GitHub Actions og andre CI/CD-systemer
- Automatisk gennemgang af PR’er er det mest almindelige brugstilfælde
- Codex kan rette CI-fejl automatisk
- CLI’en muliggør integration i tilpassede scripts
- Sørg altid for at have et menneske i løkken til at validere rettelser