> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Cloud - GitHub Copilot SDK for Laravel

> Laravel Copilot SDK를 Laravel Cloud에서 실행하기 위한 Copilot CLI 설치, 환경 변수, stdio/TCP 모드 운영 포인트를 설명합니다.

## Laravel Cloud에서 사용

## 설치

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

```shell theme={null}
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**에 다음을 설정합니다.

```dotenv theme={null}
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`을 설정합니다.

```dotenv theme={null}
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초까지 늘려 주세요.

<Info>
  최신 정보는 [GitHub 저장소](https://github.com/invokable/laravel-copilot-sdk)를 참고하세요.
</Info>


## Related topics

- [GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/index.md)
- [GitHub Actions - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/github-actions.md)
- [인증 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/auth.md)
- [테스트 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/fake.md)
- [시작하기 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/getting-started.md)