Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Integracija CI/CD

Lekcija 14 od 20 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Codex u tvom isporučnom kanalu
  2. Službena GitHub akcija
  3. Automatiziraj pregled za svaki PR
  4. Popuni nedostajuće testove
  5. Reagiraj na neuspjeh CI-ja
  6. Pozovi Codex iz vlastitih skripti
  7. Mapiraj točke integracije
  8. Zadrži kontrolu nad automatizacijom
  9. Ključne točke

Ažurirano 3. studenoga 2026. na temelju stranica Codex GitHub Action i Non-interactive mode u Codex dokumentaciji: naslijeđeni ulazni parametri task, criteria, scope, framework i api-key ne postoje u openai/codex-action@v1 (zamijenjeni su s openai-api-key, prompt/prompt-file, sandbox, output-file itd.). Akcija sama po sebi ne objavljuje komentare. Izraz == failure bez navodnika nije funkcionirao. Zastavica --apply zamijenjena je s codex exec --sandbox workspace-write. Izvori: Codex GitHub Action · Non-interactive mode.

Codex u tvom isporučnom kanalu

Codex nije ograničen na zadatke koje programer pokreće ručno. Integrira se u tvoje CI/CD kanale kako bi automatizirao razvojne zadatke u svakoj fazi ciklusa isporuke. Ovaj pomak nadilazi uštedu vremena: pregled koda, generiranje testova i ispravljanje grešaka više ne ovise o individualnoj disciplini, već postaju koraci u kanalu koje pokreću događaji, a ne dobra volja petkom poslijepodne.

Službena GitHub akcija

OpenAI objavljuje akciju openai/codex-action@v1 koja instalira CLI, pokreće proxy za Responses API kada dostaviš ključ i izvršava codex exec s dopuštenjima koja postaviš. Njezini glavni ulazni parametri:

Ulazni parametarUloga
openai-api-keyKljuč pohranjen kao GitHub tajna (npr. OPENAI_API_KEY)
prompt ili prompt-fileUputa u liniji ili datoteka u repozitoriju – jedno ili drugo, nikako oboje
sandboxread-only, workspace-write ili danger-full-access: odaberi najuži mogući opseg koji je dovoljan
model, effortModel i napor rezoniranja; ako su prazni, primjenjuju se zadane vrijednosti
output-fileSprema konačnu poruku Codexa za naredne korake
codex-argsDodatne opcije za codex exec
safety-strategyZadana vrijednost je drop-sudo, koja uklanja sudo prije izvršavanja i štiti tajne u memoriji

Akcija se izvršava na Linux ili macOS runnerima (na Windowsima ti treba safety-strategy: unsafe) nakon actions/checkout koda. Sama ništa ne objavljuje: izlaže posljednju poruku Codexa u izlazu final-message, koju naknadni korak može objaviti.

Automatiziraj pregled za svaki PR

Tijek rada u nastavku slijedi strukturu službenog primjera: prvi posao pokreće Codex u načinu samo za čitanje, a drugi, s dodijeljenim dopuštenjima za pisanje na PR-ovima, objavljuje rezultat kao komentar. Tvoji kriteriji idu u upitu (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 }}

Upit zaslužuje više pažnje od ostatka datoteke: on pretvara generički pregled u onaj koji odgovara tvojim prioritetima. Možeš ga izmjestiti iz YAML-a u verzioniranu datoteku, primjerice .github/codex/prompts/review.md, na koju se referenciraš putem prompt-file. Za jednostavan pregled PR-a, automatski pregled ugrađen u GitHub (Lekcija 11) izbjegava potrebu za pisanjem tijeka rada.

Popuni nedostajuće testove

Drugi tijek rada bavi se kodom isporučenim bez testova. Ovdje Codex mora pisati u radni prostor (sandbox: workspace-write), ali rezultat ostaje prijedlog: tijek rada ga pretvara u preuzimljiv patch koji programer sam pregledava i primjenjuje.

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

Programer zadržava kontrolu od početka do kraja: preuzima patch, prilagođava ga ili odbija. Dokumentacija akcije preporučuje pokretanje Codexa kao posljednjeg koraka u poslu kako naredni koraci ne bi naslijedili neočekivane promjene – ovdje jedini sljedeći korak samo čita razliku (diff).

Reagiraj na neuspjeh CI-ja

Treći tijek rada povezuje se s rezultatom drugog tijeka rada. Kada CI ne uspije, Codex ponovno pokreće testove na relevantnom commitu, otkriva uzrok i generira dijagnozu bez guranja bilo čega:

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

Ovaj zahtijeva najveći oprez. Neuspjeli test ponekad signalizira dizajnersku manu, a uvjerljivo automatsko ispravljanje može ga ukloniti s ekrana bez da ga zapravo riješi: CI ponovno postaje zelen, ali problem ostaje. Stoga izbor dijagnoze za pregled umjesto automatski gurnutog commita.

Pozovi Codex iz vlastitih skripti

Izvan GitHub Actions, codex exec staje u bilo koju skriptu. Zadano se izvršava u sandboxu samo za čitanje; daj mu dopuštenje za pisanje s --sandbox workspace-write kada zadatak to zahtijeva. Donji pre-commit hook označava TypeScript datoteke bez testova i generira jednu u letu:

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

U CI-u, codex exec zadano ponovno koristi spremljenu autentifikaciju; umjesto toga, eksplicitno dostavi vjerodajnice koristeći namjenski API ključ.

Mapiraj točke integracije

Kada su ti gradivni blokovi na mjestu, razmišljaj u smislu događaja ciklusa isporuke, a ne YAML datoteka. Pet scenarija u nastavku pokriva najčešće slučajeve:

Faza CI/CDZadatak CodexaOkidač
PR otvorenAutomatski pregledpull_request opened
PR otvorenGeneriranje testovapull_request opened
Neuspjeh CI-jaAnaliza i popravakworkflow_run failure
Izdanje (Release)Automatski dnevnik promjenatag push
Ažuriranje ovisnostiProvjera kompatibilnostiDependabot PR

Zadrži kontrolu nad automatizacijom

Integracija CI/CD radi nenadzirano, što zahtijeva neke osnovne mjere opreza. Ograniči tko može pokrenuti tijekove rada – zadano samo korisnici s dopuštenjima za pisanje mogu pokrenuti akciju (koristi allow-users, allow-bots za eksplicitno proširenje). Pročisti ulazne podatke iz PR-ova, poruka commita ili issuea prije nego ih predaš Codexu: skriveni tekst može sadržavati injekciju upita. Koristi API ključ namijenjen minimalnim dopuštenjima umjesto osobnog ključa programera, koji će ponijeti sa sobom kada napusti tvrtku i time slomiti tvoje kanale. Nikada automatski ne spajaj (merge) popravak koji je proizveo Codex: ljudski pregled ostaje kapija prema glavnoj grani. Postavi eksplicitna ograničenja na broj zadataka dnevno i maksimalni trošak kako konfiguracijska petlja greške ne bi potrošila tvoj mjesečni budžet preko noći. Naposljetku, vodi povijest Codex zadataka izvršenih u CI-u: dana kada se u produkciji pojavi neočekivano ponašanje, ti će zapisi biti tvoj jedini čvrst trag.

Ključne točke

  • Codex se integrira u GitHub Actions i druge CI/CD sustave
  • Automatski pregled na PR-ovima najčešći je slučaj upotrebe
  • Codex može automatski popraviti neuspjehe CI-ja
  • CLI omogućuje integraciju u prilagođene skripte
  • Uvijek zadrži čovjeka u petlji za validaciju popravaka