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 bootstrap
Bereiten Sie eine AWS Umgebung für CDK Bereitstellungen vor, indem Sie den CDK Bootstrap-Stack (genanntCDKToolkit
) in der Umgebung bereitstellen. AWS
Der Bootstrap-Stack ist ein CloudFormation Stack, der einen Amazon S3 S3-Bucket und ein ECR Amazon-Repository in der AWS Umgebung bereitstellt. Der AWS CDK CLI verwendet diese Ressourcen, um während der Bereitstellung synthetisierte Vorlagen und zugehörige Ressourcen zu speichern.
Verwendung
$
cdk bootstrap
<arguments>
<options>
Argumente
- AWS Umgebung
-
Die AWS Zielumgebung, in der der Bootstrap-Stack bereitgestellt werden soll, im folgenden Format:
aws://<account-id>/<region>
.Beispiel:
aws://123456789012/us-east-1
Dieses Argument kann in einem einzigen Befehl mehrfach angegeben werden, um den Bootstrap-Stack in mehreren Umgebungen bereitzustellen.
Standardmäßig ist der CDK CLI bootet alle Umgebungen, auf die in der CDK App verwiesen wird, oder ermittelt eine Umgebung anhand von Standardquellen. Dies kann eine Umgebung sein, die mit der
--profile
Option angegeben wurde, aus Umgebungsvariablen oder AWS CLI Standardquellen.
Optionen
Für eine Liste globaler Optionen, die mit allen funktionieren CDK CLI Befehle finden Sie unterGlobale Optionen.
--bootstrap-bucket-name, --toolkit-bucket-name, -b
STRING
-
Der Name des Amazon S3 S3-Buckets, der von der verwendet wird CDK CLI. Dieser Bucket wird erstellt und darf derzeit nicht existieren.
Geben Sie diese Option an, um den Standardnamen des Amazon S3 S3-Buckets zu überschreiben.
Wenn Sie diese Option verwenden, müssen Sie die Synthese möglicherweise anpassen. Weitere Informationen hierzu finden Sie unter Passen Sie die CDK Stacksynthese an.
Standardwert: Undefiniert
--bootstrap-customer-key
BOOLEAN
-
Erstellen Sie einen Kundenhauptschlüssel (CMK) für den Bootstrap-Bucket (es wird Ihnen eine Gebühr berechnet, Sie können jedoch die Berechtigungen anpassen, nur modernes Bootstrapping).
Diese Option ist nicht kompatibel mit.
--bootstrap-kms-key-id
Standardwert: Undefiniert
--bootstrap-kms-key-id
STRING
-
Die AWS KMS Masterkey-ID, die verwendet werden soll für SSE-KMS Verschlüsselung.
Stellen Sie diese Option bereit, um den AWS KMS Standardschlüssel zu überschreiben, der zum Verschlüsseln des Amazon S3 S3-Buckets verwendet wird.
Diese Option ist nicht kompatibel mit
--bootstrap-customer-key
.Standardwert: Undefiniert
--cloudformation-execution-policies
ARRAY
-
Die verwaltete IAM RichtlinieARNs, die der Bereitstellungsrolle zugewiesen werden sollte, die bei AWS CloudFormation der Bereitstellung Ihrer Stacks übernommen wurde.
Standardmäßig werden Stacks mithilfe der Richtlinie mit vollen Administratorrechten bereitgestellt.
AdministratorAccess
Sie können diese Option in einem einzigen Befehl mehrfach angeben. Sie können ARNs auch mehrere in einer einzigen Zeichenfolge angeben, wobei die einzelnen durch Kommas ARNs getrennt werden. Im Folgenden wird ein Beispiel gezeigt:
$
cdk bootstrap --cloudformation-execution-policies
"arn:aws:iam::aws:policy/AWSLambda_FullAccess,arn:aws:iam::aws:policy/AWSCodeDeployFullAccess"
Um Bereitstellungsfehler zu vermeiden, stellen Sie sicher, dass die von Ihnen angegebenen Richtlinien für alle Bereitstellungen, die Sie in der Umgebung durchführen, für die das Bootstrapping ausgeführt wird, ausreichend sind.
Diese Option gilt nur für modernes Bootstrapping.
Wichtig
Die moderne Bootstrap-Vorlage gewährt praktisch jedem AWS Konto in der Liste die in der
--cloudformation-execution-policies
Liste enthaltenen Berechtigungen.--trust
Standardmäßig werden dadurch die Lese- und Schreibberechtigungen für alle Ressourcen im Bootstrap-Konto erweitert. Stellen Sie sicher, dass Sie den Bootstrapping-Stack mit Richtlinien und vertrauenswürdigen Konten konfigurieren, mit denen Sie vertraut sind.Standardwert:
[]
--custom-permissions-boundary, -cpb
STRING
-
Geben Sie den Namen einer zu verwendenden Berechtigungsgrenze an.
Diese Option ist nicht kompatibel mit
--example-permissions-boundary
.Standardwert: Undefiniert
--example-permissions-boundary, -epb
BOOLEAN
-
Verwenden Sie das Beispiel für die Berechtigungsgrenze, die von der AWS CDK bereitgestellt wird.
Diese Option ist nicht kompatibel mit
--custom-permissions-boundary
.Die CDK mitgelieferte Grenzrichtlinie für Berechtigungen sollte als Beispiel betrachtet werden. Bearbeiten Sie den Inhalt und verweisen Sie auf die Beispielrichtlinie, wenn Sie die Funktion testen. Wandeln Sie sie in eine neue Richtlinie für tatsächliche Bereitstellungen um, falls noch keine vorhanden ist. Es geht darum, Abweichungen zu vermeiden. Höchstwahrscheinlich wird eine Rechtegrenze beibehalten und es gibt spezielle Konventionen, einschließlich der Benennung.
Weitere Informationen zur Konfiguration von Berechtigungen, einschließlich der Verwendung von Rechtegrenzen, finden Sie im Security and Safety Dev Guide
. Standardwert: Undefiniert
--execute
BOOLEAN
-
Konfigurieren Sie, ob der Änderungssatz ausgeführt werden soll.
Standardwert:
true
--force, -f
BOOLEAN
-
Führen Sie immer Bootstrap durch, auch wenn dadurch die Bootstrap-Vorlagenversion herabgestuft würde.
Standardwert:
false
--help, -h
BOOLEAN
-
Zeigt die Befehlsreferenzinformationen für den Befehl an.
cdk bootstrap
--previous-parameters
BOOLEAN
-
Verwenden Sie vorherige Werte für vorhandene Parameter.
Sobald eine Bootstrap-Vorlage mit einer Reihe von Parametern bereitgestellt wurde, müssen Sie diese Option auf setzen,
false
um alle Parameter bei future Bereitstellungen zu ändern. Wennfalse
, müssen Sie alle zuvor angegebenen Parameter erneut angeben.Standardwert:
true
--public-access-block-configuration
BOOLEAN
-
Blockieren Sie die öffentliche Zugriffskonfiguration für den Amazon S3 S3-Bucket, der erstellt und verwendet wird von CDK CLI.
Standardwert:
true
--qualifier
STRING
-
Neunstelliger Zeichenkettenwert, der für jeden Bootstrap-Stack eindeutig ist. Dieser Wert wird zur physischen ID der Ressourcen im Bootstrap-Stack hinzugefügt.
Durch die Bereitstellung eines Qualifizierers vermeiden Sie Konflikte bei Ressourcennamen, wenn Sie mehrere Bootstrap-Stacks in derselben Umgebung bereitstellen.
Wenn Sie den Qualifier ändern, muss Ihre CDK App den geänderten Wert an den Stack-Synthesizer übergeben. Weitere Informationen finden Sie unter Passen Sie die CDK Stacksynthese an.
Standardwert:
hnb659fds
. Dieser Wert hat keine Bedeutung. --show-template
BOOLEAN
-
Anstatt Bootstrapping durchzuführen, drucken Sie die aktuelle Bootstrap-Vorlage auf die Standardausgabe ().
stdout
Anschließend können Sie die Vorlage kopieren und nach Bedarf anpassen.Standardwert:
false
-
Tags, die dem Bootstrap-Stack hinzugefügt werden sollen, im Format von
KEY=VALUE
.Standardwert:
[]
--template
STRING
-
Verwenden Sie die Vorlage aus der angegebenen Datei anstelle der integrierten.
--termination-protection
BOOLEAN
-
Schalten Sie den AWS CloudFormation Terminierungsschutz auf dem Bootstrap-Stack um.
Wann ist
true
der Kündigungsschutz aktiviert. Dadurch wird verhindert, dass der Bootstrap-Stack versehentlich gelöscht wird.Weitere Informationen zum Kündigungsschutz finden Sie im AWS CloudFormation Benutzerhandbuch unter Einen Stack vor dem Löschen schützen.
Standardwert: Undefiniert
--toolkit-stack-name
STRING
-
Der Name des zu erstellenden Bootstrap-Stacks.
cdk bootstrap
Stellt standardmäßig einen Stack mit dem NamenCDKToolkit
in der angegebenen AWS Umgebung bereit. Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.Der CDK CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.
Standardwert:
CDKToolkit
Erforderlich: Ja
--trust
ARRAY
-
Diejenige AWS-Konto IDs, der bei der Durchführung von Bereitstellungen in dieser Umgebung vertraut werden sollte.
Dem Konto, das das Bootstrapping durchführt, wird immer vertraut.
Diese Option erfordert, dass Sie auch Folgendes angeben.
--cloudformation-execution-policies
Sie können diese Option in einem einzigen Befehl mehrfach angeben.
Diese Option gilt nur für modernes Bootstrapping.
Um vertrauenswürdige Konten zu einem vorhandenen Bootstrap-Stack hinzuzufügen, müssen Sie alle Konten angeben, denen Sie vertrauen möchten, einschließlich der Konten, die Sie möglicherweise zuvor angegeben haben. Wenn Sie nur neue Konten angeben, denen Sie vertrauen können, werden die zuvor vertrauenswürdigen Konten entfernt.
Im Folgenden finden Sie ein Beispiel, bei dem zwei Konten als vertrauenswürdig eingestuft werden:
$
cdk bootstrap
⏳ Bootstrapping environment aws://123456789012/us-west-2... Trusted accounts for deployment: 234567890123, 987654321098 Trusted accounts for lookup: (none) Execution policies: arn:aws:iam::aws:policy/AdministratorAccess CDKToolkit: creating CloudFormation changeset... ✅ Environment aws://123456789012/us-west-2 bootstrapped.aws://123456789012/us-west-2
--trust234567890123
--trust987654321098
--cloudformation-execution-policiesarn:aws:iam::aws:policy/AdministratorAccess
Wichtig
Die moderne Bootstrap-Vorlage gewährt praktisch jedem AWS Konto in der Liste die in der
--cloudformation-execution-policies
Liste enthaltenen Berechtigungen.--trust
Standardmäßig werden dadurch die Lese- und Schreibberechtigungen für alle Ressourcen im Bootstrap-Konto erweitert. Stellen Sie sicher, dass Sie den Bootstrapping-Stack mit Richtlinien und vertrauenswürdigen Konten konfigurieren, mit denen Sie vertraut sind.Standardwert:
[]
--trust-for-lookup
ARRAY
-
Dem sollte vertraut werden AWS-Konto IDs, wenn es darum geht, Werte in dieser Umgebung nachzuschlagen.
Verwenden Sie diese Option, um Konten die Erlaubnis zu erteilen, Stacks zu synthetisieren, die in der Umgebung bereitgestellt werden, ohne ihnen tatsächlich die Erlaubnis zu geben, diese Stacks direkt bereitzustellen.
Sie können diese Option in einem einzigen Befehl mehrfach angeben.
Diese Option gilt nur für modernes Bootstrapping.
Standardwert:
[]
Beispiele
Bootstrap für die im AWS Produktprofil angegebene Umgebung
$
cdk bootstrap --profile prod
Stellen Sie den Bootstrap-Stack in den Umgebungen foo und bar bereit
$
cdk bootstrap --app='node bin/main.js' foo bar
Exportieren Sie die Bootstrap-Vorlage, um sie anzupassen
Wenn Sie spezielle Anforderungen haben, die von der Bootstrap-Vorlage nicht erfüllt werden, können Sie sie an Ihre Bedürfnisse anpassen.
Sie können die Bootstrap-Vorlage exportieren, ändern und mithilfe dieser Methode bereitstellen. AWS CloudFormation Im Folgenden finden Sie ein Beispiel für den Export der vorhandenen Vorlage:
$
cdk bootstrap --show-template > bootstrap-template.yaml
Sie können auch erkennen CDK CLI um eine benutzerdefinierte Vorlage zu verwenden. Im Folgenden wird ein Beispiel gezeigt:
$
cdk bootstrap --template my-bootstrap-template.yaml
Bootstrap mit einer Rechtegrenze. Entfernen Sie dann diese Berechtigungsgrenze
Um mit einer benutzerdefinierten Berechtigungsgrenze zu booten, führen wir Folgendes aus:
$
cdk bootstrap --custom-permissions-boundary my-permissions-boundary
Um die Berechtigungsgrenze zu entfernen, führen wir Folgendes aus:
$
cdk bootstrap --no-previous-parameters
Verwenden Sie einen Qualifier, um Ressourcen zu unterscheiden, die für eine Entwicklungsumgebung erstellt wurden
$
cdk bootstrap --qualifier dev2024