v AWS CDK 2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
배포된 AWS 리소스, AWS CloudFormation 스택 및 CloudFormation 템플릿을 새 AWS CDK 프로젝트로 마이그레이션합니다.
이 명령은 --stack-name을 사용하여 제공하는 값으로 이름이 지정된 단일 스택이 포함된 새 CDK 앱을 생성합니다. --from-scan, --from-stack 또는 --from-path를 사용하여 마이그레이션 소스를 구성할 수 있습니다.
cdk migrate 사용에 대한 자세한 내용은 기존 리소스 및 AWS CloudFormation 템플릿을 로 마이그레이션 AWS CDK 섹션을 참조하세요.
참고
cdk migrate 명령은 실험 단계에 있으므로 향후 큰 변경이 있을 수 있습니다.
사용법
$cdk migrate<options>
옵션
모든 CDK CLI 명령에서 작동하는 글로벌 옵션 목록은 글로벌 옵션 섹션을 참조하세요.
필수 옵션
--stack-nameSTRING-
마이그레이션 후 CDK 앱 내에서 생성될 AWS CloudFormation 스택의 이름입니다.
필수 항목 여부: 예
조건부 옵션
--from-pathPATH-
마이그레이션할 AWS CloudFormation 템플릿의 경로입니다. 로컬 템플릿을 지정하려면 이 옵션을 제공합니다.
필수 항목 여부: 조건부. 로컬 AWS CloudFormation 템플릿에서 마이그레이션하는 경우 필요합니다.
--from-scanSTRING-
AWS 환경에서 배포된 리소스를 마이그레이션할 때이 옵션을 사용하여 새 스캔을 시작할지 또는가 AWS CDK CLI 마지막으로 성공한 스캔을 사용해야 하는지 지정합니다.
필수 항목 여부: 조건부. 배포된 AWS 리소스에서 마이그레이션할 때 필요합니다.
허용되는 값:
most-recent,new --from-stackBOOLEAN-
배포된 AWS CloudFormation 스택에서 마이그레이션하려면이 옵션을 제공합니다.
--stack-name를 사용하여 배포된 AWS CloudFormation 스택의 이름을 지정합니다.필수 항목 여부: 조건부. 배포된 AWS CloudFormation 스택에서 마이그레이션하는 경우 필요합니다.
선택적 옵션
--accountSTRING-
AWS CloudFormation 스택 템플릿을 검색할 계정입니다.
필수 항목 여부: 아니요
기본값:는 AWS CDK CLI 기본 소스에서 계정 정보를 가져옵니다.
--compressBOOLEAN-
생성된 CDK 프로젝트를 ZIP 파일로 압축하려면 이 옵션을 제공합니다.
필수 항목 여부: 아니요
--filterARRAY-
AWS 계정 및에서 배포된 리소스를 마이그레이션할 때를 사용합니다 AWS 리전. 이 옵션은 마이그레이션할 배포된 리소스를 결정하는 필터를 지정합니다.
이 옵션은 키 값 페어 배열을 수락합니다. 여기서 키는 필터 유형을 나타내고 값은 필터링할 값을 나타냅니다.
다음은 허용되는 키입니다.
-
resource-identifier– 리소스의 식별자입니다. 값은 리소스 논리적 또는 물리적 ID일 수 있습니다. 예:resource-identifier="ClusterName". -
resource-type-prefix- AWS CloudFormation 리소스 유형 접두사입니다. 예를 들어, 모든 Amazon DynamoDB 리소스를 필터링하려면resource-type-prefix="AWS::DynamoDB::"를 지정하세요. -
tag-key- 리소스 태그의 키입니다. 예:tag-key="myTagKey". -
tag-value- 리소스 태그의 값입니다. 예:tag-value="myTagValue".
AND조건부 로직에 대해 여러 키 값 페어를 제공합니다.--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"는 태그 키로myTagKey가 지정된 모든 DynamoDB 리소스를 필터링합니다.OR조건부 로직을 위해 단일 명령에서--filter옵션을 여러 번 제공합니다.--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"는 DynamoDB 리소스이거나 태그 키로myTagKey가 지정된 모든 리소스를 필터링합니다.필수 항목 여부: 아니요
-
--help, -hBOOLEAN-
cdk migrate명령에 대한 명령 참조 정보를 표시합니다. --languageSTRING-
마이그레이션 중 생성된 CDK 프로젝트에 사용할 프로그래밍 언어입니다.
필수 항목 여부: 아니요
유효한 값:
typescript,python,java,csharp,go.기본값:
typescript --output-pathPATH-
마이그레이션된 CDK 프로젝트의 출력 경로입니다.
필수 항목 여부: 아니요
기본값: 기본적으로 AWS CDK CLI는 현재 작업 디렉터리를 사용합니다.
--regionSTRING-
AWS CloudFormation 스택 템플릿을 검색할 AWS 리전 입니다.
필수 항목 여부: 아니요
기본값: AWS CDK CLI는 기본 소스에서 AWS 리전 정보를 가져옵니다.
예시
CloudFormation 스택에서 마이그레이션하는 간단한 예
를 사용하여 특정 AWS 환경의 배포된 CloudFormation 스택에서 마이그레이션합니다--from-stack. --stack-name을 제공하여 새 CDK 스택의 이름을 지정합니다. 다음은 TypeScript를 사용하는 새로운 CDK 앱으로 myCloudFormationStack을 마이그레이션하는 예입니다.
$cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
로컬 CloudFormation 템플릿에서 마이그레이션하는 간단한 예
--from-path를 사용하여 로컬 JSON 또는 YAML CloudFormation 템플릿에서 마이그레이션합니다. --stack-name을 제공하여 새 CDK 스택의 이름을 지정합니다. 다음은 로컬 template.json 파일에서 myCloudFormationStack 스택을 포함하는 TypeScript로 새 CDK 앱을 생성하는 예입니다.
$cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
배포된 AWS 리소스에서 마이그레이션하는 간단한 예
를 사용하여 CloudFormation 스택과 연결되지 않은 특정 AWS 환경에서 배포된 AWS 리소스를 마이그레이션합니다--from-scan. CDK CLI는 IaC generator 서비스를 활용하여 리소스를 스캔하고 템플릿을 생성합니다. 그런 다음 CDK CLI는 템플릿을 참조하여 새 CDK 앱을 생성합니다. 다음은 마이그레이션된 AWS 리소스가 포함된 새 myCloudFormationStack 스택TypeScript을 사용하여에서 새 CDK 앱을 생성하는 예제입니다.
$cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
