Passer au contenu principal

Utilisation avec Laravel Cloud

Installation

Dans Settings > Deployments > Build commands, ajoutez ce qui suit puis déployez.
export PATH="$PATH:/var/www/.local/bin"
curl -fsSL https://gh.io/copilot-install | bash
/var/www/.local/bin/copilot --version
Le chemin du CLI étant /var/www/.local/bin/copilot, définissez dans Custom environment variables :
COPILOT_CLI_PATH=/var/www/.local/bin/copilot
COPILOT_GITHUB_TOKEN=
Pour COPILOT_GITHUB_TOKEN, vous pouvez utiliser toute méthode d’authentification prise en charge par le Copilot CLI (GH_TOKEN, GITHUB_TOKEN, etc.). Pour le mode stdio par défaut, cette installation suffit.

Exploitation en mode TCP

Dans App cluster > Background processes > Custom worker, définissez /var/www/.local/bin/copilot --headless --port 12345. Il s’exécute en continu comme processus d’arrière-plan et redémarre automatiquement lors des déploiements. Le numéro de port est libre. Dans Custom environment variables, définissez COPILOT_URL.
COPILOT_URL=tcp://127.0.0.1:12345
# COPILOT_CLI_PATH n'est pas nécessaire en mode TCP. Si les deux sont définies, le mode TCP prend le dessus.
Comme le processus tourne en permanence, la consommation mémoire est élevée ; un serveur avec au moins 2 Gio de RAM peut être nécessaire. En utilisation dans une requête HTTP, l’exécution risque de dépasser 60 secondes et d’échouer ; utilisez plutôt une file d’attente. Sur Laravel Cloud, le mode TCP est peu praticable ; le mode stdio est recommandé. Le Worker cluster (plan supérieur) est également possible, utile pour éviter les problèmes mémoire de l’App cluster.

Points d’attention

  • Les serveurs bon marché manquent facilement de mémoire.
  • Le timeout HTTP par défaut est de 20 secondes. En cas d’échecs fréquents, portez-le jusqu’à 60 secondes.
Pour les dernières informations, consultez le dépôt GitHub.
Dernière modification le 13 juillet 2026