Laravel Cloud CLI — 터미널에서 Laravel Cloud 조작하기

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

​

Laravel Cloud CLI란

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

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

​

요구사항

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

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

​

설치

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

1. 리포지토리를 취득하고 의존관계를 설치

   gh repo clone laravel/cloud-cli
   cd cloud-cli
   composer install
   
2. `cloud` 별칭 설정

   zsh:

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
   source ~/.zshrc
   

   bash:

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
   source ~/.bashrc
   
3. 임의의 경로로 수동 설정

   alias cloud="php /path/to/cloud-cli/cloud"
   

​

인증

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

cloud auth

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

cloud auth:token

​

리포지토리 설정

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

cloud repo:config

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

​

배포

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

# 첫 회: 가이드 형식으로 앱 생성 및 배포
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 등의 조작을 일괄로 다룰 수 있습니다.

cloud environment:variables

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

​

사용량 확인

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

# 이번 달 사용량
cloud usage

# 상세 표시
cloud usage --detailed

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

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