Automatisation et CI/CD de Codex
Codex propose plusieurs méthodes d'automatisation qui peuvent être utilisées dans des scripts, des pipelines et côté serveur.
Mode non interactif (exec)
La commande exec est utilisée pour les scénarios de script et d'automatisation, sans avoir besoin d'ouvrir la TUI.
Utilisation de base
commande exec
codex exec "Examiner le code et produire un rapport"
# Sortie vers un fichier
codex exec -o review.md "Examiner src/auth.py"
# Utiliser un modèle spécifique
codex exec -m gpt-5.4-mini "Analyser la structure du projet"
# Exécution entièrement automatique
codex exec --full-auto "Exécuter les tests et corriger les échecs"
Paramètres communs
| Paramètre | Description |
|---|---|
-m | Spécifier le modèle |
-o | Écrire le résultat dans un fichier |
--full-auto | Exécution entièrement automatique |
--ephemeral | Ne pas enregistrer les fichiers de session |
--json | Format de sortie JSON Lines |
--output-schema | Sortie selon le format JSON Schema |
--sandbox | Définir le mode bac à sable |
Lire depuis l'entrée standard
Entrée stdin
echo "Explique cette erreur" | codex exec -
# Lire depuis un fichier
codex exec - < task.txt
# Tâche multiligne
cat <<EOF | codex exec -
Analyser le répertoire/src
Trouver des bogues potentiels
Afficher des suggestions de correction
EOF
Reprendre la session
Reprendre l'exécution
codex exec resume --last "Continuer à corriger les bogues"
# Reprendre une session spécifiée
codex exec resume --session abc123 "Tâche suivante"
Par défaut, exec s'exécute dans un bac à sable en lecture seule et ne modifie pas les fichiers.
SDK Codex
Le SDK Codex fournit une interface de programmation pour invoquer les capacités d'Agent dans le code.
Installer le SDK
Installer le SDK
Exemples d’utilisation
Utilisation de base du SDK
// Créer Codex
const codex = new Codex({
apiKey: process.env.OPENAI_API_KEY
});
// Exécuter la tâche
const thread = await codex.run({
prompt: 'Examiner le fichier src/auth.py',
model: 'gpt-5.4'
});
// Obtenir le résultat
console.log(thread.messages);
// Continuer la tâche
const followUp = await codex.run({
threadId: thread.id,
prompt: 'Fix the discovered bugs'
});
Scénarios d'application du SDK
- Intégrer dans les pipelines CI/CD
- Créer des applications Agent personnalisées
- Automatiser les outils internes
- Tâches de traitement par lots
GitHub Action
L'action GitHub officielle Codex permet de déclencher des tâches dans les pipelines CI.
Workflow de base
Exemple d'action GitHub
name: Revue Codex
on: [pull_request]
jobs:
codex-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Exécuter la revue Codex
uses: openai/codex-action@v1
with:
prompt-file: '.github/codex-review.md'
model: 'gpt-5.4'
sandbox: 'workspace-write'
output-file: 'review.md'
- name: Publier la revue
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const review = fs.readFileSync('review.md', 'utf8');
github.rest.pulls.createReview({
owner: context.repo.owner,
repo: context.repo.repo,
pull_number: context.repo.repo,
body: review,
event: 'COMMENT'
});
Paramètres de l'action
| Parameters | Description |
|---|---|
prompt | Spécifier directement la description de la tâche |
prompt-file | Spécifier le chemin du fichier de tâche |
model | Modèle utilisé |
sandbox | Mode bac à sable |
output-file | Chemin du fichier de sortie |
codex-args | Paramètres CLI supplémentaires |
Configuration de sécurité
Paramètres de sécurité
- name: Exécuter Codex
uses: openai/codex-action@v1
with:
prompt: 'Examiner les modifications'
safety-strategy: 'drop-sudo'
unprivileged-user: 'codex-runner'
allow-users: ['maintainers']
Lors de l'utilisation de GitHub Action, assurez-vous que la clé API est stockée en tant que Secrets, ne la codez pas en dur.
Serveur d'application
Le serveur d'application expose les capacités de Codex sous forme d'API côté serveur.
Démarrer le serveur d'application
Démarrer le service
codex app-server
# Spécifier le port
codex app-server --port 3000
# Accès distant
codex --remote ws://server:3000
Scénarios applicables
- Partage en équipe des capacités de Codex
- Invocation CI/CD à distance
- Intégration dans des plateformes internes
Serveur MCP
Fournir Codex en tant qu'outil MCP que d'autres Agents peuvent appeler.
Configurer Codex MCP
Configuration du serveur MCP
[mcp_servers.codex]
command = "codex"
args = ["mcp-server"]
Bonnes pratiques
Sécurité
- Utiliser le mode sandbox en lecture seule
- Stocker la clé API en tant que Secrets
- Limiter les conditions de déclenchement (uniquement des événements spécifiques)
- Vérifier la sortie avant d’appliquer les modifications
Fiabilité
- Définir un délai d’attente raisonnable
- Utiliser --ephemeral pour éviter les résidus d’état
- Vérifier la réussite de la tâche avant de continuer
- Gérer le rollback en cas d’échec
Questions fréquentes
Q : Quelle est la différence entre le mode exec et le mode interactif ?
exec se termine après une seule exécution, adapté à l’automatisation ; le mode interactif poursuit la conversation.
Q : Comment s’authentifier dans CI/CD ?
Utiliser la variable d’environnement CODEX_API_KEY, stockée dans les Secrets.
Q : GitHub Action peut-il modifier des fichiers ?
Oui, définissez sandbox: workspace-write.
Q : Comment l'utiliser dans Docker ?
Installez Codex dans l'image, configurez l'authentification, puis appelez-le.
Autres extensions