> ## 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 CLI — 터미널에서 Laravel Cloud 조작하기

> laravel/cloud-cli를 사용하여 터미널에서 Laravel Cloud의 앱 · 환경 · 데이터베이스 · 도메인 등을 관리하는 방법.

## Laravel Cloud CLI란

`laravel/cloud-cli`는 [Laravel Cloud](https://cloud.laravel.com)를 터미널에서 조작하기 위한 CLI입니다.\
이 도구는 Laravel Zero로 만들어져 있으며, 대시보드에서 하는 조작을 `cloud` 명령으로 실행할 수 있습니다.

여러분은 이 CLI로 애플리케이션, 환경, 데이터베이스, 캐시, 버킷, 도메인, WebSocket 등을 일원 관리하실 수 있습니다.

## 요구사항

도입 전에 다음 요구사항을 만족하세요.

* `PHP 8.2+`
* `Composer`
* `GitHub CLI (gh)` (설치 완료, 인증 완료)
* `Git`

## 설치

먼저 CLI를 로컬에 셋업하세요.

<Steps>
  <Step title="리포지토리를 취득하고 의존관계를 설치">
    ```bash theme={null}
    gh repo clone laravel/cloud-cli
    cd cloud-cli
    composer install
    ```
  </Step>

  <Step title="`cloud` 별칭 설정">
    zsh:

    ```bash theme={null}
    echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
    source ~/.zshrc
    ```

    bash:

    ```bash theme={null}
    echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Step>

  <Step title="임의의 경로로 수동 설정">
    ```bash theme={null}
    alias cloud="php /path/to/cloud-cli/cloud"
    ```
  </Step>
</Steps>

## 인증

많은 명령을 사용하기 전에 인증해 주세요.

```bash theme={null}
cloud auth
```

`cloud auth`는 브라우저를 열고 OAuth로 인증합니다.\
CI 용도 등에서 토큰을 관리하고 싶은 경우에는 `cloud auth:token`을 사용합니다.

```bash theme={null}
cloud auth:token
```

## 리포지토리 설정

여러분의 프로젝트에서 매번 `application`이나 `environment`를 선택하고 싶지 않은 경우에는 `cloud repo:config`를 실행하세요.

```bash theme={null}
cloud repo:config
```

이 설정에서 Git 리포지토리에 기본값이 저장되고, `cloud deploy` 등을 짧은 명령으로 실행할 수 있습니다.

## 배포

첫 배포와 지속 배포를 나누어 사용하면 효율적입니다.

```bash theme={null}
# 첫 회: 가이드 형식으로 앱 생성 및 배포
cloud ship

# 2회째 이후: 기존 앱에 배포
cloud deploy

# 대시보드 열기
cloud dashboard
```

## 주요 명령 카테고리

README의 명령 레퍼런스에서 일상적으로 사용하는 카테고리를 정리합니다.

| 카테고리          | 주요 명령 예                                                                     | 용도                    |
| ------------- | --------------------------------------------------------------------------- | --------------------- |
| Auth / Config | `cloud auth`, `cloud auth:token`, `cloud repo:config`                       | 인증과 기본 설정             |
| Application   | `cloud application:list`, `cloud application:create`                        | 앱 관리                  |
| Environment   | `cloud environment:list`, `cloud environment:get`, `cloud environment:logs` | 환경 정보 · 로그 확인         |
| Deploy        | `cloud ship`, `cloud deploy`, `cloud deploy:monitor`                        | 배포 관리                 |
| Database      | `cloud database-cluster:*`, `cloud database:*`, `cloud database-snapshot:*` | DB 클러스터 · DB · 스냅샷 관리 |
| Cache         | `cloud cache:list`, `cloud cache:create`, `cloud cache:types`               | 캐시 관리                 |
| Bucket        | `cloud bucket:*`, `cloud bucket-key:*`                                      | 오브젝트 스토리지 관리          |
| Domain        | `cloud domain:list`, `cloud domain:create`, `cloud domain:verify`           | 도메인 설정 · 검증           |
| WebSocket     | `cloud websocket-cluster:*`, `cloud websocket-application:*`                | Reverb 관련 리소스 관리      |

## 환경 변수 관리

환경 변수는 `cloud environment:variables`로 관리합니다.\
이 명령은 append / set / replace 등의 조작을 일괄로 다룰 수 있습니다.

```bash theme={null}
cloud environment:variables
```

CI나 팀 운용에서는 이 명령을 사용하여 설정 변경 절차를 통일해 주세요.

## 사용량 확인

과금이나 리소스 이용 상황은 `cloud usage`로 확인할 수 있습니다.

```bash theme={null}
# 이번 달 사용량
cloud usage

# 상세 표시
cloud usage --detailed

# 이전 기간의 사용량
cloud usage --period=previous
```

환경 단위로 좁히는 경우에는 `cloud usage --environment=<id>`를 사용해 주세요.


## Related topics

- [Homebrew로 PHP와 Composer와 Node.js 설치하기 (macOS)](/ko/blog/mac-setup.md)
- [Cloud Sessions](/ko/packages/laravel-copilot-sdk/cloud-sessions.md)
- [Laravel Prompts](/ko/prompts.md)
- [WSL로 PHP와 Composer와 Node.js 설치하기 (Windows)](/ko/blog/windows-setup.md)
- [로깅](/ko/logging.md)