Dies ist der AWS CDK v2-Entwicklerhandbuch. Die ältere CDK Version 1 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 watch
Überwachen Sie ein lokales AWS CDK Projekt kontinuierlich auf Änderungen bei der Durchführung von Implementierungen und Hotswaps.
Dieser Befehl ähnelt dem Befehlcdk deploy
, außer dass er kontinuierliche Bereitstellungen und Hotswaps mit einem einzigen Befehl ausführen kann.
Dieser Befehl ist eine Abkürzung für. cdk deploy --watch
Um eine cdk watch
Sitzung zu beenden, unterbrechen Sie den Vorgang, indem Sie aufCtrl+C
.
Welche Dateien beobachtet werden, hängt von der "watch"
Einstellung in Ihrer cdk.json
Datei ab. Es hat zwei Unterschlüssel, "include"
und"exclude"
, das akzeptiert eine einzelne Zeichenfolge oder ein Array von Zeichenketten. Jeder Eintrag wird als Pfad relativ zum Speicherort der cdk.json
Datei interpretiert. Beides *
und **
werden akzeptiert.
Wenn Sie mit dem cdk init
Befehl ein Projekt erstellen, ist das folgende Standardverhalten cdk watch
in der cdk.json
Datei Ihres Projekts konfiguriert:
-
"include"
ist auf gesetzt"**/*"
, was alle Dateien und Verzeichnisse im Stammverzeichnis des Projekts einschließt. -
"exclude"
ist optional, mit Ausnahme von Dateien und Ordnern, die bereits standardmäßig ignoriert wurden. Dies besteht aus Dateien und Verzeichnissen, die mit.
, dem CDK-Ausgabeverzeichnis und demnode_modules
Verzeichnis beginnen.
Die zu konfigurierende Mindesteinstellung watch
ist"watch": {}
.
Wenn entweder Ihr CDK-Code oder Ihr Anwendungscode vor der Bereitstellung einen Build-Schritt erfordert, cdk watch
funktioniert er mit dem "build"
Schlüssel in der cdk.json
Datei.
Anmerkung
Dieser Befehl gilt als experimentell und könnte in future grundlegende Änderungen haben.
Die gleichen Einschränkungen von cdk deploy --hotswap
gelten fürcdk watch
. Weitere Informationen finden Sie unter cdk deploy --hotswap
.
Verwendung
$
cdk watch
<arguments>
<options>
Argumente
- Logische ID des CDK-Stacks
-
Die logische ID des CDK-Stacks aus Ihrer App, die Sie sich ansehen möchten.
Typ: Zeichenfolge
Required: No
Optionen
Eine Liste der globalen Optionen, die mit allen CLI CDK-Befehlen funktionieren, finden Sie unter. Globale Optionen
--build-exclude, -E
ARRAY
-
Das Asset mit der angegebenen ID darf nicht neu erstellt werden.
Diese Option kann in einem einzigen Befehl mehrfach angegeben werden.
Standardwert:
[]
--change-set-name
STRING
-
Der Name des zu erstellenden CloudFormation Änderungssatzes.
--concurrency
NUMBER
-
Stellen Sie mehrere Stacks parallel bereit und tauschen Sie sie per Hotswap aus, wobei die Abhängigkeiten zwischen den Stacks berücksichtigt werden. Verwenden Sie diese Option, um Bereitstellungen zu beschleunigen. Sie müssen immer noch andere CloudFormation AWS-Konto Ratenbegrenzungen berücksichtigen.
Geben Sie eine Zahl ein, um die maximale Anzahl gleichzeitiger Bereitstellungen anzugeben (sofern die Abhängigkeit dies zulässt).
Standardwert:
1
--exclusively, -e
BOOLEAN
-
Stellen Sie nur angeforderte Stacks bereit und schließen Sie keine Abhängigkeiten ein.
--force, -f
BOOLEAN
-
Stellen Sie immer Stacks bereit, auch wenn die Vorlagen identisch sind.
Standardwert:
false
--help, -h
BOOLEAN
-
Zeigt Befehlsreferenzinformationen für den
cdk watch
Befehl an. --hotswap
BOOLEAN
-
cdk watch
Verwendet standardmäßig Hotswap-Bereitstellungen, wenn möglich, um Ihre Ressourcen zu aktualisieren. Das CDK CLI versucht, eine Hotswap-Bereitstellung durchzuführen, und greift nicht auf eine vollständige Bereitstellung zurück, wenn dies nicht erfolgreich ist. CloudFormation Alle erkannten Änderungen, die nicht über einen Hotswap aktualisiert werden können, werden ignoriert.Standardwert:
true
--hotswap-fallback
BOOLEAN
-
cdk watch
Versucht standardmäßig, Hotswap-Bereitstellungen durchzuführen, und ignoriert Änderungen, die Bereitstellungen erfordern. CloudFormation Stellen Sie sicher--hotswap-fallback
, dass Sie auf eine vollständige Bereitstellung zurückgreifen und eine vollständige CloudFormation Bereitstellung durchführen können, falls die Hotswap-Bereitstellung nicht erfolgreich ist. --logs
BOOLEAN
-
cdk watch
Überwacht standardmäßig alle CloudWatch Protokollgruppen in Ihrer Anwendung und streamt die Protokollereignisse lokal an.stdout
Standardwert:
true
--progress
STRING
-
Konfigurieren Sie, wie das CDK den Bereitstellungsfortschritt CLI anzeigt.
-
bar
— Zeigt Ereignisse bei der Stack-Bereitstellung als Fortschrittsbalken an, zusammen mit den Ereignissen für die Ressource, die gerade bereitgestellt wird. -
events
— Stellen Sie einen vollständigen Verlauf bereit, einschließlich aller CloudFormation Ereignisse.
Sie können diese Option auch in der
cdk.json
Projektdatei oder~/.cdk.json
auf Ihrem lokalen Entwicklungscomputer konfigurieren:{ "progress": "events" }
Zulässige Werte:
bar
,events
Standardwert:
bar
-
--rollback
BOOLEAN
-
Wenn während der Bereitstellung eine Ressource nicht erstellt oder aktualisiert werden kann, wird die Bereitstellung auf den letzten stabilen Status zurückgesetzt, bevor das CDK CLI zurückkehrt. Alle bis zu diesem Zeitpunkt vorgenommenen Änderungen werden rückgängig gemacht. Ressourcen, die erstellt wurden, werden gelöscht und vorgenommene Aktualisierungen werden rückgängig gemacht.
Verwenden Sie
--no-rollback
oder-R
, um dieses Verhalten zu deaktivieren. Wenn eine Ressource nicht erstellt oder aktualisiert werden kann, behält das CDK CLI die bis zu diesem Zeitpunkt vorgenommenen Änderungen bei und kehrt zurück. Dies kann in Entwicklungsumgebungen hilfreich sein, in denen Sie schnell iterieren.Anmerkung
Wann werden Bereitstellungen
false
, die zu einem Austausch von Ressourcen führen, immer fehlschlagen. Sie können diesen Wert nur für Bereitstellungen verwenden, die neue Ressourcen aktualisieren oder erstellen.Standardwert:
true
--toolkit-stack-name
STRING
-
Der Name des vorhandenen CDK Toolkit-Stacks.
Diese Option wird nur für CDK-Apps verwendet, die Legacy-Synthese verwenden.
Beispiele
Beobachten Sie einen CDK-Stack mit logischer ID DevelopmentStack auf Änderungen
$
cdk watch DevelopmentStack
Detected change to 'lambda-code/index.js' (type: change). Triggering 'cdk deploy' DevelopmentStack: deploying... ✅ DevelopmentStack
Konfigurieren Sie in einer cdk.json-Datei, welche Elemente aufgenommen und von der Überwachung auf Änderungen ausgeschlossen werden sollen
{ "app": "mvn -e -q compile exec:java", "watch": { "include": "src/main/**", "exclude": "target/*" } }
Erstellen Sie Java vor der Bereitstellung ein CDK-Projekt, indem Sie die Datei cdk.json konfigurieren
{ "app": "mvn -e -q exec:java", "build": "mvn package", "watch": { "include": "src/main/**", "exclude": "target/*" } }