CLI 명령어
SCF에서 사용할 수 있는 모든 명령어입니다.
명령어 목록
scf init
새 SCF 프로젝트를 초기화합니다.
bash
npx scf-deploy init [옵션]옵션:
-f, --force- 기존 설정 파일 덮어쓰기-y, --yes- 질문 없이 기본값으로 설정
예제:
bash
# 대화형으로 초기화
npx scf-deploy init
# 기본값으로 바로 초기화
npx scf-deploy init --yes
# 기존 설정 파일 덮어쓰기
npx scf-deploy init --forcescf deploy
정적 사이트를 AWS에 배포합니다.
bash
npx scf-deploy deploy [옵션]옵션:
-e, --env <환경>- 배포 환경 (dev, staging, prod 등)-c, --config <경로>- 설정 파일 경로 (기본값:scf.config.ts)-p, --profile <프로필>- AWS 프로필 이름--dry-run- 실제 배포 없이 미리보기만--no-cloudfront- CloudFront 배포 건너뛰기--force- 전체 파일 강제 재배포--skip-cache- CloudFront 캐시 갱신 건너뛰기--skip-build- 빌드 과정 건너뛰기
예제:
bash
# 기본 배포
npx scf-deploy deploy
# 운영 환경에 배포
npx scf-deploy deploy --env prod
# 특정 AWS 프로필 사용
npx scf-deploy deploy --profile my-aws-profile
# 다른 설정 파일 사용
npx scf-deploy deploy --config custom.config.ts
# 미리보기만 (실제 배포 안 함)
npx scf-deploy deploy --dry-run
# S3만 배포 (CloudFront 제외)
npx scf-deploy deploy --no-cloudfront
# 전체 파일 강제 재배포
npx scf-deploy deploy --force
# 캐시 갱신 없이 배포
npx scf-deploy deploy --skip-cache
# 빌드 건너뛰고 배포
npx scf-deploy deploy --skip-buildscf remove
배포된 AWS 리소스를 삭제합니다.
bash
npx scf-deploy remove [옵션]옵션:
-e, --env <환경>- 삭제할 환경-c, --config <경로>- 설정 파일 경로-p, --profile <프로필>- AWS 프로필 이름-f, --force- 확인 없이 바로 삭제--keep-bucket- S3 버킷은 유지 (파일만 삭제)--keep-distribution- CloudFront 배포 유지--keep-certificate- ACM 인증서 유지--keep-hosted-zone- Route53 호스팅 영역 유지
예제:
bash
# 리소스 삭제 (확인 후)
npx scf-deploy remove
# 특정 환경만 삭제
npx scf-deploy remove --env dev
# 확인 없이 바로 삭제
npx scf-deploy remove --force
# S3 버킷은 남기고 파일만 삭제
npx scf-deploy remove --keep-bucket
# CloudFront는 유지
npx scf-deploy remove --keep-distribution
# 여러 리소스 유지
npx scf-deploy remove --keep-bucket --keep-distribution --keep-certificatescf status
현재 배포 상태를 확인합니다.
bash
npx scf-deploy status [옵션]옵션:
-e, --env <환경>- 확인할 환경-d, --detailed- 상세 정보 표시--json- JSON 형식으로 출력
예제:
bash
# 배포 상태 확인
npx scf-deploy status
# 특정 환경 상태 확인
npx scf-deploy status --env prod
# 상세 정보 보기
npx scf-deploy status --detailed
# JSON으로 출력 (CI/CD 연동용)
npx scf-deploy status --jsonscf recover
상태 파일을 복구합니다. AWS에서 배포된 리소스를 찾아 로컬 상태 파일을 다시 생성합니다.
bash
npx scf-deploy recover [옵션]옵션:
-e, --env <환경>- 복구할 환경-c, --config <경로>- 설정 파일 경로-p, --profile <프로필>- AWS 프로필 이름-f, --force- 기존 상태 파일 덮어쓰기-a, --all- SCF로 관리 중인 모든 리소스 표시
예제:
bash
# 상태 파일 복구
npx scf-deploy recover
# 특정 환경 복구
npx scf-deploy recover --env prod
# 기존 상태 파일 덮어쓰기
npx scf-deploy recover --force
# 모든 SCF 관리 리소스 검색
npx scf-deploy recover --all공통 옵션
모든 명령어에서 사용 가능:
--help- 도움말 보기--version- 버전 확인
환경 변수
SCF에서 사용하는 환경 변수:
| 변수 | 설명 |
|---|---|
AWS_ACCESS_KEY_ID | AWS 액세스 키 |
AWS_SECRET_ACCESS_KEY | AWS 시크릿 키 |
AWS_SESSION_TOKEN | 임시 자격 증명용 세션 토큰 |
AWS_PROFILE | AWS 프로필 이름 |
AWS_REGION | AWS 리전 |