Referenz für CloudFormation-Hilfsskripts - AWS CloudFormation

Dies ist das neue CloudFormation Template Reference Guide. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im AWS CloudFormationBenutzerhandbuch.

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.

Referenz für CloudFormation-Hilfsskripts

CloudFormation stellt die folgenden Python-Hilfsskripte zur Verfügung, die Sie verwenden können, um Software zu installieren und Dienste auf einer Amazon EC2-Instance zu starten, die Sie als Teil Ihres Stacks erstellen:

  • cfn-init- Zum Abrufen und Interpretieren von Ressourcen-Metadaten, Installieren von Paketen, Erstellen von Dateien und Starten von Diensten.

  • cfn-signal- Signalisieren Sie mit CreationPolicy oder,WaitCondition damit Sie andere Ressourcen im Stapel synchronisieren können, wenn die erforderliche Ressource oder Anwendung bereit ist.

  • cfn-get-metadata- Zum Abrufen von Metadaten für eine Ressource oder eines Pfads zu einem bestimmten Schlüssel.

  • cfn-hup- Verwenden Sie diese Option, um nach Aktualisierungen von Metadaten zu suchen und benutzerdefinierte Hooks auszuführen, wenn Änderungen entdeckt werden.

Sie können die Skripts direkt aus Ihrer Vorlage aufrufen. Die Skripts funktionieren in Verbindung mit Ressourcen-Metadaten, die in derselben Vorlage festgelegt werden. Die Skripts laufen in der Amazon EC2-Instance während der Stack-Erstellung.

Anmerkung

Die Skripts werden nicht standardmäßig ausgeführt. Sie müssen in Ihrer Vorlage Aufrufe zur Ausführung bestimmter Hilfsskripts einschließen.

Amazon Linux-AMI-Bilder

Die CloudFormation-Hilfsskripts sind auf Amazon-Linux-AMI-Images vorinstalliert, auf denen Bootstrap-Skripts installiert sind.

  • Bei der neuesten Version von Amazon Linux-AMI sind die Skripts in installiert /opt/aws/bin.

  • Bei früheren Amazon Linux AMI-Versionen befindet sich das aws-cfn-bootstrap-Paket, das die Skripte enthält, im Yum-Repository.

Anmerkung

Die Hilfsskripte sind bei neueren Versionen des Amazon-Linux-AMI vorinstalliert und nicht bei optimierten AMIs wie ECS Optimized Image, die Amazon Linux als Basis verwenden.

Herunterladen von Paketen für andere Plattformen

Für andere Linux/Unix-Distributionen als Amazon Linux AMI-Images und für Microsoft Windows (2008 oder später) können Sie das Paket aws-cfn-bootstrap herunterladen.

Anmerkung

Version 2.01–1 und höher der Hilfsskripts unterstützen Python 3.4 und höher. Wenn Sie Hilfsskripte benötigen, die eine frühere Version von Python unterstützen, lesen Sie den Versionsverlauf für CloudFormation Helper Scripts 1.4.

Dateiformat URL herunterladen

TAR.GZ

https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-latest.tar.gz

Installieren Sie tar.gzmit dem Python-Programm pip. Um die Installation für Ubuntu abzuschließen, müssen Sie einen symlink erstellen:

ln -s /<path-to-extracted-tar>/aws-cfn-bootstrap-2.0/init/ubuntu/cfn-hup /etc/init.d/cfn-hup

ZIP

https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-latest.zip

EXE

Windows 32-Bit: https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-latest.exe

Windows 64-Bit: https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-py3-win64-latest.exe

Berechtigungen für Helferobjektskripte

Standardmäßig erfordern Hilfsskripts keine Anmeldeinformationen; die Optionen --access-key, --secret-key, --role oder --credential-file müssen also nicht verwendet werden. Wenn jedoch keine Anmeldeinformationen angegeben werden, prüft CloudFormation auf Stack-Mitgliedschaft und schränkt den Geltungsbereich des Aufrufs desjenigen Stacks ein, zu dem die Instance gehört.

Wenn Sie eine Option angeben möchten, empfehlen wir, dass Sie nur eine der Folgenden angeben:

  • --role

  • --credential-file

  • --access-key zusammen mit --secret-key

Wenn Sie eine Option angeben, beachten Sie, welche Berechtigungen die verschiedenen Helferobjektskripte erfordern:

  • cfn-signal erfordert cloudformation:SignalResource

  • Alle anderen Hilfsskripte erfordern cloudformation:DescribeStackResource

Weitere Informationen zur Verwendung von CloudFormation-spezifischen Aktionen und Bedingungskontextschlüsseln in IAM-Richtlinien finden Sie unter Steuerung des CloudFormation-Zugriffs mit AWS Identity and Access Management im AWS CloudFormation Benutzerhandbuch.

Verwenden der neuesten Version

Die Hilfsskripte werden regelmäßig aktualisiert. Wenn Sie die Hilfsskripts verwenden, müssen Sie sicherstellen, dass Ihre gestarteten Instances neueste Version der Skripts verwenden:

  • Fügen Sie den folgenden Befehl in die UserData Eigenschaft Ihrer Vorlage ein, bevor Sie die Skripts aufrufen. Mit diesem Befehl wird sichergestellt, dass Sie die neueste Version erhalten:

    yum install -y aws-cfn-bootstrap

  • Wenn Sie den yum install Befehl nicht einfügen und die Skripte cfn-init, cfn-signal oder cfn-get-metadata verwenden, müssen Sie die Skripte in jeder Amazon EC2-Linux-Instance mit diesem Befehl manuell aktualisieren:

    sudo yum install -y aws-cfn-bootstrap

    Anmerkung

    Bei der Ausführung von sudo yum install -y aws-cfn-bootstrap werden die Hilfsskripte aus dem yum-Repository installiert.

  • Wenn Sie den yum install Befehl nicht einfügen und das Skript cfn-hup verwenden, müssen Sie das Skript in jeder Amazon EC2-Linux-Instance mit diesen Befehlen manuell aktualisieren:

    sudo yum install -y aws-cfn-bootstrap

    sudo /sbin/service cfn-hup restart

    Anmerkung

    Bei der Ausführung von sudo yum install -y aws-cfn-bootstrap werden die Hilfsskripte aus dem yum-Repository installiert.

  • Wenn Sie den Quellcode der Skripte verwenden, um mit einer anderen Linux-Version oder einer anderen Plattform zu arbeiten und einen eigenen Zertifikat-Trust-Store erstellt haben, muss zudem der Trust-Store aktuell gehalten werden.

Für die Versionsgeschichte des Pakets aws-cfn-bootstrap siehe Versionsverlauf für CloudFormation Hilfsskripte.