cdk watch - AWS Cloud Development Kit (AWS CDK) v2
사용량인수옵션예제

AWS CDK v2 개발자 안내서입니다. 구형 CDK v1은 2022년 6월 1일에 유지 보수에 들어갔고 2023년 6월 1일에 지원이 종료되었습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

cdk watch

로컬 AWS CDK 프로젝트를 지속적으로 관찰하여 배포 및 핫스왑을 수행하기 위한 변경 사항을 확인하십시오.

이 명령은 단일 명령을 통해 연속 배포 cdk deploy 및 핫스왑을 수행할 수 있다는 점을 제외하면 과 비슷합니다.

이 명령은 의 단축키입니다. cdk deploy --watch

cdk watch세션을 종료하려면 키를 눌러 Ctrl+C 프로세스를 중단하십시오.

관찰되는 파일은 파일의 "watch" 설정에 따라 결정됩니다. cdk.json 이 파일에는 단일 문자열 또는 문자열 배열을 허용하는 두 개의 하위 키가 있습니다. "include" "exclude" 각 항목은 cdk.json 파일 위치를 기준으로 한 경로로 해석됩니다. *와 모두 ** 허용됩니다.

cdk init명령을 사용하여 프로젝트를 만드는 경우 프로젝트 cdk.json 파일에 다음과 같은 기본 동작이 구성됩니다. cdk watch

  • "include"로 설정되어 있으며"**/*", 여기에는 프로젝트 루트에 있는 모든 파일 및 디렉터리가 포함됩니다.

  • "exclude"기본적으로 이미 무시된 파일 및 폴더를 제외하고는 선택 사항입니다. 이는 로 시작하는 파일 및 디렉터리., CDK 출력 디렉터리, 디렉터리로 구성됩니다. node_modules

구성할 watch 최소 설정은 입니다. "watch": {}

CDK 코드나 애플리케이션 코드에 배포 전 빌드 단계가 필요한 경우 cdk.json 파일의 "build" 키를 사용하여 cdk watch 작업하십시오.

참고

이 명령은 실험용으로 간주되며 향후 주요 변경 사항이 적용될 수 있습니다.

에도 동일한 제한이 cdk deploy --hotswap 적용됩니다cdk watch. 자세한 정보는 cdk deploy --hotswap을 참조하세요.

사용량

$ cdk watch <arguments> <options>

인수

CDK 스택 논리 ID

감시하려는 앱의 CDK 스택의 논리적 ID.

타입: 문자열

필수 항목 여부: 아니요

옵션

모든 CDK CLI 명령에 사용할 수 있는 글로벌 옵션 목록은 을 참조하십시오. 글로벌 옵션

--build-exclude, -E ARRAY

지정된 ID로 에셋을 다시 빌드하지 마십시오.

이 옵션은 단일 명령으로 여러 번 지정할 수 있습니다.

기본값: []

--change-set-name STRING

생성할 CloudFormation 변경 세트의 이름.

--concurrency NUMBER

스택 간 종속성을 고려하면서 여러 스택을 병렬로 배포하고 핫스왑합니다. 이 옵션을 사용하면 배포 속도를 높일 수 있습니다. 여전히 속도 제한 CloudFormation 및 기타 AWS 계정 속도 제한을 고려해야 합니다.

수행할 최대 동시 배포 수 (종속성 허용) 를 지정하는 숫자를 제공하십시오.

기본값: 1

--exclusively, -e BOOLEAN

요청된 스택만 배포하고 종속성은 포함하지 마십시오.

--force, -f BOOLEAN

템플릿이 동일하더라도 항상 스택을 배포하세요.

기본값: false

--help, -h BOOLEAN

명령에 대한 명령 참조 정보를 표시합니다. cdk watch

--hotswap BOOLEAN

기본적으로 가능한 경우 핫스왑 배포를 cdk watch 사용하여 리소스를 업데이트합니다. CLICDK는 핫스왑 배포를 시도하며 실패할 경우 전체 배포로 돌아가지 않습니다. CloudFormation 감지된 변경 내용 중 핫스왑을 통해 업데이트할 수 없는 모든 변경 사항은 무시됩니다.

기본값: true

--hotswap-fallback BOOLEAN

기본적으로 핫스왑 배포를 cdk watch 시도하고 배포가 필요한 변경 사항은 무시합니다. CloudFormation 핫스왑 --hotswap-fallback 배포가 실패할 경우 폴백하여 전체 CloudFormation 배포를 수행하도록 제공합니다.

--logs BOOLEAN

기본적으로 는 애플리케이션의 모든 CloudWatch 로그 그룹을 cdk watch 모니터링하고 로그 이벤트를 로컬로 스트리밍합니다. stdout

기본값: true

--progress STRING

CDK에서 배포 진행 상황을 CLI 표시하는 방법을 구성하십시오.

  • bar— 스택 배포 이벤트를 현재 배포 중인 리소스에 대한 이벤트와 함께 진행률 표시줄로 표시합니다.

  • events— 모든 CloudFormation 이벤트를 포함한 전체 기록을 제공합니다.

프로젝트 cdk.json 파일이나 로컬 개발 시스템에서 이 옵션을 구성할 수도 있습니다. ~/.cdk.json 

{
   "progress": "events"
}

유효한 값: bar, events

기본값: bar

--rollback BOOLEAN

배포 중에 리소스 생성 또는 업데이트에 실패하면 배포는 CDK가 CLI 반환되기 전에 안정적인 최신 상태로 롤백됩니다. 해당 시점까지 변경한 내용은 모두 취소됩니다. 생성된 리소스는 삭제되고 적용된 업데이트는 롤백됩니다.

--no-rollback또는 -R 를 사용하여 이 동작을 비활성화하십시오. 리소스 생성 또는 업데이트에 실패하는 경우 CLI CDK는 해당 시점까지 변경한 내용을 그대로 두고 반환합니다. 이는 빠르게 반복해야 하는 개발 환경에서 유용할 수 있습니다.

참고

어떤 false 경우에는 리소스 교체를 야기하는 배포가 항상 실패합니다. 이 값은 새 리소스를 업데이트하거나 생성하는 배포에만 사용할 수 있습니다.

기본값: true

--toolkit-stack-name STRING

기존 CDK 툴킷 스택의 이름.

이 옵션은 레거시 합성을 사용하는 CDK 앱에만 사용됩니다.

예제

논리적 DevelopmentStack ID가 포함된 CDK 스택에서 변경 사항을 확인하세요.

$ cdk watch DevelopmentStack
Detected change to 'lambda-code/index.js' (type: change). Triggering 'cdk deploy'
DevelopmentStack: deploying...

 ✅  DevelopmentStack

변경 내용 감시 대상에서 포함할 내용과 제외할 내용을 cdk.json 파일에 구성합니다.

{
   "app": "mvn -e -q compile exec:java",
   "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
   }
}

cdk.json 파일을 구성하여 배포 Java 전에 사용하여 CDK 프로젝트를 빌드하십시오.

{
  "app": "mvn -e -q exec:java",
  "build": "mvn package",
  "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
  }
}