cdk drift - 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 drift

Erkennen Sie Konfigurationsabweichungen für Ressourcen, die Sie mit dem AWS Cloud Development Kit (AWS CDK) definieren, verwalten und bereitstellen. Abweichungen treten auf, wenn die tatsächliche Konfiguration eines Stacks von der erwarteten Konfiguration abweicht. Dies ist der Fall, wenn Ressourcen außerhalb von AWS CloudFormation geändert werden.

Dieser Befehl identifiziert Ressourcen, die geändert wurden (z. B. über die AWS Konsole oder AWS CLI), indem ihr aktueller Status mit ihrer erwarteten Konfiguration verglichen wird. Diese Änderungen können zu unerwartetem Verhalten in Ihrer Infrastruktur führen.

Während der Drifterkennung gibt die CDK-CLI Fortschrittsindikatoren und Ergebnisse aus, die Folgendes anzeigen:

  • Ressourcen, die von ihrer erwarteten Konfiguration abweichen.

  • Die Gesamtzahl der Ressourcen, bei denen Abweichungen auftreten.

  • Eine Zusammenfassung, die angibt, ob im Stack eine Drift festgestellt wurde.

Wichtig

Die cdk diff Befehle cdk drift und funktionieren unterschiedlich:

  • cdk driftruft den Vorgang zur Erkennung CloudFormation von Abweichungen auf, um den tatsächlichen Zustand der Ressourcen in AWS („Realität“) mit ihrer erwarteten Konfiguration in zu vergleichen CloudFormation. Nicht alle AWS Ressourcen unterstützen die Erkennung von Abweichungen. Eine Liste der unterstützten Ressourcen finden Sie im AWS CloudFormation Benutzerhandbuch unter Unterstützung für Ressourcentypen.

  • cdk diffvergleicht die aus Ihrem lokalen CDK-Code synthetisierte CloudFormation Vorlage mit der Vorlage des bereitgestellten CloudFormation Stacks.

Verwenden cdk drift Sie diese Option, wenn Sie überprüfen müssen, ob Ressourcen außerhalb CloudFormation (z. B. über die AWS Konsole oder AWS CLI) geändert wurden. Verwenden Sie diese Option, cdk diff wenn Sie vor der Bereitstellung eine Vorschau davon erhalten möchten, wie sich Ihre lokalen Codeänderungen auf Ihre Infrastruktur auswirken würden.

Verwendung

$ cdk drift <arguments> <options>

Argumente

Stack name

Der Name des Stacks, den Sie auf Drift überprüfen möchten. Der Stack muss zuvor für CloudFormation die Drifterkennung bereitgestellt werden.

Typ: Zeichenfolge

Required: No

Wenn kein Stack angegeben ist, wird die Drifterkennung für alle in Ihrer CDK-App definierten Stacks durchgeführt.

Optionen

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

--fail <BOOLEAN>

Kehren Sie mit dem Exit-Code 1 zurück, wenn eine Drift erkannt wird.

Standardwert: false

--help, -h <BOOLEAN>

Zeigt Befehlsreferenzinformationen für den cdk drift Befehl an.

Beispiele

Überprüfen Sie die Drift für einen bestimmten Stack

$ cdk drift MyStackName

Der Befehl gibt Ergebnisse aus, die den folgenden ähneln:

Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function

1 resource has drifted from their expected configuration

✨  Number of resources with drift: 1

Überprüfen Sie Drift, wenn Ressourcen gelöscht wurden

Das folgende Beispiel zeigt, wie die Ausgabe aussieht, wenn Ressourcen sowohl geändert als auch gelöscht wurden:

Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function
Deleted Resources
[-] AWS::CloudWatch::Alarm MyAlarm MyCWAlarmABCD1234

2 resources have drifted from their expected configuration

✨  Number of resources with drift: 2

Überprüfen Sie Drift mit dem Exit-Code

Damit der Befehl einen Exit-Code ungleich Null zurückgibt, wenn eine Drift erkannt wird:

$ cdk drift MyStackName --fail

Dies ist in CI/CD-Pipelines nützlich, um Infrastrukturabweichungen automatisch zu erkennen und darauf zu reagieren.