CDK AWS v2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
cdk flags
CDK CLI에 대한 기능 플래그 구성을 보고 수정합니다.
기능 플래그는 CDK CLI의 동작을 제어하며 이를 사용하여 특정 기능을 활성화하거나 비활성화할 수 있습니다. cdk flags 명령을 사용하여 현재 기능 플래그 구성을 보고 필요에 따라 수정합니다.
주의
이 cdk flags 명령은 AWS CDK용으로 개발 중입니다. 이 명령의 현재 기능은 프로덕션에 바로 사용할 수 있고 사용하기에 안전한 것으로 간주됩니다. 그러나이 명령의 범위와 기능은 변경될 수 있습니다. 따라서이 명령을 사용할 수 있는 unstable=flags 옵션을 제공하여 옵트인해야 합니다.
사용법
$ cdk flags <arguments> <options>
인수
- FLAGNAME
-
보거나 수정하려는 특정 기능 플래그의 이름입니다.
유형: 문자열
필수 항목 여부: 아니요
옵션
모든 CDK CLI 명령에서 작동하는 글로벌 옵션 목록은 글로벌 옵션을 참조하세요.
-
--set <BOOLEAN> -
기능 플래그 구성을 수정합니다.
-
--all <BOOLEAN> -
모든 기능 플래그를 수정하거나 봅니다.
-
--recommended <BOOLEAN> -
플래그를 권장 상태로 변경합니다.
-
--default <BOOLEAN> -
플래그를 기본 상태로 변경합니다.
-
--unconfigured <BOOLEAN> -
구성되지 않은 기능 플래그를 수정합니다.
-
--value <STRING> -
기능 플래그 구성을 설정할 값입니다.
requiresArg: true
-
--safe <BOOLEAN> -
애플리케이션에 영향을 주지 않는 모든 기능 플래그를 활성화합니다.
-
--interactive, -i <BOOLEAN> -
플래그 명령에 대한 대화형 옵션입니다.
예시
기능 플래그 구성 보기
를 실행cdk flags하여 권장 상태와 다른 기능 플래그 구성에 대한 보고서를 봅니다. 구성되지 않은 플래그에는 현재 플래그에 값이 없음을 <unset> 나타내는 레이블이 지정됩니다. 플래그는 다음 순서로 표시됩니다.
-
권장 값과 일치하지 않는 값으로 설정된 플래그
-
구성하지 않은 플래그
$ cdk flags --unstable=flags Feature Flag Recommended User * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
를 실행cdk flags --all하여 모든 기능 플래그에 대한 보고서를 다음 순서로 볼 수도 있습니다.
-
권장 값과 일치하는 값으로 설정된 플래그
-
권장 값과 일치하지 않는 값으로 설정된 플래그
-
구성하지 않은 플래그
$ cdk flags --unstable=flags --all Feature Flag Recommended User @aws-cdk/... true true * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
기능 플래그 값 수정
기능 플래그를 대화형으로 수정하려면 cdk flags --interactive (또는 cdk flags -i)를 실행하여 메뉴 옵션 목록을 봅니다.
모든 기능 플래그를 권장 값으로 변경하려면를 실행합니다cdk flags --set --recommended --all. 이 명령은 최신 CDK 기능 플래그 구성을 사용하여 기능 플래그 구성을 up-to-date 상태로 유지합니다. 이 명령을 실행하면 구성된 기존 값을 덮어쓸 수 있습니다.
$ cdk flags --unstable=flags --set --recommended --all Feature Flag Recommended Value User Value * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset> Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
구성된 기존 플래그의 상태를 유지하려면를 실행합니다cdk flags --set --recommended --unconfigured. 이 옵션은 구성되지 않은 기능 플래그만 권장 값으로 변경합니다.
$ cdk flags --unstable=flags --set --recommended --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true <unset> * @aws-cdk/... true <unset> Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ├─ [-] None └─ [+] ServerSideEncryptionConfiguration: - ... ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
구성되지 않은 기능 플래그가 애플리케이션을 방해하지 않도록 하려면 cdk flags --set --default --unconfigured 명령을 실행하여 구성되지 않은 플래그를 기본값으로 변경합니다. 예를 들어 @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021가 구성되지 않은 경우를 실행한 후 알림이 표시됩니다cdk synth. 그러나 플래그를 기본 상태(false)로 설정하면 플래그가 구성되고 꺼지며 애플리케이션에 영향을 주지 않습니다.
$ cdk flags --unstable=flags --set --default --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true <unset> * @aws-cdk/... true <unset> Synthesizing... Do you want to accept these changes? (y/n) y Resynthesizing...
특정 기능 플래그 검사
플래그에 대한 자세한 정보 보기
cdk flags --all를 실행cdk flags하고 기능 플래그 구성을 보는 것 외에도 cdk flags "FLAGNAME"를 사용하여 특정 기능 플래그를 검사하고 플래그가 수행하는 작업을 확인할 수도 있습니다. 이는 특정 플래그와 해당 플래그가 애플리케이션에 미치는 영향을 이해하려는 경우에 유용할 수 있습니다.
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default. Recommended Value: true User Value: true
하위 문자열을 기준으로 플래그 필터링
를 실행cdk flags substring하여 일치하는 모든 기능 플래그를 볼 수도 있습니다. 해당 하위 문자열과 일치하는 기능 플래그가 하나만 있는 경우 특정 세부 정보가 표시됩니다.
$ cdk flags --unstable=flags ebs @aws-cdk/aws-ec2:ebsDefaultGp3Volume Description: When enabled, the default volume type of the EBS volume will be GP3 Recommended Value: true User Value: true
여러 플래그가 하위 문자열과 일치하는 경우 일치하는 모든 플래그가 테이블에 표시됩니다. 여러 하위 문자열을 입력하면 하위 문자열이 포함된 일치하는 모든 플래그가 반환됩니다.
$ cdk flags --unstable=flags s3 lambda Feature Flag Recommended User * @aws-cdk/s3... true false * @aws-cdk/lambda... true false * @aws-cdk/lambda... true <unset>
특정 플래그 수정
플래그 값을 수정해야 하고 플래그를 정확하고 지원되는 상태로 설정하고 있는지 확인하려면를 실행합니다cdk flags --set "FLAGNAME" --value="state".
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true" Synthesizing... Resources [~] AWS::CloudFront::Distribution MyDistribution └─ [~] Properties └─ [~] DefaultSecurityPolicy ├─ [-] TLSv1.0 └─ [+] TLSv1.2_2021 - ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
