Integratsioon CI/CD-ga
Sellel lehel
Uuendatud 3. novembril 2026, tuginedes Codexi dokumentatsiooni lehtedele Codex GitHub Action ja Non-interactive mode: pärandsisendid
task,criteria,scope,frameworkjaapi-keyei eksisteeri versioonisopenai/codex-action@v1(asendatud sisenditegaopenai-api-key,prompt/prompt-file,sandbox,output-filejne). Tegevus ei postita iseseisvalt kommentaare. Avaldis== failureilma jutumärkideta ei töötanud. Lipp--applyon asendatud käsugacodex exec --sandbox workspace-write. Allikad: Codex GitHub Action · Mitteraktiivne režiim.
Codex sinu tarneahelas
Codex ei piirdu ainult ülesannetega, mida arendaja käsitsi käivitab. See integreerub sinu CI/CD torustikesse, et automatiseerida arendusülesandeid tarne tsükli igas etapis. See muutus tähendab enamat kui aja kokkuhoidu: koodi ülevaatus, testide genereerimine ja vigade parandamine ei sõltu enam üksikisiku distsipliinist, vaid muutuvad torustiku sammudeks, mida käivitavad sündmused, mitte reede pärastlõunane hea tahe.
Ametlik GitHubi tegevus
OpenAI avaldab tegevuse openai/codex-action@v1, mis installib CLI-i, käivitab Responses API proksi, kui annad võtme, ja käivitab codex exec sinu määratud õigustega. Selle peamised sisendid:
| Sisend | Roll |
|---|---|
openai-api-key | Võti, salvestatud GitHubi saladusena (näiteks OPENAI_API_KEY) |
prompt või prompt-file | Juhend reasiseses vormingus või fail hoidlas – kas üks või teine, mitte mõlemad |
sandbox | read-only, workspace-write või danger-full-access: vali kitsaim ulatus, mis piisab |
model, effort | Mudel ja arutluskäigu intensiivsus; kui tühjad, kehtivad vaikimisi väärtused |
output-file | Salvestab Codexi lõpliku sõnumi järgnevate sammude jaoks |
codex-args | Täiendavad valikud käsule codex exec |
safety-strategy | Vaikimisi drop-sudo, mis eemaldab sudo enne käivitamist ja kaitseb saladusi mälus |
Tegevus jookseb Linuxi või macOS-i käivitajatel (Windowsis on vaja safety-strategy: unsafe) pärast koodi väljavõtmist käsuga actions/checkout. See ei postita iseseisvalt midagi: see väljastab Codexi viimase sõnumi väljundis final-message, mida järgmine samm saab postitada.
Automatiseeri ülevaatus iga PR-i jaoks
Allpool olev töövoog järgib ametliku näite struktuuri: esimene töö käivitab Codexi ainult lugemisõigusega režiimis ja teine, millel on PR-ide kirjutamisõigused, postitab tulemuse kommentaarina. Sinu kriteeriumid lähevad viipa (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 }}
Viip väärib rohkem tähelepanu kui ülejäänud fail: see muudab üldise ülevaatuse selliseks, mis vastab sinu prioriteetidele. Saad viia selle YAML-failist eraldi versioonitud faili, näiteks .github/codex/prompts/review.md, millele viidatakse sisendiga prompt-file. Lihtsa PR-i ülevaatuse jaoks väldib GitHubi sisseehitatud automaatne ülevaatus (11. õppetund) töövoogu kirjutamast üldse.
Täida puuduvad testid
Teine töövoog tegeleb koodiga, mis on edastatud ilma testideta. Siin peab Codex töötamisruumi kirjutama (sandbox: workspace-write), kuid tulemus jääb ettepanekuks: töövoog muudab selle allalaaditavaks paigaks, mille arendaja vaatab üle ja rakendab ise.
# .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
Arendaja säilitab kontrolli algusest lõpuni: ta laeb paiga alla, kohandab seda või lükkab tagasi. Tegevuse dokumentatsioon soovitab käivitada Codexi töös viimasena, et järgnevad sammud ei päriks ootamatuid muudatusi – siin loeb järgmine samm lihtsalt diffi.
Reageeri CI ebaõnnestumisele
Kolmas töövoog seostub teise töövoogu tulemusega. Kui CI ebaõnnestub, taasesitab Codex testid asjakohasel committ’il, selgitab välja põhjuse ja koostab diagnoosi ilma midagi push’imata:
# .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
See nõuab suurimat ettevaatust. Ebaõnnestunud test võib viidata disainiveale ja usutav automaatne parandus võib selle ekraanilt kaduma panna, lahendamata probleemi tegelikult: CI muutub taas roheliseks, kuid probleem püsib. Seetõttu valitakse ülevaatamiseks diagnoos, mitte automaatselt pushitud commit.
Kutsu Codexi oma skriptidest
Väljaspool GitHub Actions sobib codex exec igasse skripti. Vaikimisi jookseb see ainult lugemisõigusega liivakastis; anna sellele kirjutamisõigus lipuga --sandbox workspace-write, kui ülesanne seda nõuab. Allpool olev eel-commit konks tuvastab TypeScripti failid ilma testideta ja genereerib need kohapeal:
#!/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-s kasutab codex exec vaikimisi salvestatud autentimist; selle asemel sisenda mandaadid sõnaselgelt, kasutades spetsiaalset API võtit.
Kaardista integratsioonipunktid
Kui need ehitusplokid on paigas, mõtle tarne tsükli sündmuste, mitte YAML-failide kaupa. Allpool olevad viis stsenaariumi katavad levinumad juhtumid:
| CI/CD etapp | Codexi ülesanne | Käiviti |
|---|---|---|
| PR avatud | Automaatne ülevaatus | pull_request opened |
| PR avatud | Testide genereerimine | pull_request opened |
| CI ebaõnnestumine | Analüüs ja parandus | workflow_run failure |
| Väljalase | Automaatne muutuste logi | tag push |
| Sõltuvuse uuendus | Ühilduvuse kontroll | Dependabot PR |
Säilita kontroll automatiseerimise üle
CI/CD integratsioon jookseb järelevalveta, mis nõuab mõningaid põhilisi ettevaatusabinõusid. Piira, kes saab töövooge käivitada – vaikimisi saavad seda teha ainult kasutajad, kellel on kirjutamisõigused (kasuta allow-users, allow-bots, et seda sõnaselgelt laiendada). Puhasta sisendit PR-dest, commit-sõnumitest või probleemidest enne, kui annad selle Codexile: peidetud tekst võib sisaldada viiba süstimist (prompt injection). Kasuta API võtit, millel on minimaalsed õigused, mitte arendaja isiklikku võtit, mida ta ettevõttest lahkudes kaasa võtab ja sinu torustikud katki teeb. Ära kunagi liida automaatselt Codexi loodud parandust: inimlik ülevaatus jääb peaharu väravaks. Määra selged piirangud ülesannete arvule päevas ja maksimaalsele kulule, et valesti seadistatud parandustsükkel ei põletaks läbi sinu kuueelarvet ühe ööga. Lõpuks hoia alles ajalugu CI-s tehtud Codexi ülesannetest: päeval, mil tootmises ilmneb ootamatu käitumine, on need logid sinu ainus kindel juhend.
Peamised punktid
- Codex integreerub GitHub Actionsi ja teiste CI/CD süsteemidega
- Automaatne ülevaatus PR-ide jaoks on levinuim kasutusjuhtum
- Codex suudab parandada CI ebaõnnestumisi automaatselt
- CLI võimaldab integratsiooni kohandatud skriptidesse
- Hoia alati inimene ahelas, et parandusi valideerida