Integrarea CI/CD
Pe această pagină
Actualizat la 3 noiembrie 2026 pe baza paginilor Codex GitHub Action și Non-interactive mode din documentația Codex: intrările moștenite
task,criteria,scope,frameworkșiapi-keynu există înopenai/codex-action@v1(înlocuite deopenai-api-key,prompt/prompt-file,sandbox,output-fileetc.). Acțiunea nu postează comentarii din proprie inițiativă. Expresia== failurefără ghilimele nu funcționa. Flag-ul--applyeste înlocuit decodex exec --sandbox workspace-write. Surse: Codex GitHub Action · Non-interactive mode.
Codex în pipeline-ul dumneavoastră de livrare
Codex nu se limitează la sarcinile pe care un dezvoltator le lansează manual. Se integrează în pipeline-urile CI/CD pentru a automatiza sarcinile de dezvoltare la fiecare etapă a ciclului de livrare. Această schimbare depășește simpla economie de timp: revizuirea codului, generarea testelor și remedierea erorilor încetează să mai depindă de disciplina individuală și devin pași ai pipeline-ului declanșați de evenimente, nu de bunăvoința de vineri după-amiază.
Acțiunea oficială GitHub
OpenAI publică o acțiune, openai/codex-action@v1, care instalează CLI, pornește proxy-ul Responses API atunci când furnizați o cheie și rulează codex exec cu permisiunile pe care le setați. Principalele sale intrări:
| Intrare | Rol |
|---|---|
openai-api-key | Cheia, stocată ca secret GitHub (de exemplu OPENAI_API_KEY) |
prompt sau prompt-file | Instrucțiunea inline sau un fișier din repository – unul sau celălalt, nu ambele |
sandbox | read-only, workspace-write sau danger-full-access: alegeți domeniul cel mai restrâns suficient |
model, effort | Modelul și efortul de raționament; dacă sunt goale, se aplică valorile implicite |
output-file | Salvează mesajul final al lui Codex pentru pașii următori |
codex-args | Opțiuni suplimentare pentru codex exec |
safety-strategy | Implicit drop-sudo, care elimină sudo înainte de execuție și protejează secretele din memorie |
Acțiunea rulează pe runner-e Linux sau macOS (pe Windows, aveți nevoie de safety-strategy: unsafe) după un actions/checkout al codului. Nu postează nimic din proprie inițiativă: expune ultimul mesaj al lui Codex în ieșirea final-message, pe care un pas ulterior o poate posta.
Automatizați revizuirea pentru fiecare PR
Fluxul de lucru de mai jos urmează structura exemplului oficial: un prim job rulează Codex în mod read-only, iar un al doilea, căruia i se acordă permisiuni de scriere pe PR-uri, postează rezultatul ca un comentariu. Criteriile dumneavoastră intră în 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 }}
Prompt-ul merită mai multă atenție decât restul fișierului: transformă o revizuire generică într-una care corespunde priorităților dumneavoastră. Îl puteți muta din YAML într-un fișier versionat, de exemplu .github/codex/prompts/review.md, referențiat prin prompt-file. Pentru o revizuire simplă a PR-ului, revizuirea automată încorporată în GitHub (Lecția 11) evită scrierea unui flux de lucru.
Completați testele lipsă
Un al doilea flux de lucru abordează codul livrat fără teste. Aici, Codex trebuie să scrie în workspace (sandbox: workspace-write), dar rezultatul rămâne o propunere: fluxul de lucru îl transformă într-un patch descărcabil pe care dezvoltatorul îl revizuiește și îl aplică singur.
# .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
Dezvoltatorul păstrează controlul cap-la-cap: preia patch-ul, îl adaptează sau îl respinge. Documentația acțiunii recomandă rularea lui Codex la finalul unui job, astfel încât pașii următori să nu moștenească modificări neașteptate – aici, singurul pas următor citește doar diff-ul.
Reacționați la o eroare CI
Al treilea flux de lucru se conectează la rezultatul unui alt flux de lucru. Când CI eșuează, Codex reia testele pe commit-ul relevant, identifică cauza și generează un diagnostic fără a împinge nimic:
# .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
Acesta necesită cea mai mare prudență. Un test eșuat semnalează uneori o deficiență de design, iar o remediere automată plauzibilă îl poate face să dispară de pe ecran fără a-l rezolva: CI devine din nou verde, dar problema persistă. De aici alegerea unui diagnostic de revizuit, în loc de un commit împins automat.
Apelați Codex din propriile scripturi
În afara GitHub Actions, codex exec se integrează în orice script. Implicit, rulează într-un sandbox read-only; acordați-i permisiunea de scriere cu --sandbox workspace-write atunci când sarcina o cere. Hook-ul pre-commit de mai jos identifică fișierele TypeScript fără teste și generează unul pe loc:
#!/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
În CI, codex exec reutilizează autentificarea salvată implicit; în schimb, furnizați credențialele explicit folosind o cheie API dedicată.
Maparea punctelor de integrare
Odată ce aceste blocuri de construcție sunt în place, gândiți-vă în termeni de evenimente ale ciclului de livrare, nu de fișiere YAML. Cele cinci scenarii de mai jos acoperă cele mai frecvente cazuri:
| Etapă CI/CD | Sarcină Codex | Declanșator |
|---|---|---|
| PR deschis | Revizuire automată | pull_request opened |
| PR deschis | Generare teste | pull_request opened |
| Eșec CI | Analiză și remediere | workflow_run failure |
| Release | Changelog automat | tag push |
| Actualizare dependențe | Verificare compatibilitate | Dependabot PR |
Mențineți controlul asupra automatizării
O integrare CI/CD rulează nesupravegheată, ceea ce impune câteva precauții de bază. Limitați cine poate declanșa fluxurile de lucru – implicit, doar utilizatorii cu permisiuni de scriere pot rula acțiunea (folosiți allow-users, allow-bots pentru a lărgi explicit acest lucru). Sanitizați intrările din PR-uri, mesaje de commit sau issues înainte de a le handing-ui lui Codex: textul ascuns poate conține o injecție de prompt. Folosiți o cheie API dedicată cu permisiuni minime, nu cheia personală a unui dezvoltator, pe care o va lua cu sine când părăsește compania, rupându-vă pipeline-urile. Nu faceți niciodată merge automat al unei remedieri produse de Codex: revizuirea umană rămâne poarta către ramura principală. Stabiliți limite explicite pentru numărul de sarcini pe zi și costul maxim, astfel încât o buclă de corecție configurată greșit să nu vă ardă bugetul lunar peste noapte. În final, păstrați un istoric al sarcinilor Codex executate în CI: în ziua în care apare un comportament neașteptat în producție, aceste jurnale vor fi singura dumneavoastră pistă solidă.
Puncte cheie
- Codex se integrează în GitHub Actions și alte sisteme CI/CD
- Revizuirea automată pe PR-uri este cel mai frecvent caz de utilizare
- Codex poate remedia automat eșecurile CI
- CLI permite integrarea în scripturi personalizate
- Mențineți întotdeauna un om în buclă pentru a valida remedierile