Este é o Guia do Desenvolvedor AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Use a interface de linha de AWS Cloud Development Kit (AWS CDK) comando (CLI) cdk gc comando para realizar a coleta de lixo em ativos não utilizados armazenados nos recursos de sua pilha de bootstrap. Use esse comando para visualizar, gerenciar e excluir ativos que você não precisa mais.
Para ativos do Amazon Simple Storage Service (Amazon S3), o CDK CLI verificará os AWS CloudFormation modelos existentes no mesmo ambiente para ver se eles são referenciados. Se não forem referenciados, eles serão considerados não utilizados e elegíveis para ações de coleta de lixo.
Atenção
O cdk gc comando está em desenvolvimento para AWS CDK o. Os recursos atuais desse comando são considerados prontos para produção e seguros de usar. No entanto, o escopo desse comando e seus recursos estão sujeitos a alterações. Portanto, você deve se inscrever fornecendo a unstable=gc opção de usar esse comando.
Uso
$cdk gc<arguments><options>
Argumentos
- AWS meio ambiente
-
O AWS ambiente de destino no qual realizar ações de coleta de lixo.
Ao fornecer um ambiente, use o seguinte formato:
aws://. Por exemplo,<account-id>/<region>aws://.123456789012/us-east-1Esse argumento pode ser fornecido várias vezes em um único comando para realizar ações de coleta de lixo em vários ambientes.
Por padrão, o CDK CLI executará ações de coleta de lixo em todos os ambientes que você faz referência em seu aplicativo CDK ou fornece como argumentos. Se você não fornecer um ambiente, o CDK CLI determinará o ambiente a partir das fontes padrão. Essas fontes incluem ambientes que você especifica usando a
--profileopção, variáveis de ambiente ou AWS CLI fontes padrão.
Opções
Para obter uma lista de opções globais que funcionam com todos os CDK CLI comandos, vejaOpções globais.
--actionSTRING-
A ação que é
cdk gcexecutada em seus ativos durante uma coleta de lixo.-
delete-tagged— Exclui ativos que foram marcados com uma data dentro do intervalo de dias de buffer fornecido por você, mas não marca ativos não utilizados recém-identificados. -
full— Execute todas as ações de coleta de lixo. Isso inclui excluir ativos dentro do intervalo de dias de buffer que você fornece e marcar ativos não utilizados recém-identificados. -
print— Exibe o número de ativos não utilizados no prompt de comando, mas não faz nenhuma alteração real em seu AWS ambiente. -
tag— Marca qualquer ativo não utilizado recém-identificado, mas não exclui nenhum ativo dentro do intervalo de dias de buffer que você fornece.
Valores aceitos:
delete-tagged,full,print,tagValor padrão:
full -
--bootstrap-stack-nameSTRING-
O nome da pilha de bootstrap do CDK em seu ambiente. AWS Forneça essa opção se você personalizou o nome da pilha de bootstrap. Se você estiver usando o nome padrão da
CDKToolkitpilha, não precisará fornecer essa opção.Valor padrão:
CDKToolkit --confirmBOOLEAN-
Especifique se o CDK CLI solicitará sua confirmação manual antes de excluir qualquer ativo.
Especifique
falsea exclusão automática dos ativos sem solicitar uma confirmação manual.Valor padrão:
true --created-buffer-daysNUMBER-
O número de dias que um ativo deve existir antes de ser elegível para ações de coleta de lixo.
Quando você fornece um número, os ativos que não existiram além do número especificado de dias são filtrados das ações de coleta de lixo.
Valor padrão:
1 --help, -hBOOLEAN-
Mostrar as informações de referência do comando
cdk gc. --rollback-buffer-daysNUMBER-
O número de dias em que um ativo deve ser marcado como isolado antes de se qualificar para ações de coleta de lixo.
Quando você fornece um número, o CDK CLI marcará os ativos não utilizados com a data atual em vez de excluí-los. O CDK CLI também verificará se algum ativo foi marcado durante as execuções anteriores do
cdk gccomando. Os ativos marcados anteriormente que estão dentro do intervalo de dias de buffer que você fornece serão excluídos.Valor padrão:
0 --typeSTRING-
O tipo de recurso bootstrap em sua pilha de bootstrap para realizar ações de coleta de lixo.
-
all— Execute ações de coleta de lixo em todos os recursos inicializados. -
ecr— Execute ações de coleta de lixo em ativos no repositório Amazon Elastic Container Registry (Amazon ECR) de sua pilha de bootstrap. -
s3— Execute ações de coleta de lixo em ativos no bucket Amazon S3 da sua pilha de bootstrap.
Valores aceitos:
all,ecr,s3Valor padrão:
all -
--unstableSTRING-
Permitir o uso do CDK CLI comandos que ainda estão em desenvolvimento.
Essa opção é necessária para usar qualquer CDK CLI comando que ainda está em desenvolvimento e sujeito a alterações.
Essa opção pode ser fornecida várias vezes em um único comando.
Para usar
cdk gc, forneça--unstable=gc.
Exemplos
Exemplos básicos
O exemplo a seguir solicita uma confirmação manual para realizar ações padrão de coleta de lixo em ativos no bucket Amazon S3 da sua pilha 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)?
O exemplo a seguir executa ações de coleta de lixo em uma variedade de ativos no bucket Amazon S3 da sua pilha de bootstrap. Esse intervalo inclui ativos que foram previamente marcados cdk gc por mais de 30 dias e foram criados com 10 dias ou mais. Esse comando solicitará a confirmação manual antes de excluir qualquer ativo:
$cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10
O exemplo a seguir executa a ação de excluir ativos previamente marcados no bucket Amazon S3 da sua pilha de bootstrap que não foram utilizados por mais de 30 dias:
$cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30
