Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Integrācija CI/CD

Nodarbība 14 no 20 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Codex tavā piegādes cauruļvadā
  2. Oficiālā GitHub darbība
  3. Automatizē apskati katram PR
  4. Aizpildi trūkstošos testus
  5. Reaģē uz CI kļūmi
  6. Izsauc Codex no saviem skriptiem
  7. Kartē integrācijas punktus
  8. Saglabā kontroli pār automatizāciju
  9. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz Codex GitHub Action un Neinteraktīvais režīms lapām Codex dokumentācijā: mantotie ievades parametri task, criteria, scope, framework un api-key nepastāv versijā openai/codex-action@v1 (tos aizstāj openai-api-key, prompt/prompt-file, sandbox, output-file u.c.). Darbība pati par sevi nepublicē komentārus. Izteiksme == failure bez pēdiņām nedarbojās. Karogs --apply ir aizstāts ar codex exec --sandbox workspace-write. Avoti: Codex GitHub Action · Neinteraktīvais režīms.

Codex tavā piegādes cauruļvadā

Codex neaprobežojas tikai ar uzdevumiem, ko izstrādātājs uzsāk manuāli. Tas integrējas tavos CI/CD cauruļvados, lai automatizētu izstrādes uzdevumus katrā piegādes cikla posmā. Šī pārmaiņa ir vairāk nekā laika ietaupījums: koda apskate, testu ģenerēšana un kļūdu labošana vairs nav atkarīgas no individuālas disciplīnas, bet kļūst par cauruļvada soļiem, ko aktivizē notikumi, nevis piektdienas pēcpusdienas labā griba.

Oficiālā GitHub darbība

OpenAI publicē darbību openai/codex-action@v1, kas instalē CLI, startē Responses API starpniekserveri, kad norādi atslēgu, un palaiž codex exec ar tavām noteiktajām atļaujām. Tās galvenie ievades parametri:

IevadeLoma
openai-api-keyAtslēga, kas glabāta kā GitHub noslēpums (piemēram, OPENAI_API_KEY)
prompt vai prompt-fileInstrukcija tieši tekstā vai fails repozitorijā – viens vai otrs, ne abi
sandboxread-only, workspace-write vai danger-full-access: izvēlies šaurāko pietiekamo darbības jomu
model, effortModelis un spriešanas intensitāte; ja tukšs, tiek piemērotas noklusējuma vērtības
output-fileSaglabā Codex beigu ziņojumu nākamajiem soļiem
codex-argsPapildu opcijas priekš codex exec
safety-strategyNoklusējums ir drop-sudo, kas noņem sudo pirms izpildes un aizsargā noslēpumus atmiņā

Darbība darbojas Linux vai macOS izpildītājos (Windows gadījumā nepieciešams safety-strategy: unsafe) pēc koda izgūšanas ar actions/checkout. Tā neko nepublicē pati: tā dara pieejamu Codex pēdējo ziņojumu izvades parametrā final-message, ko var publicēt nākamais solis.

Automatizē apskati katram PR

Tālāk redzamā darbplūsma seko oficiālā piemēra struktūrai: pirmais uzdevums palaiž Codex lasīšanas režīmā, bet otrais, kam ir rakstīšanas atļaujas PR, publicē rezultātu kā komentāru. Tavi kritēriji nonāk 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 }}

Promptam jāveltī vairāk uzmanības nekā pārējam failam: tas pārvērš vispārīgu apskati tādā, kas atbilst tavām prioritātēm. Tu vari pārvietot to no YAML uz versijētu failu, piemēram, .github/codex/prompts/review.md, uz kuru norāda ar prompt-file. Vienkāršai PR apskatei automātiskā apskate, kas iebūvēta GitHub (11. nodarbība), ļauj izvairīties no darbplūsmas rakstīšanas vispār.

Aizpildi trūkstošos testus

Otra darbplūsma risina situāciju, kad kods tiek piegādāts bez testiem. Šeit Codex ir jāraksta darbvietā (sandbox: workspace-write), taču rezultāts paliek tikai kā priekšlikums: darbplūsma to pārvērš lejupielādējamā plāksterī, ko izstrādātājs pats apskata un piemēro.

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

Izstrādātājs saglabā kontroli no sākuma līdz beigām: viņš iegūst plāksteri, pielāgo to vai noraida. Darbības dokumentācija iesaka palaist Codex kā pēdējo soli uzdevumā, lai nākamie soļi nemantotu negaidītas izmaiņas – šeit vienīgais nākamais solis tikai nolasa atšķirības.

Reaģē uz CI kļūmi

Trešā darbplūsma pieslēdzas cita cauruļvada rezultātam. Kad CI neizdodas, Codex atkārto testus attiecīgajā commit, noskaidro cēloni un sagatavo diagnozi, neko nepushojot:

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

Šis gadījums prasa vislielāko piesardzību. Neizdevies tests dažkārt signalizē par dizaina kļūdu, un ticams automātisks labojums var to pazudināt no ekrāna, neatrisinot problēmu: CI atkal kļūst zaļš, bet problēma paliek. Tāpēc tiek izvēlēta apskatāma diagnoze, nevis automātiski pushots commit.

Izsauc Codex no saviem skriptiem

Āpus GitHub Actions, codex exec iederas jebkurā skriptā. Pēc noklusējuma tas darbojas lasīšanas režīma smilškastē; piešķir tam rakstīšanas atļauju ar --sandbox workspace-write, kad uzdevums to prasa. Tālāk redzamais pre-commit āķis atzīmē TypeScript failus bez testiem un ģenerē vienu uz vietas:

#!/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 vidē codex exec pēc noklusējuma atkārtoti izmanto saglabātu autentifikāciju; tā vietā norādi akreditācijas datus tieši, izmantojot īpašu API atslēgu.

Kartē integrācijas punktus

Kad šie būvbloki ir vietā, domā piegādes cikla notikumu, nevis YAML failu kategorijās. Pieci tālāk minētie scenāriji aptver visbiežāk sastopamos gadījumus:

CI/CD posmsCodex uzdevumsAktivators
PR atvērtsAutomātiska apskatepull_request opened
PR atvērtsTestu ģenerēšanapull_request opened
CI kļūmeAnalīze un labojumsworkflow_run failure
LaidiensAutomātisks izmaiņu žurnālstag push
Atkarību atjaunināšanaSaderības pārbaudeDependabot PR

Saglabā kontroli pār automatizāciju

CI/CD integrācija darbojas bez uzraudzības, kas prasa dažus pamata piesardzības pasākumus. Ierobežo, kas var aktivizēt darbplūsmas – pēc noklusējuma tikai lietotāji ar rakstīšanas atļaujām var palaist darbību (izmanto allow-users, allow-bots, lai to tieši paplašinātu). Attīri ievades datus no PR, commit ziņojumiem vai problēmām, pirms nodod tos Codex: slēpts teksts var saturēt prompta injekciju. Izmanto API atslēgu ar minimālām atļaujām, nevis izstrādātāja personīgo atslēgu, ko viņš paņems līdzi, aizejot no uzņēmuma, un tādējādi salauzs tavus cauruļvadus. Nekad automātiski neveic merge ar Codex radītu labojumu: cilvēka apskate paliek vārti uz galveno zaru. Noteic skaidrus limitus uzdevumu skaitam dienā un maksimālajām izmaksām, lai nepareizi konfigurēta korekcijas cilpa vienā naktī nesadedzinātu tavu mēneša budžetu. Visbeidzot, glabā vēsturi par CI izpildītajiem Codex uzdevumiem: dienā, kad ražošanā parādās negaidīta uzvedība, šie žurnāli būs tavs vienīgais stabils pavediens.

Galvenās atziņas

  • Codex integrējas GitHub Actions un citās CI/CD sistēmās
  • Automātiska apskate PR ir visizplatītākais lietojuma gadījums
  • Codex var automātiski labot CI kļūmes
  • CLI ļauj integrāciju pielāgotos skriptos
  • Vienmēr paturi cilvēku ciklā, lai validētu labojumus