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

v AWS CDK 2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔고 2023년 6월 1일에 지원을 종료했습니다.

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

cdk migrate

배포된 AWS 리소스, AWS CloudFormation 스택, CloudFormation 템플릿을 새 AWS CDK 프로젝트로 마이그레이션합니다.

이 명령을 실행하면 입력한 값으로 이름이 지정된 단일 스택이 포함된 새 CDK 앱이 생성됩니다. --stack-name --from-scan--from-stack, 또는 --from-path 를 사용하여 마이그레이션 소스를 구성할 수 있습니다.

사용에 대한 자세한 내용은 cdk migrate 을 참조하십시오기존 리소스 및 AWS CloudFormation 템플릿을 로 마이그레이션 AWS CDK.

참고

이 cdk migrate 명령은 실험용이며 향후 주요 변경 사항이 있을 수 있습니다.

사용량

$ cdk migrate <options>

옵션

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

필수 옵션

--stack-name STRING

마이그레이션 후 CDK 앱 내에 생성될 AWS CloudFormation 스택의 이름.

필수 항목 여부: 예

조건부 옵션

--from-path PATH

마이그레이션할 AWS CloudFormation 템플릿의 경로. 로컬 템플릿을 지정하려면 이 옵션을 제공합니다.

필수 항목 여부: 조건부. 로컬 AWS CloudFormation 템플릿에서 마이그레이션하는 경우 필수입니다.

--from-scan STRING

AWS 환경에서 배포된 리소스를 마이그레이션할 때 이 옵션을 사용하여 새 검사를 시작할지 또는 마지막으로 성공한 스캔을 AWS CDK CLI 사용할지 여부를 지정합니다.

필수 항목 여부: 조건부. 배포된 AWS 리소스에서 마이그레이션할 때 필요합니다.

허용되는 값:, most-recent new

--from-stack BOOLEAN

배포된 AWS CloudFormation 스택에서 마이그레이션하려면 이 옵션을 제공하십시오. 배포된 AWS CloudFormation 스택의 이름을 지정하는 --stack-name 데 사용합니다.

필수 항목 여부: 조건부. 배포된 AWS CloudFormation 스택에서 마이그레이션하는 경우 필요합니다.

옵션 옵션

--account STRING

AWS CloudFormation 스택 템플릿을 가져올 계정입니다.

필수 항목 여부: 아니요

기본값: 는 기본 소스에서 계정 정보를 AWS CDK CLI 가져옵니다.

--compress BOOLEAN

생성된 CDK 프로젝트를 파일로 압축하려면 이 옵션을 제공하십시오. ZIP

필수 항목 여부: 아니요

--filter ARRAY

계정 및 계정에서 배포된 리소스를 마이그레이션할 때 사용합니다. AWS AWS 리전이 옵션은 마이그레이션할 배포된 리소스를 결정하는 필터를 지정합니다.

이 옵션은 키-값 쌍의 배열을 받아들입니다. 여기서 키는 필터 유형을 나타내고 값은 필터링할 값을 나타냅니다.

허용되는 키는 다음과 같습니다.

  • resource-identifier— 리소스의 식별자입니다. 값은 리소스 논리적 ID 또는 물리적 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조건부 로직에 여러 개의 키-값 쌍을 제공하십시오. 다음은 태그 myTagKey 키로 태그가 지정된 모든 DynamoDB 리소스를 필터링하는 예제입니다. --filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"

조건부 로직을 위해 OR 단일 명령으로 --filter 옵션을 여러 번 제공하십시오. 다음 예제는 DynamoDB 리소스이거나 태그 myTagKey 키로 태그가 지정된 모든 리소스를 필터링합니다. --filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"

필수 항목 여부: 아니요

--help, -h BOOLEAN

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

--language STRING

마이그레이션 중에 만든 CDK 프로젝트에 사용할 프로그래밍 언어입니다.

필수 항목 여부: 아니요

유효한 값:typescript,python, javacsharp,go.

기본값: typescript

--output-path PATH

마이그레이션된 CDK 프로젝트의 출력 경로.

필수 항목 여부: 아니요

기본값: 기본적으로 AWS CDK CLI 는 현재 작업 디렉토리를 사용합니다.

--region STRING

에서 AWS CloudFormation 스택 템플릿을 검색할 수 있습니다. AWS 리전

필수 항목 여부: 아니요

기본값: 는 기본 소스에서 AWS 리전 정보를 AWS CDK CLI 가져옵니다.

예제

스택에서 마이그레이션하는 간단한 예 CloudFormation

를 사용하여 --from-stack 특정 AWS 환경에 배포된 CloudFormation 스택에서 마이그레이션합니다. 새 CDK 스택의 이름을 --stack-name 지정하려면 입력하십시오. 다음은 사용 중인 새 CDK myCloudFormationStack 앱으로 마이그레이션하는 예제입니다. TypeScript 

$ cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'

로컬 템플릿에서 마이그레이션하는 간단한 예제 CloudFormation

를 사용하여 로컬 JSON 또는 YAML CloudFormation 템플릿에서 마이그레이션합니다. --from-path 새 CDK 스택의 이름을 --stack-name 지정하려면 입력하십시오. 다음은 로컬 template.json 파일의 myCloudFormationStack 스택이 TypeScript 포함된 새 CDK 앱을 만드는 예제입니다.

$ cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"

배포된 리소스에서 마이그레이션하는 간단한 예제 AWS

를 사용하여 CloudFormation --from-scan 스택과 연결되지 않은 특정 AWS 환경에서 배포된 AWS 리소스를 마이그레이션합니다. CDK는 IaC generator 서비스를 CLI 활용하여 리소스를 스캔하고 템플릿을 생성합니다. 그런 다음 CDK는 템플릿을 CLI 참조하여 새 CDK 앱을 만듭니다. 다음은 마이그레이션된 리소스가 포함된 새 TypeScript myCloudFormationStack 스택으로 새 CDK 앱을 만드는 예제입니다. AWS 

$ cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"