cdk gc - AWS Cloud Development Kit (AWS CDK) v2
UtilizzoArgomentiOpzioniEsempi

Questa è la AWS CDK v2 Developer Guide. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

cdk gc

Utilizza il comando CLI (Command Line Interface) del AWS Cloud Development Kit (AWS CDKcdk gc) per eseguire la raccolta dei rifiuti sugli asset inutilizzati archiviati nelle risorse del tuo stack di bootstrap. Usa questo comando per visualizzare, gestire ed eliminare le risorse che non ti servono più.

Per gli asset Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3), l'interfaccia a riga di comando CDK controllerà i modelli AWS CloudFormation esistenti nello stesso ambiente per verificare se vi sono riferimenti. Se non vengono citati, verranno considerati inutilizzati e idonei per le azioni di raccolta dei rifiuti.

avvertimento

Il cdk gc comando è in fase di sviluppo per il CDK. AWS Le funzionalità correnti di questo comando sono considerate pronte per la produzione e sicure da usare. Tuttavia, l'ambito di questo comando e le relative funzionalità sono soggetti a modifiche. Pertanto, è necessario attivare il consenso fornendo la unstable=gc possibilità di utilizzare questo comando.

Utilizzo

$ cdk gc <arguments> <options>

Argomenti

AWS ambiente

L' AWS ambiente di destinazione su cui eseguire le azioni di raccolta dei rifiuti.

Quando si fornisce un ambiente, utilizzare il seguente formato:. aws://<account-id>/<region> Ad esempio, aws://<123456789012>/<us-east-1>.

Questo argomento può essere fornito più volte in un unico comando per eseguire azioni di raccolta dei rifiuti su più ambienti.

Per impostazione predefinita, la CLI CDK eseguirà azioni di raccolta dei rifiuti su tutti gli ambienti a cui fai riferimento nell'app CDK o fornisci come argomenti. Se non fornite un ambiente, la CLI CDK determinerà l'ambiente dalle fonti predefinite. Queste fonti includono ambienti specificati utilizzando l'--profileopzione, le variabili di ambiente o le fonti AWS CLI predefinite.

Opzioni

Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, vedete Opzioni globali.

--action <STRING>

L'azione che viene cdk gc eseguita sulle risorse durante una raccolta dei rifiuti.

  • delete-tagged— Elimina le risorse a cui è stata assegnata una data compresa nell'intervallo di giorni di buffer fornito, ma non contrassegna le risorse non utilizzate identificate di recente.

  • full— Esegue tutte le azioni di raccolta dei rifiuti. Ciò include l'eliminazione delle risorse entro l'intervallo di giorni di buffer fornito e l'etichettatura delle risorse non utilizzate appena identificate.

  • print— Visualizza il numero di risorse inutilizzate al prompt dei comandi ma non apporta alcuna modifica effettiva all'interno dell'ambiente. AWS

  • tag— Etichetta tutte le nuove risorse non utilizzate identificate, ma non elimina le risorse che rientrano nell'intervallo di giorni di buffer fornito.

Valori accettati:delete-tagged,,, full print tag

Valore predefinito: full

--bootstrap-stack-name <STRING>

Il nome dello stack di bootstrap CDK nel tuo ambiente. AWS Fornisci questa opzione se hai personalizzato il nome dello stack di bootstrap. Se utilizzi il nome dello CDKToolkit stack predefinito, non devi fornire questa opzione.

Valore predefinito: CDKToolkit

--confirm <BOOLEAN>

Specificate se la CLI CDK richiederà una conferma manuale da parte vostra prima di eliminare qualsiasi risorsa.

Specificate false di eliminare automaticamente le risorse senza richiedere una conferma manuale.

Valore predefinito: true

--created-buffer-days <NUMBER>

Il numero di giorni in cui una risorsa deve esistere prima che sia idonea per le azioni di raccolta dei rifiuti.

Quando fornite un numero, le risorse che non sono esistite oltre il numero di giorni specificato vengono escluse dalle azioni di raccolta dei rifiuti.

Valore predefinito: 1

--help, -h <BOOLEAN>

Mostra le informazioni di riferimento del comando. cdk gc

--rollback-buffer-days <NUMBER>

Il numero di giorni in cui una risorsa deve essere etichettata come isolata prima che sia idonea per le azioni di raccolta dei rifiuti.

Quando fornite un numero, la CLI CDK taggherà le risorse inutilizzate con la data corrente invece di eliminarle. La CLI CDK controllerà anche se alcune risorse sono state taggate durante le esecuzioni precedenti del cdk gc comando. Le risorse precedentemente etichettate che rientrano nell'intervallo di giorni di buffer fornito verranno eliminate.

Valore predefinito: 0

--type <STRING>

Il tipo di risorsa bootstrap all'interno dello stack bootstrap su cui eseguire azioni di raccolta dei rifiuti.

  • all— Esegui azioni di raccolta dei rifiuti su tutte le risorse avviate.

  • ecr— Esegui azioni di raccolta dei rifiuti sugli asset nel repository Amazon Elastic Container Registry (Amazon ECR) del tuo stack di bootstrap.

  • s3— Esegui azioni di raccolta dei rifiuti sugli asset nel bucket Amazon S3 del tuo stack di bootstrap.

Valori all accettati:,, ecr s3

Valore predefinito: all

--unstable <STRING>

Consenti l'utilizzo di comandi CLI CDK che sono ancora in fase di sviluppo.

Questa opzione è necessaria per utilizzare qualsiasi comando CDK CLI ancora in fase di sviluppo e soggetto a modifiche.

Questa opzione può essere fornita più volte in un unico comando.

Da usarecdk gc, fornisci--unstable=gc.

Esempi

Esempi di base

L'esempio seguente richiede una conferma manuale per eseguire azioni di raccolta dei rifiuti predefinite sugli asset nel bucket Amazon S3 dello stack di bootstrap:

$ cdk gc --unstable=gc --type=s3

 ⏳  Garbage Collecting environment aws://<account-id>/<region>...
Found 99 assets 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)?

L'esempio seguente esegue azioni di raccolta dei rifiuti su una serie di risorse nel bucket Amazon S3 dello stack di bootstrap. Questo intervallo include risorse che sono state precedentemente etichettate da cdk gc per oltre 30 giorni e che sono state create almeno 10 giorni fa. Questo comando richiederà una conferma manuale prima di eliminare qualsiasi risorsa:

$ cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10

L'esempio seguente esegue l'azione di eliminazione degli asset precedentemente etichettati nel bucket Amazon S3 dello stack di bootstrap che sono rimasti inutilizzati per più di 30 giorni:

$ cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30