Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Comhtháthú CI/CD

Ceacht 14 as 20 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Codex i do Phíblíne Seachadta
  2. An Gníomh GitHub Oifigiúil
  3. Athbhreithniú a Uathoibriú do gach PR
  4. Líon na Tástálacha atá in Easnamh
  5. Freagairt ar Theip CI
  6. Glaoigh ar Codex ó do Chuid Scripteanna Féin
  7. Mapáil Pointí Comhtháthaithe
  8. Coinnigh Smacht ar an Uathoibriú
  9. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar na leathanaigh Codex GitHub Action agus Mód neamh-idirghníomhach i ndoiciméadú Codex: níl na hionchuir oidhreachta task, criteria, scope, framework, agus api-key le fáil in openai/codex-action@v1 (cuirtear openai-api-key, prompt/prompt-file, sandbox, output-file, srl. ina n-ionad). Ní fhoilsíonn an gníomh tráchtanna leis féin. Níor oibrigh an slonn == failure gan comharthaí athfhriotail. Cuireadh codex exec --sandbox workspace-write in ionad an bhratach --apply. Foinse: Codex GitHub Action · Mód neamh-idirghníomhach.

Codex i do Phíblíne Seachadta

Ní theoranta do thascanna a sheolann forbróir de láimh é Codex. Comhtháthaíonn sé isteach i do phíblíní CI/CD chun tascanna forbartha a uathoibriú ag gach céim den timthriall seachadta. Téann an t-aistriú seo thar shábháil ama: stopann athbhreithniú cóid, giniúint tástála, agus deisiú fabhtanna ó bheith ag brath ar dhisiplin indibhidiúil agus bíonn siad ina gcéimeanna píblíne a spreagtar le himeachtaí, seachas le dea-thoil Dé hAoine.

An Gníomh GitHub Oifigiúil

Foilsíonn OpenAI gníomh darb ainm openai/codex-action@v1 a shuiteálann an CLI, a thosaíonn an seachfhreastalaí Responses API nuair a sholáthraíonn tú eochair, agus a ritheann codex exec leis na ceadanna a shocraíonn tú. Seo a phríomh-ionchuir:

IonchurRól
openai-api-keyAn eochair, stóráilte mar rún GitHub (m.sh. OPENAI_API_KEY)
prompt nó prompt-fileAn treoir ar líne, nó comhad sa stór – ceann amháin nó an ceann eile, ní an dá cheann
sandboxread-only, workspace-write, nó danger-full-access: roghnaigh an scóip is cúinge is leor
model, effortAn tsamhail agus an iarracht réasúnaíochta; má tá siad folamh, bain úsáid as luachanna réamhshocraithe
output-fileSábhálann teachtaireacht dheiridh Codex le haghaidh céimeanna ina dhiaidh sin
codex-argsRoghanna breise do codex exec
safety-strategyRéamhshocraithe go drop-sudo, a bhaineann sudo roimh fhorghníomhú agus a chosnaíonn rúin sa chuimhne

Ritheann an gníomh ar reathaí Linux nó macOS (ar Windows, teastaíonn safety-strategy: unsafe) tar éis actions/checkout den chód. Ní fhoilsíonn sé aon rud leis féin: nochtann sé teachtaireacht dheiridh Codex san aschur final-message, rud is féidir le céim ina dhiaidh sin a fhoilsiú.

Athbhreithniú a Uathoibriú do gach PR

Leanann an sreabhad oibre thíos struchtúr an tsampla oifigiúil: ritheann chéad phost Codex i mód inléite amháin, agus foilsíonn dara post, a bhfuil ceadanna scríofa aige ar PRanna, an toradh mar thrácht. Cuir do chritéir isteach sa leid.

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

Tuilleann an leid níos mó aire ná an chuid eile den chomhad: tiontaíonn sé athbhreithniú ginearálta ceann a oireann do do thosaíochtaí. Is féidir leat é a bhogadh amach as an YAML go comhad leaganaithe, m.sh. .github/codex/prompts/review.md, dá dtagraítear le prompt-file. Maidir le hathbhreithniú simplí PR, seachnaíonn an t-athbhreithniú uathoibríoch atá tógtha isteach in GitHub (Ceacht 11) an gá le sreabhad oibre a scríobh ar fad.

Líon na Tástálacha atá in Easnamh

Déileálann dara sreabhad oibre le cód a sheachadtar gan tástálacha. Caithfidh Codex scríobh chuig an spás oibre anseo (sandbox: workspace-write), ach fanann an toradh ina thogra: tiontaíonn an sreabhad oibre é ina phatach in-íoslódáilte a dhéanann an forbróir athbhreithniú air agus a chuireann i bhfeidhm é féin.

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

Coinníonn an forbróir smacht ó thús go deireadh: faigheann sé an patach, déanann sé oiriúnú air, nó diúltaíonn sé dó. Molann doiciméadú an ghníomha Codex a rith go déanach i bpost ionas nach n-oidhreachtóidh céimeanna ina dhiaidh sin athruithe gan choinne – anseo, ní dhéanann an chéad chéim eile ach an difreáil a léamh.

Freagairt ar Theip CI

Baineann an tríú sreabhad oibre le toradh sreabha oibre eile. Nuair a theipeann ar CI, athsheinneann Codex na tástálacha ar an tiomantas ábhartha, aimsíonn sé an chúis, agus soláthraíonn sé diagnóis gan aon rud a bhrú:

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

Éilíonn an ceann seo an chuid is mó cúraim. Uaireanta is comhartha locht dearaidh é tástáil theipthe, agus is féidir le deisiú uathoibríoch inchreidte é a dhéanamh imithe ón scáileán gan é a réiteach: casann CI glas arís, ach fanann an fhadhb ann. Sin é an fáth ar roghnaíodh diagnóis le hathbhreithniú seachas tiomantas a bhrútar go huathoibríoch.

Glaoigh ar Codex ó do Chuid Scripteanna Féin

Taobh amuigh de Ghníomhartha GitHub, oireann codex exec d’aon script. De réir réamhshocraithe, ritheann sé i ngaineamhlann inléite amháin; tabhair cead scríofa dó le --sandbox workspace-write nuair a éilíonn an tasc é. Bratachaíonn an hook réamh-thiomanta thíos comhaid TypeScript gan tástálacha agus gineann sé ceann ar an eitilt:

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

I gCI, athúsáideann codex exec fíordheimhniú sábháilte de réir réamhshocraithe; ina ionad sin, soláthair dintiúir go sainráite ag baint úsáide as eochair API tiomnaithe.

Mapáil Pointí Comhtháthaithe

Nuair a bheidh na bloic thógála seo i bhfeidhm, smaoinigh i dtéarmaí imeachtaí timthrialla seachadta seachas comhaid YAML. Clúdaíonn na cúig chás thíos na cásanna is coitianta:

Céim CI/CDTasc CodexSpreagadh
PR oscailteAthbhreithniú uathoibríochpull_request opened
PR oscailteGiniúint tástálapull_request opened
Teip CIAnailís agus deisiúworkflow_run failure
ScaoileadhAthrloga uathoibríochtag push
Nuashonrú spleáchaisSeiceáil comhoiriúnachtaDependabot PR

Coinnigh Smacht ar an Uathoibriú

Ritheann comhtháthú CI/CD gan faire, rud a éilíonn roinnt réamhchúraimí bunúsacha. Teorainn a chur le cé is féidir sreabha oibre a spreagadh – de réir réamhshocraithe, ní féidir ach le húsáideoirí a bhfuil ceadanna scríofa acu an gníomh a rith (úsáid allow-users, allow-bots chun é seo a leathnú go sainráite). Glan ionchur ó PRanna, teachtaireachtaí tiomanta, nó saincheisteanna sula dtugtar do Codex é: is féidir le téacs folaithe instealladh leide a bheith ann. Úsáid eochair API atá tiomnaithe do cheadanna íosta seachas eochair phearsanta forbróra, a bheidh leo nuair a fhágfaidh siad an chuideachta, rud a bhrisfidh do phíblíní. Ná cumaisc deisiú a tháirgeann Codex go huathoibríoch riamh: fanann athbhreithniú daonna mar gheata chuig an bpríomh-chraobh. Socraigh teorainneacha sainráite ar líon na dtascanna in aghaidh an lae agus ar an gcostas uasta ionas nach ndófaidh lúb cheartúcháin míchumraithe do bhuiséad míosúil thar oíche. Ar deireadh, coinnigh stair de thascanna Codex a ritear i gCI: an lá a bheidh iompar gan choinne le feiceáil sa táirgeadh, is iad na logaí seo do phríomh-threoir.

Príomhphointí

  • Comhtháthaíonn Codex isteach i Gníomhartha GitHub agus córais CI/CD eile
  • Is é athbhreithniú uathoibríoch ar PRanna an cás úsáide is coitianta
  • Is féidir le Codex teipeanna CI a dheisiú go huathoibríoch
  • Cuireann an CLI ar chumas comhtháthú i scripteanna saincheaptha
  • Coinnigh duine sa lúb i gcónaí chun deisithe a bhailíochtú