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

Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 in die Wartung aufgenommen und der Support wurde am 1. Juni 2023 eingestellt.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

cdk gc

Verwenden Sie den Befehl AWS Cloud Development Kit (AWS CDK) über die Befehlszeilenschnittstelle (CLI)cdk gc, um ungenutzte Assets, die in den Ressourcen Ihres Bootstrap-Stacks gespeichert sind, zu löschen. Verwenden Sie diesen Befehl, um nicht mehr benötigte Assets anzuzeigen, zu verwalten und zu löschen.

Für Amazon Simple Storage Service (Amazon S3) -Assets überprüft die CDK-CLI vorhandene AWS CloudFormation Vorlagen in derselben Umgebung, um festzustellen, ob auf sie verwiesen wird. Wenn sie nicht referenziert werden, gelten sie als unbenutzt und kommen für Müllabfuhr in Frage.

Warnung

Der cdk gc Befehl befindet sich in der Entwicklung für das AWS CDK. Die aktuellen Funktionen dieses Befehls gelten als produktionsbereit und sicher in der Anwendung. Der Umfang dieses Befehls und seine Funktionen können sich jedoch ändern. Daher müssen Sie sich anmelden, indem Sie die unstable=gc Option zur Verwendung dieses Befehls angeben.

Verwendung

$ cdk gc <arguments> <options>

Argumente

AWS Umgebung

Die AWS Zielumgebung, in der Aktionen zur Müllabfuhr ausgeführt werden sollen.

Verwenden Sie bei der Bereitstellung einer Umgebung das folgende Format:aws://<account-id>/<region>. Beispiel, aws://<123456789012>/<us-east-1>.

Dieses Argument kann in einem einzigen Befehl mehrfach angegeben werden, um Garbage-Collection-Aktionen in mehreren Umgebungen durchzuführen.

Standardmäßig führt die CDK-CLI Garbage-Collection-Aktionen in allen Umgebungen durch, auf die Sie in Ihrer CDK-App verweisen oder die Sie als Argumente angeben. Wenn Sie keine Umgebung angeben, bestimmt die CDK-CLI die Umgebung anhand von Standardquellen. Zu diesen Quellen gehören Umgebungen, die Sie mit der --profile Option angeben, Umgebungsvariablen oder AWS Standard-CLI-Quellen.

Optionen

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter Globale Optionen.

--action <STRING>

Die Aktion, die cdk gc während einer Garbage-Collection auf Ihre Assets angewendet wird.

  • delete-tagged— Löscht Assets, die mit einem Datum innerhalb der von Ihnen angegebenen Puffertage gekennzeichnet wurden. Neu identifizierte ungenutzte Assets werden jedoch nicht markiert.

  • full— Führt alle Aktionen zur Müllabfuhr durch. Dazu gehören das Löschen von Assets innerhalb der von Ihnen angegebenen Puffertage und das Markieren neu identifizierter ungenutzter Assets.

  • print— Gibt die Anzahl der ungenutzten Objekte in der Befehlszeile aus, nimmt jedoch keine tatsächlichen Änderungen in Ihrer AWS Umgebung vor.

  • tag— Kennzeichnet alle neu identifizierten ungenutzten Ressourcen, löscht jedoch keine Objekte innerhalb des von Ihnen angegebenen Puffer-Tagebereichs.

Zulässige Werte:delete-tagged,full,print, tag

Standardwert: full

--bootstrap-stack-name <STRING>

Der Name des CDK-Bootstrap-Stacks in Ihrer AWS Umgebung. Geben Sie diese Option an, wenn Sie den Namen Ihres Bootstrap-Stacks angepasst haben. Wenn Sie den CDKToolkit Standard-Stacknamen verwenden, müssen Sie diese Option nicht angeben.

Standardwert: CDKToolkit

--confirm <BOOLEAN>

Geben Sie an, ob die CDK-CLI vor dem Löschen von Assets eine manuelle Bestätigung von Ihnen anfordert.

Geben Sie false an, dass Assets automatisch gelöscht werden sollen, ohne dass Sie zur manuellen Bestätigung aufgefordert werden.

Standardwert: true

--created-buffer-days <NUMBER>

Gibt an, wie viele Tage ein Asset existieren muss, bevor es für Müllabfuhr in Frage kommt.

Wenn Sie eine Zahl angeben, werden Assets, die nach der von Ihnen angegebenen Anzahl von Tagen noch nicht existiert haben, aus den Aktionen zur Müllabfuhr herausgefiltert.

Standardwert: 1

--help, -h <BOOLEAN>

Zeigt Befehlsreferenzinformationen für den cdk gc Befehl an.

--rollback-buffer-days <NUMBER>

Die Anzahl der Tage, an denen ein Asset als isoliert gekennzeichnet werden muss, bevor es für Müllabfuhr in Frage kommt.

Wenn Sie eine Nummer angeben, kennzeichnet die CDK-CLI ungenutzte Assets mit dem aktuellen Datum, anstatt sie zu löschen. Die CDK-CLI überprüft auch, ob bei früheren Ausführungen des cdk gc Befehls Assets markiert wurden. Zuvor markierte Assets, die in den von Ihnen angegebenen Bereich der Puffertage fallen, werden gelöscht.

Standardwert: 0

--type <STRING>

Der Bootstrap-Ressourcentyp in Ihrem Bootstrap-Stack, für den Garbage-Collection-Aktionen ausgeführt werden sollen.

  • all— Führen Sie Garbage-Collection-Aktionen für alle Bootstrap-Ressourcen durch.

  • ecr— Führen Sie Garbage-Collection-Aktionen für Assets im Amazon Elastic Container Registry (Amazon ECR) -Repository Ihres Bootstrap-Stacks durch.

  • s3— Führen Sie Garbage-Collection-Aktionen für Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks durch.

Zulässige Werte:all,, ecr s3

Standardwert: all

--unstable <STRING>

Erlauben Sie die Verwendung von CDK-CLI-Befehlen, die sich noch in der Entwicklung befinden.

Diese Option ist erforderlich, um alle CDK-CLI-Befehle zu verwenden, die sich noch in der Entwicklung befinden und sich ändern können.

Diese Option kann in einem einzigen Befehl mehrfach bereitgestellt werden.

Geben Sie zur Verwendung cdk gc an--unstable=gc.

Beispiele

Grundlegende Beispiele

Im folgenden Beispiel werden Sie zur manuellen Bestätigung aufgefordert, um die standardmäßigen Garbage-Collection-Aktionen für Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks durchzuführen:

$ 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)?

Im folgenden Beispiel werden Garbage-Collection-Aktionen für eine Reihe von Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks ausgeführt. Dieser Bereich umfasst Assets, die zuvor mehr als 30 Tage lang markiert wurden und die 10 Tage oder älter erstellt wurden. cdk gc Mit diesem Befehl werden Sie vor dem Löschen von Assets zur manuellen Bestätigung aufgefordert:

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

Im folgenden Beispiel werden zuvor markierte Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks gelöscht, die länger als 30 Tage nicht verwendet wurden:

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