Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Integracija CI/CD

Lekcija 14 od 20 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Codex v tvojem dobavnem toku
  2. Uradna GitHub akcija
  3. Avtomatiziraj pregled za vsak PR
  4. Zapolni manjkajoče teste
  5. Reagiraj na neuspeh CI
  6. Klici Codex iz tvojih skript
  7. Preslikaj integracijske točke
  8. Ohrani nadzor nad avtomatizacijo
  9. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi strani Codex GitHub Action in Non-interactive mode v dokumentaciji Codex: podedovani vhodi task, criteria, scope, framework in api-key ne obstajajo v openai/codex-action@v1 (nadomeščeni z openai-api-key, prompt/prompt-file, sandbox, output-file itd.). Akcija sama po sebi ne objavlja komentarjev. Izraz == failure brez narekovajev ni deloval. Zastavica --apply je nadomeščena z codex exec --sandbox workspace-write. Viri: Codex GitHub Action · Non-interactive mode.

Codex v tvojem dobavnem toku

Codex ni omejen na opravila, ki jih razvijalec zažene ročno. Integrira se v tvoje CI/CD cevovode, da avtomatizira razvojna opravila na vsaki stopnji dobavnega cikla. Ta premik presega zgolj varčevanje s časom: pregled kode, generiranje testov in popravki napak prenehajo biti odvisni od posameznikove discipline in postanejo koraki v cevovodu, sproženi z dogodki, ne pa z dobro voljo petek popoldne.

Uradna GitHub akcija

OpenAI objavlja akcijo openai/codex-action@v1, ki namesti CLI, zažene proxy Responses API, ko priskrbiš ključ, in zažene codex exec z dovoljenji, ki jih nastaviš. Njeni glavni vhodi:

VhodVloga
openai-api-keyKljuč, shranjen kot GitHub skrivnost (npr. OPENAI_API_KEY)
prompt ali prompt-fileNavodilo v vrstici ali datoteka v repozitoriju – eno ali drugo, ne oboje hkrati
sandboxread-only, workspace-write ali danger-full-access: izberi najožji obseg, ki zadošča
model, effortModel in trud razmišljanja; če sta prazna, veljajo privzete vrednosti
output-fileShrani končno sporočilo Codexa za nadaljnje korake
codex-argsDodatne možnosti za codex exec
safety-strategyPrivzeto drop-sudo, kar odstrani sudo pred izvajanjem in ščiti skrivnosti v pomnilniku

Akcija teče na izvajalcih Linux ali macOS (na Windows potrebuješ safety-strategy: unsafe) po actions/checkout kode. Sama po sebi ne objavi ničesar: zadnje sporočilo Codexa izpostavi v izhodu final-message, ki ga lahko objavi naslednji korak.

Avtomatiziraj pregled za vsak PR

Spodnji delovni tok sledi strukturi uradnega primera: prvo opravilo zažene Codex v načinu samo za branje, drugo, ki ima dodeljena dovoljenja za zapisovanje na PR-je, pa objavi rezultat kot komentar. Tvoja merila vnesi v poziv.

# .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 }}

Poziv si zasluži več pozornosti kot preostanek datoteke: generični pregled spremeni v takšnega, ki ustreza tvojim prioritetam. Lahko ga premakneš iz YAML-a v verzionirano datoteko, na primer .github/codex/prompts/review.md, na katero se sklicuješ z prompt-file. Za preprost pregled PR se avtomatski pregled, vgrajen v GitHub (Lekcija 11), izogne pisanju delovnega toka.

Zapolni manjkajoče teste

Drugi delovni tok obravnava kodo, dostavljeno brez testov. Codex mora tu pisati v delovni prostor (sandbox: workspace-write), vendar rezultat ostane predlog: delovni tok ga spremeni v prenosljiv obliž, ki ga razvijalec pregleda in sam uporabi.

# .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

Razvijalec ohranja nadzor od začetka do konca: prenese obliž, ga prilagodi ali zavrne. Dokumentacija akcije priporoča, da Codex zaženeš zadnjega v opravilu, da nadaljnji koraki ne podedujejo nepričakovanih sprememb – tu naslednji korak le prebere razliko.

Reagiraj na neuspeh CI

Tretji delovni tok se poveže z rezultatom drugega delovnega toka. Ko CI odpove, Codex ponovno zažene teste na ustreznem commitu, izsledi vzrok in pripravi diagnozo brez potiskanja česar koli:

# .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

Ta zahteva največ previdnosti. Neuspešen test včasih signalizira napako v zasnovi in verjeten samodejni popravek ga lahko odstrani z zaslona, ne da bi ga rešil: CI se spet obarva zeleno, težava pa ostane. Zato izbira diagnoze za pregled namesto samodejno potisnjenega commita.

Klici Codex iz tvojih skript

Zunaj GitHub Actions se codex exec prilega v katero koli skripto. Privzeto teče v peskovniku samo za branje; daj mu dovoljenje za zapis z --sandbox workspace-write, ko opravilo to zahteva. Spodnji hook pred commitom označi datoteke TypeScript brez testov in sproti generira enega:

#!/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

V CI codex exec privzeto ponovno uporabi shranjeno avtentikacijo; namesto tega priskrbi poverilnice izrecno z uporabo namenskega ključa API.

Preslikaj integracijske točke

Ko so ti gradniki na mestu, razmišljaj v smislu dogodkov dobavnega cikla in ne datotek YAML. Pet spodnjih scenarijev pokriva najpogostejše primere:

Stopnja CI/CDOpravilo CodexSprožilec
Odprt PRSamodejni pregledpull_request opened
Odprt PRGeneriranje testovpull_request opened
Neuspeh CIAnaliza in popravekworkflow_run failure
IzdajaSamodejni dnevnik spremembtag push
Posodobitev odvisnostiPreverjanje združljivostiDependabot PR

Ohrani nadzor nad avtomatizacijo

Integracija CI/CD teče brez nadzora, kar zahteva nekaj osnovnih previdnostnih ukrepov. Omeji, kdo lahko sproži delovne toke – privzeto lahko akcijo zaženejo le uporabniki z dovoljenji za zapis (uporabi allow-users, allow-bots za izrecno razširitev). Prečisti vhodne podatke iz PR-jev, sporočil commitov ali težav, preden jih posreduješ Codexu: skrito besedilo lahko vsebuje vbrizgan poziv. Uporabi ključ API, namenjen minimalnim dovoljenjem, namesto osebnega ključa razvijalca, ki ga bo ta odnesel s seboj, ko zapusti podjetje, in s tem porušil tvoje cevovode. Nikoli samodejno ne združi popravka, ki ga ustvari Codex: človeški pregled ostaja vrata v glavno vejo. Nastavi izrecne omejitve števila opravil na dan in največjih stroškov, da napačno konfigurirana zanka popravkov čez noč ne porabi tvojega mesečnega proračuna. Nazadnje, vodi zgodovino opravil Codex, izvršenih v CI: dan, ko se v produkciji pojavi nepričakovano vedenje, bodo ti dnevniki tvoja edina trdna sled.

Ključne ugotovitve

  • Codex se integrira v GitHub Actions in druge sisteme CI/CD
  • Samodejni pregled na PR-jih je najpogostejši primer uporabe
  • Codex lahko samodejno popravi neuspehe CI
  • CLI omogoča integracijo v prilagojene skripte
  • Vedno ohrani človeka v zanki za validacijo popravkov