Esta es la guía para AWS CDK desarrolladores de la versión 2. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Utilice la interfaz de línea de AWS Cloud Development Kit (AWS CDK) comandos (CLI) para cdk gc realizar la recolección de basura en los activos no utilizados almacenados en los recursos de su pila de bootstrap. Utilice este comando para ver, gestionar y eliminar los activos que ya no necesite.
Para los activos de Amazon Simple Storage Service (Amazon S3), la CDK CLI comprobará las AWS CloudFormation plantillas existentes en el mismo entorno para comprobar si están referenciadas. Si no se hace referencia a ellas, se considerarán no utilizadas y aptas para las acciones de recolección de basura.
aviso
El cdk gc comando está en desarrollo para AWS CDK. Las características actuales de este comando se consideran listas para la producción y seguras de usar. Sin embargo, el alcance de este comando y sus funciones están sujetos a cambios. Por lo tanto, debe suscribirse proporcionando la unstable=gc opción de usar este comando.
Uso
$cdk gc<arguments><options>
Argumentos
- AWS entorno
-
El AWS entorno de destino en el que se realizarán las acciones de recolección de basura.
Al proporcionar un entorno, utilice el siguiente formato:
aws://. Por ejemplo,<account-id>/<region>aws://.123456789012/us-east-1Este argumento se puede proporcionar varias veces en un solo comando para realizar acciones de recolección de basura en varios entornos.
De forma predeterminada, el CDK CLI realizará acciones de recolección de basura en todos los entornos a los que hagas referencia en tu aplicación de CDK o a los que proporciones como argumentos. Si no proporcionas un entorno, el CDK CLI determinará el entorno a partir de las fuentes predeterminadas. Estas fuentes incluyen los entornos que especifique mediante la
--profileopción, las variables de entorno o las AWS CLI fuentes predeterminadas.
Opciones
Para obtener una lista de las opciones globales que funcionan con todos los CDK CLI comandos, consulteOpciones globales.
--actionSTRING-
La acción que se
cdk gcrealiza en sus activos durante una recolección de basura.-
delete-tagged— Elimina los activos que se han etiquetado con una fecha dentro del intervalo de días de almacenamiento que usted proporciona, pero no etiqueta los activos no utilizados recientemente identificados. -
full— Realiza todas las acciones de recolección de basura. Esto incluye eliminar los activos dentro del intervalo de días de almacenamiento que usted proporcione y etiquetar los activos no utilizados recientemente identificados. -
print— Muestra el número de activos no utilizados en la línea de comandos, pero no realiza ningún cambio real en el AWS entorno. -
tag— Etiqueta los activos no utilizados que se hayan identificado recientemente, pero no los elimina dentro del intervalo de días de almacenamiento que usted haya indicado.
Valores aceptados:
delete-tagged,full,print,tagValor predeterminado:
full -
--bootstrap-stack-nameSTRING-
El nombre de la pila de bootstrap de CDK de su AWS entorno. Proporcione esta opción si ha personalizado el nombre de la pila de bootstrap. Si utilizas el nombre de
CDKToolkitpila predeterminado, no tienes que proporcionar esta opción.Valor predeterminado:
CDKToolkit --confirmBOOLEAN-
Especifique si el CDK CLI le solicitará una confirmación manual antes de eliminar cualquier activo.
Especifique
falseque se eliminen automáticamente los activos sin tener que solicitarle una confirmación manual.Valor predeterminado:
true --created-buffer-daysNUMBER-
El número de días que debe existir un activo antes de que pueda ser objeto de acciones de recolección de basura.
Al proporcionar un número, los activos que no hayan existido más allá del número de días especificado se excluyen de las acciones de recolección de basura.
Valor predeterminado:
1 --help, -hBOOLEAN-
Muestra la información de referencia del comando
cdk gc. --rollback-buffer-daysNUMBER-
El número de días que un activo debe etiquetarse como aislado antes de que pueda ser objeto de acciones de recolección de basura.
Al proporcionar un número, el CDK CLI etiquetará los activos no utilizados con la fecha actual en lugar de eliminarlos. El CDK. CLI también comprobará si se ha etiquetado algún activo durante las ejecuciones anteriores del
cdk gccomando. Se eliminarán los activos previamente etiquetados que se encuentren dentro del intervalo de días de almacenamiento que usted haya proporcionado.Valor predeterminado:
0 --typeSTRING-
El tipo de recurso de arranque de la pila de arranque en el que se van a realizar acciones de recolección de basura.
-
all— Realice acciones de recolección de basura en todos los recursos de arranque. -
ecr— Realice acciones de recolección de basura en los activos del repositorio Amazon Elastic Container Registry (Amazon ECR) de su pila de bootstrap. -
s3— Realice acciones de recolección de basura en los activos del depósito de Amazon S3 de su pila de bootstrap.
Valores aceptados:
all,,ecrs3Valor predeterminado:
all -
--unstableSTRING-
Permitir el uso de CDK CLI comandos que aún están en desarrollo.
Esta opción es necesaria para usar cualquier CDK CLI comando que aún se encuentra en desarrollo y está sujeto a cambios.
Esta opción se puede proporcionar varias veces en un mismo comando.
Para usar
cdk gc, proporcione--unstable=gc.
Ejemplos
Ejemplos básicos
En el siguiente ejemplo, se le solicita una confirmación manual para realizar las acciones de recolección de basura predeterminadas en los activos del bucket de Amazon S3 de su pila de bootstrap:
$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)?
En el siguiente ejemplo, se realizan acciones de recolección de basura en una serie de activos del bucket de Amazon S3 de su pila de bootstrap. Este rango incluye los activos que han sido etiquetados anteriormente cdk gc durante más de 30 días y que se han creado hace 10 días o más. Este comando solicitará una confirmación manual antes de eliminar cualquier activo:
$cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10
El siguiente ejemplo lleva a cabo la acción de eliminar los activos previamente etiquetados en el depósito de Amazon S3 de su pila de bootstrap que no se hayan utilizado durante más de 30 días:
$cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30
