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를 로컬에 셋업하세요.

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

gh repo clone laravel/cloud-cli
cd cloud-cli
composer install

`cloud` 별칭 설정

zsh:

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

bash:

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

임의의 경로로 수동 설정

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>를 사용해 주세요.

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

​Laravel Cloud CLI란

​요구사항

​설치

​인증

​리포지토리 설정

​배포

​주요 명령 카테고리

​환경 변수 관리

​사용량 확인