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 flags
Zeigen Sie Ihre Feature-Flag-Konfigurationen für die CDK-CLI an und ändern Sie sie.
Feature-Flags steuern das Verhalten der CDK-CLI und Sie können sie verwenden, um bestimmte Funktionen zu aktivieren oder zu deaktivieren. Verwenden Sie den cdk flags Befehl, um Ihre aktuellen Feature-Flag-Konfigurationen anzuzeigen und sie nach Bedarf zu ändern.
Warnung
Der cdk flags Befehl wird derzeit für das AWS CDK entwickelt. 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=flags Option zur Verwendung dieses Befehls angeben.
Verwendung
$ cdk flags <arguments> <options>
Argumente
- NAME DER FLAGGE
-
Der Name des spezifischen Feature-Flags, das Sie anzeigen oder ändern möchten.
Typ: Zeichenfolge
Required: No
Optionen
Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter Globale Optionen.
-
--set <BOOLEAN> -
Ändern Sie eine Feature-Flag-Konfiguration.
-
--all <BOOLEAN> -
Alle Feature-Flags ändern oder anzeigen.
-
--recommended <BOOLEAN> -
Ändern Sie die Flaggen auf empfohlene Status.
-
--default <BOOLEAN> -
Ändern Sie die Flaggen auf Standardstatus.
-
--unconfigured <BOOLEAN> -
Ändern Sie nicht konfigurierte Feature-Flags.
-
--value <STRING> -
Der Wert, auf den die Feature-Flag-Konfiguration gesetzt werden soll.
Erfordert ARG: true
-
--safe <BOOLEAN> -
Aktivieren Sie alle Feature-Flags, die sich nicht auf Ihre Anwendung auswirken.
-
--interactive, -i <BOOLEAN> -
Interaktive Option für den Befehl flags.
Beispiele
Feature-Flag-Konfigurationen anzeigen
Starten Siecdk flags, um einen Bericht über Ihre Feature-Flag-Konfigurationen anzuzeigen, die von unseren empfohlenen Status abweichen. Nicht konfigurierte Flags sind mit gekennzeichnet<unset>, um darauf hinzuweisen, dass das Flag derzeit keinen Wert hat. Die Flags werden in der folgenden Reihenfolge angezeigt:
-
Flaggen, die auf einen Wert gesetzt sind, der nicht unserem empfohlenen Wert entspricht
-
Flags, die Sie nicht konfiguriert haben
$ cdk flags --unstable=flags Feature Flag Recommended User * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
Sie können auch ausführencdk flags --all, um einen Bericht mit allen Feature-Flags in der folgenden Reihenfolge anzuzeigen:
-
Flags sind auf einen Wert gesetzt, der unserem empfohlenen Wert entspricht
-
Flaggen, die auf einen Wert gesetzt sind, der nicht unserem empfohlenen Wert entspricht
-
Flags, die Sie nicht konfiguriert haben
$ cdk flags --unstable=flags --all Feature Flag Recommended User @aws-cdk/... true true * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
Ändern Sie Feature-Flag-Werte
Um Ihre Feature-Flags interaktiv zu ändern, führen Sie den Befehl cdk flags --interactive (odercdk flags -i) aus, um eine Liste mit Menüoptionen anzuzeigen.
Führen cdk flags --set --recommended --all Sie den Befehl aus, um alle Feature-Flags auf unseren empfohlenen Wert zu ändern. Mit diesem Befehl wird Ihre Feature-Flag-Konfiguration up-to-date mit den neuesten CDK-Feature-Flag-Konfigurationen beibehalten. Beachten Sie, dass die Ausführung dieses Befehls möglicherweise vorhandene konfigurierte Werte überschreiben kann.
$ cdk flags --unstable=flags --set --recommended --all Feature Flag Recommended Value User Value * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset> Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
Wenn Sie den Status Ihrer vorhandenen konfigurierten Flags beibehalten möchten, führen cdk flags --set --recommended --unconfigured Sie den Befehl aus. Diese Option ändert nur die unkonfigurierten Feature-Flags auf unsere empfohlenen Werte.
$ cdk flags --unstable=flags --set --recommended --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true <unset> * @aws-cdk/... true <unset> Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ├─ [-] None └─ [+] ServerSideEncryptionConfiguration: - ... ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
Wenn Sie sicherstellen möchten, dass nicht konfigurierte Feature-Flags Ihre Anwendung nicht beeinträchtigen, führen Sie den cdk flags --set --default --unconfigured Befehl aus, um die unkonfigurierten Flags auf ihre Standardwerte zu ändern. Wenn er beispielsweise nicht konfiguriert @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 ist, wird nach der Ausführung eine Benachrichtigung angezeigt. cdk synth Wenn Sie das Flag jedoch auf den Standardstatus (false) setzen, wird es konfiguriert und deaktiviert und hat keine Auswirkungen auf Ihre Anwendung.
$ cdk flags --unstable=flags --set --default --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true <unset> * @aws-cdk/... true <unset> Synthesizing... Do you want to accept these changes? (y/n) y Resynthesizing...
Untersuchen Sie bestimmte Feature-Flags
Weitere Informationen zu einer Flagge anzeigen
Neben dem Ausführen cdk flags und cdk flags --all Anzeigen Ihrer Feature-Flag-Konfiguration können Sie auch ein bestimmtes Feature-Flag überprüfen und herausfinden, was das Flag bewirkt. cdk flags "FLAGNAME" Dies kann in Fällen hilfreich sein, in denen Sie ein bestimmtes Flag und seine Auswirkungen auf Ihre Anwendung verstehen möchten.
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default. Recommended Value: true User Value: true
Filtern Sie Flags nach einer Teilzeichenfolge
Sie können auch ausführencdk flags substring, um alle passenden Feature-Flags anzuzeigen. Wenn es nur ein Feature-Flag gibt, das dieser Teilzeichenfolge entspricht, werden spezifische Details angezeigt.
$ cdk flags --unstable=flags ebs @aws-cdk/aws-ec2:ebsDefaultGp3Volume Description: When enabled, the default volume type of the EBS volume will be GP3 Recommended Value: true User Value: true
Wenn mehrere Flags mit der Teilzeichenfolge übereinstimmen, werden alle passenden Flags in einer Tabelle angezeigt. Wenn Sie mehrere Teilzeichenfolgen eingeben, werden alle passenden Flags zurückgegeben, die eine der Teilzeichenfolgen enthalten.
$ cdk flags --unstable=flags s3 lambda Feature Flag Recommended User * @aws-cdk/s3... true false * @aws-cdk/lambda... true false * @aws-cdk/lambda... true <unset>
Ändern Sie ein bestimmtes Kennzeichen
Wenn Sie den Wert einer Markierung ändern müssen und sicherstellen möchten, dass Sie sie auf einen korrekten und unterstützten Status setzen, führen Sie den Befehl auscdk flags --set "FLAGNAME" --value="state".
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true" Synthesizing... Resources [~] AWS::CloudFront::Distribution MyDistribution └─ [~] Properties └─ [~] DefaultSecurityPolicy ├─ [-] TLSv1.0 └─ [+] TLSv1.2_2021 - ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
