Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Integrazzjoni CI/CD

Lezzjoni 14 / 20 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Codex fil-Pipeline ta’ Kunsinna Tiegħek
  2. L-Azzjoni Uffiċjali ta’ GitHub
  3. Awtomatizza r-Reviżjoni għal Kull PR
  4. Imla t-Testijiet Nieqsa
  5. Irreaġixxi għal Falliment ta’ CI
  6. Sejjaħ lil Codex mill-Iskripts Tiegħek Stess
  7. Ippjana l-Punti ta’ Integrazzjoni
  8. Żomm il-Kontroll tal-Awtomazzjoni
  9. Punti Ewlenin

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, u api-key ma jeżistux f’openai/codex-action@v1 (issostitwiti minn openai-api-key, prompt/prompt-file, sandbox, output-file, eċċ.). L-azzjoni ma tippubblikax kummenti waħedha. L-espressjoni == failure mingħajr virgoli ma ħadmitx. Il-flag --apply ġie ssostitwit minn codex 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:

InputRwol
openai-api-keyIċ-ċavetta, maħżuna bħala sigriet ta’ GitHub (pereżempju OPENAI_API_KEY)
prompt jew prompt-fileL-istruzzjoni inline, jew fajl fir-repożitorju—wieħed jew l-ieħor, mhux it-tnejn
sandboxread-only, workspace-write, jew danger-full-access: agħżel l-aktar ambitu ristrett li jkun biżżejjed
model, effortIl-mudell u l-isforz tar-raġunament; jekk vojta, japplikaw valuri predefiniti
output-fileJissalva l-messaġġ finali ta’ Codex għal passi sussegwenti
codex-argsGħażliet addizzjonali għal codex exec
safety-strategyPredefinit 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/CDKompitu ta’ CodexTrigger
PR miftuħReviżjoni awtomatikapull_request opened
PR miftuħĠenerazzjoni ta’ testijietpull_request opened
Falliment ta’ CIAnaliżi u tiswijaworkflow_run failure
RilaxxChangelog awtomatikutag push
Aġġornament ta’ dipendenzaVerifika 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