Saltar al contenido principal

Usar en Laravel Cloud

Instalación

Añade lo siguiente en Settings > Deployments > Build commands y despliega:
export PATH="$PATH:/var/www/.local/bin"
curl -fsSL https://gh.io/copilot-install | bash
/var/www/.local/bin/copilot --version
Como la ruta del CLI queda en /var/www/.local/bin/copilot, configura lo siguiente en Custom environment variables:
COPILOT_CLI_PATH=/var/www/.local/bin/copilot
COPILOT_GITHUB_TOKEN=
En COPILOT_GITHUB_TOKEN puedes usar cualquier método de autenticación soportado por Copilot CLI: GH_TOKEN, GITHUB_TOKEN, etc. Si vas a usar el modo stdio por defecto, con esta instalación es suficiente.

Operar en modo TCP

En App cluster > Background processes > Custom worker configura /var/www/.local/bin/copilot --headless --port 12345. Corre como proceso en segundo plano de forma continua y se reinicia automáticamente en el despliegue. El número de puerto es libre. En Custom environment variables define COPILOT_URL:
COPILOT_URL=tcp://127.0.0.1:12345
# En modo TCP, COPILOT_CLI_PATH no es necesario. Si están ambos, tiene prioridad el modo TCP.
Al estar siempre en ejecución, consume mucha memoria y puede requerir un servidor con 2 GiB de RAM o más. Si lo usas dentro de una petición HTTP, es fácil que no termine en 60 segundos y falle, por lo que se recomienda ejecución vía colas. En Laravel Cloud, el modo TCP no resulta especialmente práctico, por lo que se recomienda usar el modo stdio. También puedes ejecutarlo en un Worker cluster de un plan superior. Es útil si quieres evitar la falta de memoria del App cluster.

Consideraciones

  • Los servidores más económicos tienden a quedarse sin memoria.
  • El timeout HTTP por defecto es de 20 segundos. Si ves muchos fallos, amplíalo hasta 60 segundos como máximo.
Consulta la información más reciente en el repositorio de GitHub.
Última modificación el 13 de julio de 2026