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 --force

scf 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-build

scf 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-certificate

scf 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 --json

scf 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_IDAWS 액세스 키
AWS_SECRET_ACCESS_KEYAWS 시크릿 키
AWS_SESSION_TOKEN임시 자격 증명용 세션 토큰
AWS_PROFILEAWS 프로필 이름
AWS_REGIONAWS 리전

다음으로 볼 문서

5 min read최종 업데이트: 2025-11-25