Ολοκλήρωση CI/CD
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026 με βάση τις σελίδες Codex GitHub Action και Non-interactive mode της τεκμηρίωσης του Codex: οι παλιές είσοδοι
task,criteria,scope,frameworkκαιapi-keyδεν υπάρχουν στοopenai/codex-action@v1(αντικαταστάθηκαν απόopenai-api-key,prompt/prompt-file,sandbox,output-fileκ.λπ.). Η ενέργεια δεν δημοσιεύει σχόλια από μόνη της. Η έκφραση== failureχωρίς εισαγωγικά δεν λειτουργούσε. Η σημαία--applyαντικαταστάθηκε απόcodex exec --sandbox workspace-write. Πηγές: Codex GitHub Action · Non-interactive mode.
Το Codex στον Αγωγό Παράδοσής Σας
Το Codex δεν περιορίζεται σε εργασίες που ξεκινά χειροκίνητα ένας προγραμματιστής. Ενσωματώνεται στους αγωγούς CI/CD σας για να αυτοματοποιεί εργασίες ανάπτυξης σε κάθε στάδιο του κύκλου παράδοσης. Αυτή η αλλαγή ξεπερνά την εξοικονόμηση χρόνου: η αναθεώρηση κώδικα, η δημιουργία δοκιμών και οι διορθώσεις σφαλμάτων παύουν να εξαρτώνται από την ατομική πειθαρχία και γίνονται βήματα του αγωγού που ενεργοποιούνται από γεγονότα, όχι από την καλή διάθεση της Παρασκευής το απόγευμα.
Η Επίσημη Ενέργεια GitHub
Η OpenAI δημοσιεύει μια ενέργεια, την openai/codex-action@v1, η οποία εγκαθιστά το CLI, ξεκινά τον διακομιστή μεσολάβησης (proxy) του Responses API όταν παρέχετε ένα κλειδί και εκτελεί το codex exec με τις άδειες που ορίζετε. Οι κύριες είσοδοί της είναι:
| Είσοδος | Ρόλος |
|---|---|
openai-api-key | Το κλειδί, αποθηκευμένο ως μυστικό GitHub (για παράδειγμα OPENAI_API_KEY) |
prompt ή prompt-file | Η οδηγία ενσωματωμένη ή ένα αρχείο στο αποθετήριο—το ένα ή το άλλο, όχι και τα δύο |
sandbox | read-only, workspace-write ή danger-full-access: επιλέξτε το στενότερο εύρος που αρκεί |
model, effort | Το μοντέλο και η προσπάθεια συλλογισμού· αν είναι κενά, ισχύουν οι προεπιλεγμένες τιμές |
output-file | Αποθηκεύει το τελικό μήνυμα του Codex για τα επόμενα βήματα |
codex-args | Πρόσθετες επιλογές για το codex exec |
safety-strategy | Προεπιλογή drop-sudo, η οποία αφαιρεί το sudo πριν την εκτέλεση και προστατεύει τα μυστικά στη μνήμη |
Η ενέργεια εκτελείται σε runners Linux ή macOS (στα Windows, χρειάζεστε safety-strategy: unsafe) μετά από ένα actions/checkout του κώδικα. Δεν δημοσιεύει τίποτα από μόνη της: εκθέτει το τελευταίο μήνυμα του Codex στην έξοδο final-message, την οποία μπορεί να δημοσιεύσει ένα επόμενο βήμα.
Αυτοματοποίηση Αναθεώρησης για Κάθε PR
Η ροή εργασίας παρακάτω ακολουθεί τη δομή του επίσημου παραδείγματος: μια πρώτη εργασία εκτελεί το Codex σε λειτουργία μόνο ανάγνωσης, και μια δεύτερη, με δικαιώματα εγγραφής στα PR, δημοσιεύει το αποτέλεσμα ως σχόλιο. Τα κριτήριά σας μπαίνουν στην προτροπή (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 }}
Η προτροπή αξίζει περισσότερη προσοχή από το υπόλοιπο αρχείο: μετατρέπει μια γενική αναθεώρηση σε μία που ταιριάζει στις προτεραιότητές σας. Μπορείτε να τη μετακινήσετε έξω από το YAML σε ένα αρχείο με έλεγχο εκδόσεων, για παράδειγμα .github/codex/prompts/review.md, το οποίο αναφέρεται μέσω του prompt-file. Για μια απλή αναθεώρηση PR, η αυτόματη αναθεώρηση που είναι ενσωματωμένη στο GitHub (Μάθημα 11) αποφεύγει τη συγγραφή μιας ροής εργασίας altogether.
Συμπλήρωση Ελλειπουσών Δοκιμών
Μια δεύτερη ροή εργασίας αντιμετωπίζει κώδικα που παραδίδεται χωρίς δοκιμές. Εδώ το Codex χρειάζεται να γράψει στον χώρο εργασίας (sandbox: workspace-write), αλλά το αποτέλεσμα παραμένει μια πρόταση: η ροή εργασίας το μετατρέπει σε ένα patch προς λήψη, το οποίο ο προγραμματιστής αναθεωρεί και εφαρμόζει ο ίδιος.
# .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
Ο προγραμματιστής διατηρεί τον έλεγχο από άκρη σε άκρη: λαμβάνει το patch, το προσαρμόζει ή το απορρίπτει. Η τεκμηρίωση της ενέργειας συνιστά την εκτέλεση του Codex τελευταίο σε μια εργασία, ώστε τα επόμενα βήματα να μην κληρονομήσουν απροσδόκητες αλλαγές—εδώ, το μόνο επόμενο βήμα απλώς διαβάζει τη διαφορά (diff).
Αντίδραση σε Αποτυχία CI
Η τρίτη ροή εργασίας συνδέεται με το αποτέλεσμα μιας άλλης ροής εργασίας. Όταν το CI αποτύχει, το Codex επαναλαμβάνει τις δοκιμές στο σχετικό commit, εντοπίζει την αιτία και παράγει μια διάγνωση χωρίς να ωθήσει τίποτα:
# .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
Αυτή απαιτεί τη μεγαλύτερη προσοχή. Μια αποτυχημένη δοκιμή μερικές φορές σηματοδοτεί ένα ελάττωμα σχεδιασμού και μια πιθανή αυτόματη διόρθωση μπορεί να την κάνει να εξαφανιστεί από την οθόνη χωρίς να λύνει το πρόβλημα: το CI ξαναγίνεται πράσινο, αλλά το πρόβλημα παραμένει. Εξ ου και η επιλογή μιας διάγνωσης προς αναθεώρηση αντί για ένα αυτόματα ωθούμενο commit.
Κλήση του Codex από Τα Δικά Σας Σενάρια
Εκτός από τις Ενέργειες GitHub, το codex exec ταιριάζει σε οποιοδήποτε σενάριο. Από προεπιλογή, εκτελείται σε ένα sandbox μόνο ανάγνωσης· δώστε του άδεια εγγραφής με --sandbox workspace-write όταν η εργασία το απαιτεί. Το παρακάτω hook pre-commit επισημαίνει αρχεία TypeScript χωρίς δοκιμές και δημιουργεί μία επιτόπου:
#!/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, το codex exec επαναχρησιμοποιεί από προεπιλογή την αποθηκευμένη πιστοποίηση· αντίθετα, παρέχετε τα διαπιστευτήρια ρητά χρησιμοποιώντας ένα αφιερωμένο κλειδί API.
Χαρτογράφηση Σημείων Ολοκλήρωσης
Μόλις αυτά τα δομικά στοιχεία είναι στη θέση τους, σκεφτείτε με όρους γεγονότων του κύκλου παράδοσης και όχι αρχείων YAML. Τα πέντε σενάρια παρακάτω καλύπτουν τις πιο κοινές περιπτώσεις:
| Στάδιο CI/CD | Εργασία Codex | Ενεργοποιητής |
|---|---|---|
| Άνοιγμα PR | Αυτόματη αναθεώρηση | pull_request opened |
| Άνοιγμα PR | Δημιουργία δοκιμών | pull_request opened |
| Αποτυχία CI | Ανάλυση και διόρθωση | workflow_run failure |
| Έκδοση | Αυτόματο changelog | tag push |
| Ενημέρωση εξάρτησης | Έλεγχος συμβατότητας | Dependabot PR |
Διατήρηση του Ελέγχου της Αυτοματοποίησης
Μια ολοκλήρωση CI/CD εκτελείται χωρίς επιτήρηση, γεγονός που απαιτεί ορισμένες βασικές προφυλάξεις. Περιορίστε το ποιος μπορεί να ενεργοποιεί ροές εργασίας—από προεπιλογή, μόνο χρήστες με δικαιώματα εγγραφής μπορούν να εκτελέσουν την ενέργεια (χρησιμοποιήστε τα allow-users, allow-bots για να επεκτείνετε ρητά αυτό). Καθαρίστε την είσοδο από PRs, μηνύματα commit ή ζητήματα πριν την παραδώσετε στο Codex: κρυφό κείμενο μπορεί να περιέχει έγχυση προτροπής (prompt injection). Χρησιμοποιήστε ένα κλειδί API αφιερωμένο με ελάχιστες άδειες αντί για το προσωπικό κλειδί ενός προγραμματιστή, το οποίο θα πάρει μαζί του όταν φύγει από την εταιρεία, σπάζοντας τους αγωγούς σας. Ποτέ μην συγχωνεύετε αυτόματα μια διόρθωση που παρήγαγε το Codex: η ανθρώπινη αναθεώρηση παραμένει η πύλη προς τον κύριο κλάδο. Ορίστε ρητά όρια στον αριθμό των εργασιών ανά ημέρα και στο μέγιστο κόστος, ώστε ένας λανθασμένα διαμορφωμένος βρόχος διόρθωσης να μην κάψει τον μηνιαίο προϋπολογισμό σας μέσα σε μια νύχτα. Τέλος, κρατήστε ένα ιστορικό των εργασιών Codex που εκτελούνται στο CI: την ημέρα που εμφανίζεται μια απροσδόκητη συμπεριφορά στην παραγωγή, αυτά τα αρχεία καταγραφής θα είναι η μόνη σας σταθερή ένδειξη.
Βασικά σημεία
- Το Codex ενσωματώνεται σε Ενέργειες GitHub και άλλα συστήματα CI/CD
- Η αυτόματη αναθεώρηση στα PRs είναι η πιο κοινή περίπτωση χρήσης
- Το Codex μπορεί να διορθώσει αυτόματα αποτυχίες CI
- Το CLI επιτρέπει την ενσωμάτωση σε προσαρμοσμένα σενάρια
- Διατηρείτε πάντα έναν άνθρωπο στον βρόχο για την επικύρωση των διορθώσεων