cfn-init - AWS CloudFormation
SyntaxOptionenBeispieleZugehörige Ressourcen

Dies ist der neue AWS CloudFormation Vorlagen-Referenzleitfaden. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im AWS CloudFormation Benutzerhandbuch.

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.

cfn-init

In einer CloudFormation Vorlage können Sie AWS::CloudFormation::Init innerhalb des Metadata Abschnitts einer EC2 Amazon-Ressource Initialisierungsaufgaben definieren. Weitere Informationen finden Sie unter AWS::CloudFormation::Init.

Das cfn-init Hilfsskript liest Vorlagen-Metadaten aus dem AWS::CloudFormation::Init Schlüssel und verhält sich entsprechend, um:

  • Ruft Metadaten ab und analysiert sie von CloudFormation

  • Pakete installieren

  • Dateien auf die Festplatte zu schreiben

  • Enable/disable and start/stop-Services

Das cfn-init Hilfsskript wird normalerweise aus den Benutzerdaten einer EC2 Amazon-Instance oder einer Startvorlage ausgeführt.

Wenn Sie mit der Verwendung von Hilfsskripten noch nicht vertraut sind, empfehlen wir Ihnen, zunächst das EC2 Tutorial Bereitstellen von Anwendungen auf Amazon im AWS CloudFormation Benutzerhandbuch zu absolvieren.

Anmerkung

Wenn cfn-init Sie eine bestehende Datei aktualisieren, wird eine Sicherungskopie der Originaldatei im selben Verzeichnis mit der Erweiterung.bak erstellt. Wenn Sie beispielsweise /path/to/file_name aktualisieren, werden bei der Aktion zwei Dateien erzeugt: /path/to/file_name.bak enthält den ursprünglichen Inhalt der Datei, /path/to/file_name den aktualisierten Inhalt.

Syntax

cfn-init --stack|-s stack.name.or.id \
         --resource|-r logical.resource.id \
         --region region \
         --access-key access.key \
         --secret-key secret.key \
         --role rolename \
         --credential-file|-f credential.file \
         --configsets|-c config.sets \
         --url|-u service.url \
         --http-proxy HTTP.proxy \
         --https-proxy HTTPS.proxy \
         --verbose|-v
Anmerkung

cfn-initbenötigt keine Anmeldeinformationen, sodass Sie die --credential-file Optionen--access-key, --secret-key--role, oder nicht verwenden müssen. 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. Weitere Informationen finden Sie unter Berechtigungen für Helferobjektskripte.

Optionen

Name Beschreibung Erforderlich

-s, --stack

Stackname oder Stack-ID.

Typ: Zeichenfolge

Standard: Keiner

Beispiel: --stack { "Ref" : "AWS::StackName" },

Ja

-r, --resource

Die logische Ressourcen-ID der Ressource, die die Metadaten enthält.

Typ: Zeichenfolge

Beispiel: --resource WebServerHost

Ja

--region

Der zu verwendende CloudFormation regionale Endpunkt.

Typ: Zeichenfolge

Standardwert: us-east-1

Beispiel: --region ", { "Ref" : "AWS::Region" },

Nein

--access-key

AWS Zugriffsschlüssel für ein Konto mit DescribeStackResource Anrufberechtigung CloudFormation. Der Dateiparameter Anmeldeinformationen hat Vorrang vor diesem Parameter.

Typ: Zeichenfolge

Nein

--secret-key

AWS geheimer Zugriffsschlüssel, der dem angegebenen AWS Zugriffsschlüssel entspricht.

Typ: Zeichenfolge

Nein

--role

Der Name einer IAM-Rolle, die mit dieser Instance verknüpft ist.

Typ: Zeichenfolge

Bedingun: Der Dateiparameter Anmeldeinformationen hat Vorrang vor diesem Parameter.

Nein

-f, --credential-file

Eine Datei mit einem geheimen Zugriffsschlüssel und einem Zugriffsschlüssel. Der Dateiparameter Anmeldeinformationen hat Vorrang vor den Parametern Rolle, Zugriffschlüssel und geheimer Zugriffschlüssel.

Typ: Zeichenfolge

Nein

-c, --configsets

Eine durch Kommas getrennte Liste der auszuführenden configsets (in Reihenfolge).

Typ: Zeichenfolge

Standardwert: default

Nein

-u, --url

Der zu verwendende CloudFormation Endpunkt.

Typ: Zeichenfolge

Nein

--http-proxy

Ein HTTP-Proxys (Nicht-SSL). Verwenden Sie das folgende Format: http://user:password@host:port

Typ: Zeichenfolge

Nein

--https-proxy

Ein HTTPS-Proxy. Verwenden Sie das folgende Format: https://user:password@host:port

Typ: Zeichenfolge

Nein

-v, --verbose

Ausführliche Ausgabe. Dies ist nützlich für das Debuggen von Fällen, in denen cfn-init die Initialisierung fehlschlägt.

Anmerkung

Um Initialisierungsereignisse zu debuggen, sollten Sie die Option aktivieren. DisableRollback Sie können dann eine SSH-Verbindung zur Konsole herstellen und die Protokolle unter lesen. /var/log/cfn-init.log Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Auswählen, wie mit Fehlern bei der Bereitstellung von Ressourcen umgegangen werden soll.

Nein

-h, --help

Zeigt eine Hilfsnachricht an und wird beendet.

Nein

Beispiele

Amazon Linux-Beispiele

Die folgenden Beispiele zeigen die UserData Eigenschaft einer EC2 Instance, die das InstallAndRun Configset ausführt, das der WebServerInstance Ressource zugeordnet ist.

Um die neueste Version aufzunehmen, fügen Sie yum install -y aws-cfn-bootstrap zu UserData hinzu.

JSON

UserData-Eigenschaft mit der intrinsischen Fn::Join-Funktion.

{
    "UserData": {
        "Fn::Base64": {
            "Fn::Join": [
                "",
                [
                    "#!/bin/bash -xe\n",
                    "",
                    "yum install -y aws-cfn-bootstrap",
                    "/opt/aws/bin/cfn-init -v ",
                    "         --stack ",
                    {
                        "Ref": "AWS::StackName"
                    },
                    "         --resource WebServerInstance ",
                    "         --configsets InstallAndRun ",
                    "         --region ",
                    {
                        "Ref": "AWS::Region"
                    },
                    "\n"
                ]
            ]
        }
    }
}

YAML

UserData-Eigenschaft mit der intrinsischen Fn::Sub-Funktion.

UserData: !Base64
  Fn::Sub: |-
    #!/bin/bash -xe
    yum update -y aws-cfn-bootstrap
    # Install the files and packages from the metadata
    /opt/aws/bin/cfn-init -v --stack ${AWS::StackName} --resource WebServerInstance --configsets InstallAndRun --region ${AWS::Region}

Ein Tutorial mit einer Beispielvorlage finden Sie unter Deployment Applications on Amazon EC2 im AWS CloudFormation Benutzerhandbuch.

Ein Windows Beispiel finden Sie im Benutzerhandbuch unter WindowsBootstrapping-basierte CloudFormation Stacks.AWS CloudFormation

Sie können auch unser GitHub Repository besuchen, um Beispielvorlagen herunterzuladen, die verwendet werdencfn-init, einschließlich der folgenden Vorlagen.

Beispiele für LAMP-Stack-Vorlagen, die verwendet cfn-init werden, finden Sie unter ec2-lamp-server auf der Website. GitHub