v AWS CDK 2 개발자 안내서입니다. 이전 CDK v1은 2022년 6월 1일에 유지 관리에 들어갔으며 2023년 6월 1일에 지원이 종료되었습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS Cloud Development Kit (AWS CDK) 명령줄 인터페이스(CLI) cdk gc 명령을 사용하여 부트스트랩 스택의 리소스에 저장된 미사용 자산에 대한 가비지 수집을 수행합니다. 이 명령을 사용하여 더 이상 필요하지 않은 자산을 보고, 관리하고, 삭제할 수 있습니다.
Amazon Simple Storage Service(Amazon S3) 자산의 경우 CDKCLI는 동일한 환경의 기존 AWS CloudFormation 템플릿을 확인하여 참조되는지 확인합니다. 참조하지 않으면 사용되지 않은 것으로 간주되고 가비지 수집 작업에 적합한 것으로 간주됩니다.
주의
cdk gc 명령은에 대해 개발 중입니다 AWS CDK. 이 명령의 현재 기능은 프로덕션 준비가 되어 있고 사용하기에 안전한 것으로 간주됩니다. 그러나이 명령의 범위와 기능은 변경될 수 있습니다. 따라서이 명령을 사용할 수 있는 unstable=gc 옵션을 제공하여 옵트인해야 합니다.
사용법
$cdk gc<arguments><options>
인수
- AWS 환경
-
가비지 수집 작업을 수행할 대상 AWS 환경입니다.
환경을 제공할 때는 형식을 사용합니다
aws://. 예:<account-id>/<region>aws://.123456789012/us-east-1이 인수는 단일 명령으로 여러 번 제공하여 여러 환경에서 가비지 수집 작업을 수행할 수 있습니다.
기본적으로 CDKCLI는 CDK 앱에서 참조하거나 인수로 제공하는 모든 환경에서 가비지 수집 작업을 수행합니다. 환경을 제공하지 않으면 CDKCLI가 기본 소스의 환경을 결정합니다. 이러한 소스에는
--profile옵션, 환경 변수 또는 기본 AWS CLI 소스를 사용하여 지정하는 환경이 포함됩니다.
옵션
모든 CDK CLI 명령에서 작동하는 글로벌 옵션 목록은 글로벌 옵션 섹션을 참조하세요.
--actionSTRING-
가비지 수집 중에 자산에 대해
cdk gc수행하는 작업입니다.-
delete-tagged- 제공한 버퍼 일수 범위 내의 날짜로 태그가 지정된 자산을 삭제하지만 새로 식별된 미사용 자산에는 태그를 지정하지 않습니다. -
full- 모든 가비지 수집 작업을 수행합니다. 여기에는 제공한 버퍼 일수 범위 내의 자산을 삭제하고 새로 식별된 미사용 자산에 태그를 지정하는 것이 포함됩니다. -
print- 명령 프롬프트에서 미사용 자산 수를 출력하지만 AWS 환경 내에서 실제로 변경하지는 않습니다. -
tag- 새로 식별된 미사용 자산에 태그를 지정하지만 사용자가 제공한 버퍼 일수 범위 내의 자산은 삭제하지 않습니다.
허용되는 값:
delete-tagged,full,print,tag기본값:
full -
--bootstrap-stack-nameSTRING-
AWS 환경에서 CDK 부트스트랩 스택의 이름입니다. 부트스트랩 스택 이름을 사용자 지정한 경우이 옵션을 제공합니다. 기본
CDKToolkit스택 이름을 사용하는 경우이 옵션을 제공할 필요가 없습니다.기본값:
CDKToolkit --confirmBOOLEAN-
자산을 삭제하기 전에 CDK가 사용자에게 수동 확인을 CLI 요청할지 여부를 지정합니다.
수동 확인을 요청하지 않고 자산을 자동으로 삭제
false하려면를 지정합니다.기본값:
true --created-buffer-daysNUMBER-
가비지 수집 작업에 적합하기 전에 자산이 존재해야 하는 일수입니다.
숫자를 입력하면 지정된 일수를 초과하여 존재하지 않은 자산이 가비지 수집 작업에서 필터링됩니다.
기본값:
1 --help, -hBOOLEAN-
cdk gc명령에 대한 명령 참조 정보를 표시합니다. --rollback-buffer-daysNUMBER-
가비지 수집 작업에 적합하기 전에 자산에 격리된 것으로 태그를 지정해야 하는 일수입니다.
숫자를 입력하면 CDKCLI는 미사용 자산에 삭제하는 대신 현재 날짜로 태그를 지정합니다. CLI 또한 CDK는
cdk gc명령의 이전 실행 중에 태그가 지정된 자산이 있는지 확인합니다. 이전에 태그가 지정된 자산 중 사용자가 제공한 버퍼 일수 범위에 속하는 자산은 삭제됩니다.기본값:
0 --typeSTRING-
가비지 수집 작업을 수행할 부트스트랩 스택 내의 부트스트랩 리소스 유형입니다.
-
all- 모든 부트스트랩된 리소스에 대해 가비지 수집 작업을 수행합니다. -
ecr- 부트스트랩 스택의 Amazon Elastic Container Registry(Amazon ECR) 리포지토리에 있는 자산에 대한 가비지 수집 작업을 수행합니다. -
s3- 부트스트랩 스택의 Amazon S3 버킷에 있는 자산에 대해 가비지 수집 작업을 수행합니다.
허용되는 값:
all,ecr,s3기본값:
all -
--unstableSTRING-
아직 개발 중인 CDK CLI 명령의 사용을 허용합니다.
이 옵션은 아직 개발 중이며 변경될 수 있는 CDK CLI 명령을 사용하는 데 필요합니다.
이 옵션은 단일 명령에서 여러 번 제공할 수 있습니다.
를 사용하려면를
cdk gc제공합니다--unstable=gc.
예시
기본 예제
다음 예제에서는 부트스트랩 스택의 Amazon S3 버킷에 있는 자산에 대해 기본 가비지 수집 작업을 수행하기 위한 수동 확인을 요청합니다.
$cdk gc --unstable=gc --type=s3⏳ Garbage Collecting environment aws://<account-id>/<region>... Found99assets to delete based off of the following criteria: - assets have been isolated for > 0 days - assets were created > 1 days ago Delete this batch (yes/no/delete-all)?
다음 예제에서는 부트스트랩 스택의 Amazon S3 버킷에 있는 다양한 자산에 대해 가비지 수집 작업을 수행합니다. 이 범위에는 이전에에서 30일 cdk gc 이상 태그가 지정되었고 10일 이전에 생성된 자산이 포함됩니다. 이 명령은 자산을 삭제하기 전에 수동 확인을 요청합니다.
$cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10
다음 예제에서는 30일 이상 사용되지 않은 부트스트랩 스택의 Amazon S3 버킷에서 이전에 태그가 지정된 자산을 삭제하는 작업을 수행합니다.
$cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30
