Integrazzjoni CI/CD
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026 abbażi tal-paġni Codex GitHub Action u Non-interactive mode fid-dokumentazzjoni ta’ Codex: l-inputs antiki
task,criteria,scope,framework, uapi-keyma jeżistux f’openai/codex-action@v1(issostitwiti minnopenai-api-key,prompt/prompt-file,sandbox,output-file, eċċ.). L-azzjoni ma tippubblikax kummenti waħedha. L-espressjoni== failuremingħajr virgoli ma ħadmitx. Il-flag--applyġie ssostitwit minncodex exec --sandbox workspace-write. Sorsi: Codex GitHub Action · Non-interactive mode.
Codex fil-Pipeline ta’ Kunsinna Tiegħek
Codex mhux limitat għal kompiti li żviluppatur jnieda manwalment. Jintegra fil-pipelines CI/CD tiegħek biex jawtomatizza kompiti ta’ żvilupp f’kull fażi taċ-ċiklu ta’ kunsinna. Dan il-bidla tmur lil hinn milli tiffranka l-ħin: ir-reviżjoni tal-kodiċi, il-ġenerazzjoni tat-testijiet, u t-tiswija tal-bugs jieqfu jiddependu fuq id-dixxiplina individwali u jsiru passi fil-pipeline attivati minn avvenimenti, mhux mill-bonavoglia ta’ wara nofsinhar ta’ Ġimgħa.
L-Azzjoni Uffiċjali ta’ GitHub
OpenAI tippubblika azzjoni, openai/codex-action@v1, li tinstalla l-CLI, tniedi l-proxy tar-Responses API meta tipprovdi ċavetta, u tħaddem codex exec bil-permessi li tistabbilixxi. L-inputs ewlenin tagħha:
| Input | Rwol |
|---|---|
openai-api-key | Iċ-ċavetta, maħżuna bħala sigriet ta’ GitHub (pereżempju OPENAI_API_KEY) |
prompt jew prompt-file | L-istruzzjoni inline, jew fajl fir-repożitorju—wieħed jew l-ieħor, mhux it-tnejn |
sandbox | read-only, workspace-write, jew danger-full-access: agħżel l-aktar ambitu ristrett li jkun biżżejjed |
model, effort | Il-mudell u l-isforz tar-raġunament; jekk vojta, japplikaw valuri predefiniti |
output-file | Jissalva l-messaġġ finali ta’ Codex għal passi sussegwenti |
codex-args | Għażliet addizzjonali għal codex exec |
safety-strategy | Predefinit għal drop-sudo, li jneħħi sudo qabel l-eżekuzzjoni u jipproteġi s-sigrieti fil-memorja |
L-azzjoni taħdem fuq runners ta’ Linux jew macOS (fuq Windows, teħtieġ safety-strategy: unsafe) wara actions/checkout tal-kodiċi. Ma tippubblika xejn waħedha: tesponi l-aħħar messaġġ ta’ Codex fl-output final-message, li pass sussegwenti jista’ jippubblika.
Awtomatizza r-Reviżjoni għal Kull PR
Il-fluss ta’ xogħol hawn taħt isegwi l-istruttura tal-eżempju uffiċjali: l-ewwel impjieg iħaddem lil Codex f’modalità read-only, u t-tieni, mogħti permessi ta’ kitba fuq il-PRs, jippubblika r-riżultat bħala kumment. Il-kriterji tiegħek imorru fil-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 }}
Il-prompt jistħoqqilu aktar attenzjoni mill-bqija tal-fajl: jittrasforma reviżjoni ġenerika f’waħda li taqbel mal-prijoritajiet tiegħek. Tista’ tmexxieh barra mill-YAML f’fajl b’verżjonijiet, pereżempju .github/codex/prompts/review.md, irreferenzjat minn prompt-file. Għal reviżjoni sempliċi ta’ PR, ir-reviżjoni awtomatika mibnija f’GitHub (Lezzjoni 11) tevita li tikteb fluss ta’ xogħol għalkollox.
Imla t-Testijiet Nieqsa
It-tieni fluss ta’ xogħol jittratta kodiċi kkunsinnat mingħajr testijiet. Hawnhekk Codex irid jikteb fil-workspace (sandbox: workspace-write), iżda r-riżultat jibqa’ proposta: il-fluss ta’ xogħol ihawwlu f’patch li tista’ tniżżel li l-iżviluppatur jirrevedja u japplika huwa stess.
# .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
L-iżviluppatur iżomm il-kontroll mill-bidu sal-aħħar: iġib il-patch, jadattaha, jew jiċħadha. Id-dokumentazzjoni tal-azzjoni tirrakkomanda li tħaddem lil Codex l-aħħar f’impjieg sabiex passi downstream ma jirtux bidliet mhux mistennija—hawnhekk, l-uniku pass li jmiss sempliċiment jaqra d-diff.
Irreaġixxi għal Falliment ta’ CI
It-tielet fluss ta’ xogħol jingħaqad mar-riżultat ta’ fluss ta’ xogħol ieħor. Meta l-CI tfalli, Codex jerġa’ jħaddem it-testijiet fuq il-commit rilevanti, ifittex il-kawża, u jipproduċi dijanjosi mingħajr ma jimbotta xejn:
# .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
Dan jeħtieġ l-aktar prekawzjoni. Test li jfalli xi kultant jissinjala difett fid-disinn, u tiswija awtomatika plawżibbli tista’ tgħibu mill-iskrin mingħajr ma ssolvih: il-CI terġa’ ssir ħadra, iżda l-problema tibqa’. Għalhekk il-għażla ta’ dijanjoni biex tiġi rrevedjuta minflok commit imimbottat awtomatikament.
Sejjaħ lil Codex mill-Iskripts Tiegħek Stess
Barra minn GitHub Actions, codex exec jidħol f’kull skritt. B’mod predefinit, jaħdem f’sandbox read-only; agħtih permess ta’ kitba b’--sandbox workspace-write meta l-kompit jeħtieġu. Il-hook pre-commit hawn taħt jidentifika fajls TypeScript mingħajr testijiet u jiġġenera wieħed fuq il-post:
#!/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
Fil-CI, codex exec jerġa’ juża l-awtentikazzjoni salvata b’mod predefinit; minflok, ipprovdi kredenzjali b’mod espliċitu billi tuża ċavetta API dedikata.
Ippjana l-Punti ta’ Integrazzjoni
Ladarba dawn il-blokki tal-bini jkunu fil-post, aħseb f’termini ta’ avvenimenti taċ-ċiklu ta’ kunsinna minflok fajls YAML. Il-ħames xenarji hawn taħt ikopru l-aktar każijiet komuni:
| Fażi CI/CD | Kompitu ta’ Codex | Trigger |
|---|---|---|
| PR miftuħ | Reviżjoni awtomatika | pull_request opened |
| PR miftuħ | Ġenerazzjoni ta’ testijiet | pull_request opened |
| Falliment ta’ CI | Analiżi u tiswija | workflow_run failure |
| Rilaxx | Changelog awtomatiku | tag push |
| Aġġornament ta’ dipendenza | Verifika ta’ kompatibbiltà | Dependabot PR |
Żomm il-Kontroll tal-Awtomazzjoni
Integrazzjoni CI/CD taħdem mingħajr superviżjoni, li jsejjaħ għal xi prekawzjonijiet bażiċi. Illimita min jista’ jniedi flussi ta’ xogħol—b’mod predefinit, biss utenti b’permessi ta’ kitba jistgħu jħaddmu l-azzjoni (uża allow-users, allow-bots biex twessa’ dan b’mod espliċitu). Sanitizza l-input minn PRs, messaġġi ta’ commit, jew issues qabel ma tgħaddihom lil Codex: test moħbi jista’ jkun fih injezzjoni ta’ prompt. Uża ċavetta API dedikata għal permessi minimi minflok ċavetta personali ta’ żviluppatur, li se jieħdu magħhom meta jitilqu mill-kumpanija, u jiksru l-pipelines tiegħek. Qatt ma tgħaqqad awtomatikament tiswija prodotta minn Codex: ir-reviżjoni umana tibqa’ l-bieb għall-fergħa prinċipali. Stabbilixxi limiti espliċiti fuq in-numru ta’ kompiti kuljum u l-ispiża massima sabiex ċiklu ta’ korrezzjoni mhux ikkonfigurat sew ma jaħraqx il-baġit mensili tiegħek matul il-lejl. Fl-aħħar nett, żomm storja tal-kompiti ta’ Codex eżegwiti fil-CI: il-jum li tidher imġiba mhux mistennija fil-produzzjoni, dawn il-logs ikunu l-unika traċċa soda tiegħek.
Punti Ewlenin
- Codex jintegra f’GitHub Actions u sistemi CI/CD oħra
- Ir-reviżjoni awtomatika fuq il-PRs hija l-aktar każ ta’ użu komuni
- Codex jista’ jiswi fallimenti ta’ CI awtomatikament
- Il-CLI jippermetti l-integrazzjoni f’skripts personalizzati
- Dejjem żomm bniedem fil-linja biex jivvalida t-tiswijiet