Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Integratsioon CI/CD-ga

Õppetund 14 / 20 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Codex sinu tarneahelas
  2. Ametlik GitHubi tegevus
  3. Automatiseeri ülevaatus iga PR-i jaoks
  4. Täida puuduvad testid
  5. Reageeri CI ebaõnnestumisele
  6. Kutsu Codexi oma skriptidest
  7. Kaardista integratsioonipunktid
  8. Säilita kontroll automatiseerimise üle
  9. Peamised punktid

Uuendatud 3. novembril 2026, tuginedes Codexi dokumentatsiooni lehtedele Codex GitHub Action ja Non-interactive mode: pärandsisendid task, criteria, scope, framework ja api-key ei eksisteeri versioonis openai/codex-action@v1 (asendatud sisenditega openai-api-key, prompt/prompt-file, sandbox, output-file jne). Tegevus ei postita iseseisvalt kommentaare. Avaldis == failure ilma jutumärkideta ei töötanud. Lipp --apply on asendatud käsuga codex exec --sandbox workspace-write. Allikad: Codex GitHub Action · Mitteraktiivne režiim.

Codex sinu tarneahelas

Codex ei piirdu ainult ülesannetega, mida arendaja käsitsi käivitab. See integreerub sinu CI/CD torustikesse, et automatiseerida arendusülesandeid tarne tsükli igas etapis. See muutus tähendab enamat kui aja kokkuhoidu: koodi ülevaatus, testide genereerimine ja vigade parandamine ei sõltu enam üksikisiku distsipliinist, vaid muutuvad torustiku sammudeks, mida käivitavad sündmused, mitte reede pärastlõunane hea tahe.

Ametlik GitHubi tegevus

OpenAI avaldab tegevuse openai/codex-action@v1, mis installib CLI-i, käivitab Responses API proksi, kui annad võtme, ja käivitab codex exec sinu määratud õigustega. Selle peamised sisendid:

SisendRoll
openai-api-keyVõti, salvestatud GitHubi saladusena (näiteks OPENAI_API_KEY)
prompt või prompt-fileJuhend reasiseses vormingus või fail hoidlas – kas üks või teine, mitte mõlemad
sandboxread-only, workspace-write või danger-full-access: vali kitsaim ulatus, mis piisab
model, effortMudel ja arutluskäigu intensiivsus; kui tühjad, kehtivad vaikimisi väärtused
output-fileSalvestab Codexi lõpliku sõnumi järgnevate sammude jaoks
codex-argsTäiendavad valikud käsule codex exec
safety-strategyVaikimisi drop-sudo, mis eemaldab sudo enne käivitamist ja kaitseb saladusi mälus

Tegevus jookseb Linuxi või macOS-i käivitajatel (Windowsis on vaja safety-strategy: unsafe) pärast koodi väljavõtmist käsuga actions/checkout. See ei postita iseseisvalt midagi: see väljastab Codexi viimase sõnumi väljundis final-message, mida järgmine samm saab postitada.

Automatiseeri ülevaatus iga PR-i jaoks

Allpool olev töövoog järgib ametliku näite struktuuri: esimene töö käivitab Codexi ainult lugemisõigusega režiimis ja teine, millel on PR-ide kirjutamisõigused, postitab tulemuse kommentaarina. Sinu kriteeriumid lähevad viipa (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 }}

Viip väärib rohkem tähelepanu kui ülejäänud fail: see muudab üldise ülevaatuse selliseks, mis vastab sinu prioriteetidele. Saad viia selle YAML-failist eraldi versioonitud faili, näiteks .github/codex/prompts/review.md, millele viidatakse sisendiga prompt-file. Lihtsa PR-i ülevaatuse jaoks väldib GitHubi sisseehitatud automaatne ülevaatus (11. õppetund) töövoogu kirjutamast üldse.

Täida puuduvad testid

Teine töövoog tegeleb koodiga, mis on edastatud ilma testideta. Siin peab Codex töötamisruumi kirjutama (sandbox: workspace-write), kuid tulemus jääb ettepanekuks: töövoog muudab selle allalaaditavaks paigaks, mille arendaja vaatab üle ja rakendab ise.

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

Arendaja säilitab kontrolli algusest lõpuni: ta laeb paiga alla, kohandab seda või lükkab tagasi. Tegevuse dokumentatsioon soovitab käivitada Codexi töös viimasena, et järgnevad sammud ei päriks ootamatuid muudatusi – siin loeb järgmine samm lihtsalt diffi.

Reageeri CI ebaõnnestumisele

Kolmas töövoog seostub teise töövoogu tulemusega. Kui CI ebaõnnestub, taasesitab Codex testid asjakohasel committ’il, selgitab välja põhjuse ja koostab diagnoosi ilma midagi push’imata:

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

See nõuab suurimat ettevaatust. Ebaõnnestunud test võib viidata disainiveale ja usutav automaatne parandus võib selle ekraanilt kaduma panna, lahendamata probleemi tegelikult: CI muutub taas roheliseks, kuid probleem püsib. Seetõttu valitakse ülevaatamiseks diagnoos, mitte automaatselt pushitud commit.

Kutsu Codexi oma skriptidest

Väljaspool GitHub Actions sobib codex exec igasse skripti. Vaikimisi jookseb see ainult lugemisõigusega liivakastis; anna sellele kirjutamisõigus lipuga --sandbox workspace-write, kui ülesanne seda nõuab. Allpool olev eel-commit konks tuvastab TypeScripti failid ilma testideta ja genereerib need kohapeal:

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

CI-s kasutab codex exec vaikimisi salvestatud autentimist; selle asemel sisenda mandaadid sõnaselgelt, kasutades spetsiaalset API võtit.

Kaardista integratsioonipunktid

Kui need ehitusplokid on paigas, mõtle tarne tsükli sündmuste, mitte YAML-failide kaupa. Allpool olevad viis stsenaariumi katavad levinumad juhtumid:

CI/CD etappCodexi ülesanneKäiviti
PR avatudAutomaatne ülevaatuspull_request opened
PR avatudTestide genereeriminepull_request opened
CI ebaõnnestumineAnalüüs ja parandusworkflow_run failure
VäljalaseAutomaatne muutuste logitag push
Sõltuvuse uuendusÜhilduvuse kontrollDependabot PR

Säilita kontroll automatiseerimise üle

CI/CD integratsioon jookseb järelevalveta, mis nõuab mõningaid põhilisi ettevaatusabinõusid. Piira, kes saab töövooge käivitada – vaikimisi saavad seda teha ainult kasutajad, kellel on kirjutamisõigused (kasuta allow-users, allow-bots, et seda sõnaselgelt laiendada). Puhasta sisendit PR-dest, commit-sõnumitest või probleemidest enne, kui annad selle Codexile: peidetud tekst võib sisaldada viiba süstimist (prompt injection). Kasuta API võtit, millel on minimaalsed õigused, mitte arendaja isiklikku võtit, mida ta ettevõttest lahkudes kaasa võtab ja sinu torustikud katki teeb. Ära kunagi liida automaatselt Codexi loodud parandust: inimlik ülevaatus jääb peaharu väravaks. Määra selged piirangud ülesannete arvule päevas ja maksimaalsele kulule, et valesti seadistatud parandustsükkel ei põletaks läbi sinu kuueelarvet ühe ööga. Lõpuks hoia alles ajalugu CI-s tehtud Codexi ülesannetest: päeval, mil tootmises ilmneb ootamatu käitumine, on need logid sinu ainus kindel juhend.

Peamised punktid

  • Codex integreerub GitHub Actionsi ja teiste CI/CD süsteemidega
  • Automaatne ülevaatus PR-ide jaoks on levinuim kasutusjuhtum
  • Codex suudab parandada CI ebaõnnestumisi automaatselt
  • CLI võimaldab integratsiooni kohandatud skriptidesse
  • Hoia alati inimene ahelas, et parandusi valideerida