Integrācija CI/CD
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz Codex GitHub Action un Neinteraktīvais režīms lapām Codex dokumentācijā: mantotie ievades parametri
task,criteria,scope,frameworkunapi-keynepastāv versijāopenai/codex-action@v1(tos aizstājopenai-api-key,prompt/prompt-file,sandbox,output-fileu.c.). Darbība pati par sevi nepublicē komentārus. Izteiksme== failurebez pēdiņām nedarbojās. Karogs--applyir aizstāts arcodex exec --sandbox workspace-write. Avoti: Codex GitHub Action · Neinteraktīvais režīms.
Codex tavā piegādes cauruļvadā
Codex neaprobežojas tikai ar uzdevumiem, ko izstrādātājs uzsāk manuāli. Tas integrējas tavos CI/CD cauruļvados, lai automatizētu izstrādes uzdevumus katrā piegādes cikla posmā. Šī pārmaiņa ir vairāk nekā laika ietaupījums: koda apskate, testu ģenerēšana un kļūdu labošana vairs nav atkarīgas no individuālas disciplīnas, bet kļūst par cauruļvada soļiem, ko aktivizē notikumi, nevis piektdienas pēcpusdienas labā griba.
Oficiālā GitHub darbība
OpenAI publicē darbību openai/codex-action@v1, kas instalē CLI, startē Responses API starpniekserveri, kad norādi atslēgu, un palaiž codex exec ar tavām noteiktajām atļaujām. Tās galvenie ievades parametri:
| Ievade | Loma |
|---|---|
openai-api-key | Atslēga, kas glabāta kā GitHub noslēpums (piemēram, OPENAI_API_KEY) |
prompt vai prompt-file | Instrukcija tieši tekstā vai fails repozitorijā – viens vai otrs, ne abi |
sandbox | read-only, workspace-write vai danger-full-access: izvēlies šaurāko pietiekamo darbības jomu |
model, effort | Modelis un spriešanas intensitāte; ja tukšs, tiek piemērotas noklusējuma vērtības |
output-file | Saglabā Codex beigu ziņojumu nākamajiem soļiem |
codex-args | Papildu opcijas priekš codex exec |
safety-strategy | Noklusējums ir drop-sudo, kas noņem sudo pirms izpildes un aizsargā noslēpumus atmiņā |
Darbība darbojas Linux vai macOS izpildītājos (Windows gadījumā nepieciešams safety-strategy: unsafe) pēc koda izgūšanas ar actions/checkout. Tā neko nepublicē pati: tā dara pieejamu Codex pēdējo ziņojumu izvades parametrā final-message, ko var publicēt nākamais solis.
Automatizē apskati katram PR
Tālāk redzamā darbplūsma seko oficiālā piemēra struktūrai: pirmais uzdevums palaiž Codex lasīšanas režīmā, bet otrais, kam ir rakstīšanas atļaujas PR, publicē rezultātu kā komentāru. Tavi kritēriji nonāk 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 }}
Promptam jāveltī vairāk uzmanības nekā pārējam failam: tas pārvērš vispārīgu apskati tādā, kas atbilst tavām prioritātēm. Tu vari pārvietot to no YAML uz versijētu failu, piemēram, .github/codex/prompts/review.md, uz kuru norāda ar prompt-file. Vienkāršai PR apskatei automātiskā apskate, kas iebūvēta GitHub (11. nodarbība), ļauj izvairīties no darbplūsmas rakstīšanas vispār.
Aizpildi trūkstošos testus
Otra darbplūsma risina situāciju, kad kods tiek piegādāts bez testiem. Šeit Codex ir jāraksta darbvietā (sandbox: workspace-write), taču rezultāts paliek tikai kā priekšlikums: darbplūsma to pārvērš lejupielādējamā plāksterī, ko izstrādātājs pats apskata un piemēro.
# .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
Izstrādātājs saglabā kontroli no sākuma līdz beigām: viņš iegūst plāksteri, pielāgo to vai noraida. Darbības dokumentācija iesaka palaist Codex kā pēdējo soli uzdevumā, lai nākamie soļi nemantotu negaidītas izmaiņas – šeit vienīgais nākamais solis tikai nolasa atšķirības.
Reaģē uz CI kļūmi
Trešā darbplūsma pieslēdzas cita cauruļvada rezultātam. Kad CI neizdodas, Codex atkārto testus attiecīgajā commit, noskaidro cēloni un sagatavo diagnozi, neko nepushojot:
# .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
Šis gadījums prasa vislielāko piesardzību. Neizdevies tests dažkārt signalizē par dizaina kļūdu, un ticams automātisks labojums var to pazudināt no ekrāna, neatrisinot problēmu: CI atkal kļūst zaļš, bet problēma paliek. Tāpēc tiek izvēlēta apskatāma diagnoze, nevis automātiski pushots commit.
Izsauc Codex no saviem skriptiem
Āpus GitHub Actions, codex exec iederas jebkurā skriptā. Pēc noklusējuma tas darbojas lasīšanas režīma smilškastē; piešķir tam rakstīšanas atļauju ar --sandbox workspace-write, kad uzdevums to prasa. Tālāk redzamais pre-commit āķis atzīmē TypeScript failus bez testiem un ģenerē vienu uz vietas:
#!/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
CI vidē codex exec pēc noklusējuma atkārtoti izmanto saglabātu autentifikāciju; tā vietā norādi akreditācijas datus tieši, izmantojot īpašu API atslēgu.
Kartē integrācijas punktus
Kad šie būvbloki ir vietā, domā piegādes cikla notikumu, nevis YAML failu kategorijās. Pieci tālāk minētie scenāriji aptver visbiežāk sastopamos gadījumus:
| CI/CD posms | Codex uzdevums | Aktivators |
|---|---|---|
| PR atvērts | Automātiska apskate | pull_request opened |
| PR atvērts | Testu ģenerēšana | pull_request opened |
| CI kļūme | Analīze un labojums | workflow_run failure |
| Laidiens | Automātisks izmaiņu žurnāls | tag push |
| Atkarību atjaunināšana | Saderības pārbaude | Dependabot PR |
Saglabā kontroli pār automatizāciju
CI/CD integrācija darbojas bez uzraudzības, kas prasa dažus pamata piesardzības pasākumus. Ierobežo, kas var aktivizēt darbplūsmas – pēc noklusējuma tikai lietotāji ar rakstīšanas atļaujām var palaist darbību (izmanto allow-users, allow-bots, lai to tieši paplašinātu). Attīri ievades datus no PR, commit ziņojumiem vai problēmām, pirms nodod tos Codex: slēpts teksts var saturēt prompta injekciju. Izmanto API atslēgu ar minimālām atļaujām, nevis izstrādātāja personīgo atslēgu, ko viņš paņems līdzi, aizejot no uzņēmuma, un tādējādi salauzs tavus cauruļvadus. Nekad automātiski neveic merge ar Codex radītu labojumu: cilvēka apskate paliek vārti uz galveno zaru. Noteic skaidrus limitus uzdevumu skaitam dienā un maksimālajām izmaksām, lai nepareizi konfigurēta korekcijas cilpa vienā naktī nesadedzinātu tavu mēneša budžetu. Visbeidzot, glabā vēsturi par CI izpildītajiem Codex uzdevumiem: dienā, kad ražošanā parādās negaidīta uzvedība, šie žurnāli būs tavs vienīgais stabils pavediens.
Galvenās atziņas
- Codex integrējas GitHub Actions un citās CI/CD sistēmās
- Automātiska apskate PR ir visizplatītākais lietojuma gadījums
- Codex var automātiski labot CI kļūmes
- CLI ļauj integrāciju pielāgotos skriptos
- Vienmēr paturi cilvēku ciklā, lai validētu labojumus