Laravel Cloud - GitHub Copilot SDK for Laravel

Laravel Cloud에서 사용

설치

Settings > Deployments > Build commands에 다음을 추가하여 배포합니다.

export PATH="$PATH:/var/www/.local/bin"
curl -fsSL https://gh.io/copilot-install | bash
/var/www/.local/bin/copilot --version

CLI 경로는 /var/www/.local/bin/copilot이므로 Custom environment variables에 다음을 설정합니다.

COPILOT_CLI_PATH=/var/www/.local/bin/copilot
COPILOT_GITHUB_TOKEN=

COPILOT_GITHUB_TOKEN에는 GH_TOKEN이나 GITHUB_TOKEN 등 Copilot CLI가 지원하는 인증 방식을 사용할 수 있습니다. 기본 stdio 모드를 사용할 경우, 이 설치만으로 충분합니다.

TCP 모드로 운영

App cluster > Background processes > Custom worker에서 /var/www/.local/bin/copilot --headless --port 12345를 설정합니다. 백그라운드 프로세스로 지속 가동되며 배포 시에 자동 재시작됩니다. 포트 번호는 임의입니다. Custom environment variables에서 COPILOT_URL을 설정합니다.

COPILOT_URL=tcp://127.0.0.1:12345
# COPILOT_CLI_PATH는 TCP 모드에서는 불필요합니다. 둘 다 있는 경우 TCP 모드가 우선됩니다.

상시 가동을 위해 메모리 사용량이 크며, 2 GiB RAM 이상의 서버가 필요할 수 있습니다. HTTP 요청 내에서 사용하면 60초 이내에 끝나지 않아 실패하기 쉬우므로 큐 실행을 권장합니다. Laravel Cloud에서는 TCP 모드의 실용성이 높지 않으므로 stdio 모드를 권장합니다. 상위 플랜의 Worker cluster에서도 사용할 수 있습니다. App cluster의 메모리 부족을 피하려는 경우에 유효합니다.

주의점

저가 서버는 메모리 부족이 되기 쉽습니다.
기본 HTTP 타임아웃은 20초입니다. 실패가 많을 경우 최대 60초까지 늘려 주세요.

최신 정보는 GitHub 저장소를 참고하세요.

마지막 수정일 2026년 7월 13일

​Laravel Cloud에서 사용

​설치

​TCP 모드로 운영

​주의점

Laravel Cloud에서 사용

설치

TCP 모드로 운영

주의점