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.
Verwenden Sie die AWS Cloud Development Kit (AWS CDK) Befehlszeilenschnittstelle (CLI) cdk gc Befehl, 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 ist das CDK CLI überprüft bestehende AWS CloudFormation Vorlagen in derselben Umgebung, um festzustellen, ob auf sie verwiesen wird. Wenn sie nicht referenziert werden, gelten sie als ungenutzt und kommen für Aktionen zur Müllabfuhr in Frage.
Warnung
Der cdk gc Befehl befindet sich in der Entwicklung für AWS CDK. Die aktuellen Funktionen dieses Befehls gelten als produktionsbereit und sicher. 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://. Beispiel,<account-id>/<region>aws://.123456789012/us-east-1Dieses Argument kann in einem einzigen Befehl mehrfach angegeben werden, um Garbage-Collection-Aktionen in mehreren Umgebungen durchzuführen.
Standardmäßig ist das CDK CLI führt 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 bereitstellen, das CDK CLI bestimmt die Umgebung anhand von Standardquellen. Zu diesen Quellen gehören Umgebungen, die Sie mithilfe der
--profileOption angeben, Umgebungsvariablen oder AWS CLI Standardquellen.
Optionen
Für eine Liste der globalen Optionen, die mit allen CDKs funktionieren CLI Befehle finden Sie unterGlobale Optionen.
--actionSTRING-
Die Aktion, die
cdk gcwä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-taggedfull,print,tagStandardwert:
full -
--bootstrap-stack-nameSTRING-
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
CDKToolkitStandard-Stacknamen verwenden, müssen Sie diese Option nicht angeben.Standardwert:
CDKToolkit --confirmBOOLEAN-
Geben Sie an, ob das CDK CLI fordert vor dem Löschen von Assets eine manuelle Bestätigung von Ihnen an.
Geben Sie
falsean, dass Assets automatisch gelöscht werden sollen, ohne dass Sie zur manuellen Bestätigung aufgefordert werden.Standardwert:
true --created-buffer-daysNUMBER-
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, -hBOOLEAN-
Zeigt Befehlsreferenzinformationen für den
cdk gcBefehl an. --rollback-buffer-daysNUMBER-
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, ist das CDK CLI kennzeichnet ungenutzte Assets mit dem aktuellen Datum, anstatt sie zu löschen. Das CDK CLI prüft auch, ob bei früheren Ausführungen des
cdk gcBefehls Assets markiert wurden. Zuvor markierte Objekte, die in den von Ihnen angegebenen Pufferbereich fallen, werden gelöscht.Standardwert:
0 --typeSTRING-
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,,ecrs3Standardwert:
all -
--unstableSTRING-
Erlaube die Verwendung von CDK CLI Befehle, die sich noch in der Entwicklung befinden.
Diese Option ist erforderlich, um ein beliebiges CDK zu verwenden CLI Befehl, der sich noch in der Entwicklung befindet und sich ändern kann.
Diese Option kann in einem einzigen Befehl mehrfach angegeben werden.
Geben Sie zur Verwendung
cdk gcan--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>... 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)?
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
