Referenz zur Aktion „Stack bereitstellenAWS CloudFormation“

Im Folgenden finden Sie die YAML-Referenz für die Aktionsdefinition für die Aktion AWS CloudFormationStack bereitstellen. Informationen zur Verwendung dieser Aktion finden Sie unter Aktion „ AWS CloudFormation Stack bereitstellen“ hinzufügen.

Anmerkung

Die meisten der folgenden YAML-Eigenschaften haben entsprechende UI-Elemente im visuellen Editor. Verwenden Sie Strg+F, um ein UI-Element nachzuschlagen. Das -Element wird mit der zugehörigen YAML-Eigenschaft aufgelistet.


# The workflow definition starts here.
# See Immobilien auf höchstem Niveau for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.    
  DeployCloudFormationStack:  
    Identifier: aws/cfn-deploy@v1
    DependsOn:
      - build-action
    Compute:  
      Type: EC2 | Lambda
      Fleet: fleet-name
    Timeout: timeout-minutes
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: DeployRole
    Inputs:
      Sources:
        - source-name-1
      Artifacts:
        - CloudFormation-artifact
    Configuration:
      name: stack-name
      region: us-west-2
      template: template-path
      role-arn: arn:aws:iam::123456789012:role/StackRole        
      capabilities: CAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND
      parameter-overrides: KeyOne=ValueOne,KeyTwo=ValueTwo | path-to-JSON-file
      no-execute-changeset: 1|0
      fail-on-empty-changeset: 1|0
      disable-rollback: 1|0
      termination-protection: 1|0
      timeout-in-minutes: minutes
      notification-arns: arn:aws:sns:us-east-1:123456789012:MyTopic,arn:aws:sns:us-east-1:123456789012:MyOtherTopic
      monitor-alarm-arns: arn:aws:cloudwatch::123456789012:alarm/MyAlarm,arn:aws:cloudwatch::123456789012:alarm/MyOtherAlarm
      monitor-timeout-in-minutes: minutes       
      tags: '[{"Key":"MyKey1","Value":"MyValue1"},{"Key":"MyKey2","Value":"MyValue2"}]'

DeployCloudFormationStack

(Erforderlich)

Geben Sie den Namen der Aktion an. Alle Aktionsnamen müssen innerhalb des Workflows eindeutig sein. Aktionsnamen sind auf alphanumerische Zeichen (a-z, A-Z, 0-9), Bindestriche (-) und Unterstriche (_) beschränkt. Leerzeichen sind nicht erlaubt. Sie können keine Anführungszeichen verwenden, um Sonderzeichen und Leerzeichen in Aktionsnamen zu aktivieren.

Standard: DeployCloudFormationStack_nn.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Anzeigename der Aktion

Identifier

(DeployCloudFormationStack/Identifier)

(Erforderlich)

Identifiziert die Aktion. Ändern Sie diese Eigenschaft nur, wenn Sie die Version ändern möchten. Weitere Informationen finden Sie unter Mit Action-Versionen arbeiten.

Standard: aws/cfn-deploy@v1.

Entsprechende Benutzeroberfläche: Workflow-Diagramm/DeployCloudFormationStack_nn/aws/cfn-deploy@v1-Bezeichnung

DependsOn

(DeployCloudFormationStack/DependsOn)

(Optional)

Geben Sie eine Aktion oder Aktionsgruppe an, die erfolgreich ausgeführt werden muss, damit diese Aktion ausgeführt werden kann.

Weitere Informationen zur Funktionalität „abhängig von“ finden Sie unter Aktionen so konfigurieren, dass sie von anderen Aktionen abhängen.

Entsprechende Benutzeroberfläche: Registerkarte Eingaben/Abhängig von – optional

Compute

(DeployCloudFormationStack/Compute)

(Optional)

Die Computer-Engine, die zum Ausführen Ihrer Workflow-Aktionen verwendet wird. Sie können die Rechenleistung entweder auf Workflow-Ebene oder auf Aktionsebene angeben, aber nicht auf beides. Wenn auf Workflow-Ebene angegeben, gilt die Datenverarbeitungskonfiguration für alle im Workflow definierten Aktionen. Auf Workflow-Ebene können Sie auch mehrere Aktionen auf derselben Instance ausführen. Weitere Informationen finden Sie unter Rechenleistung für mehrere Aktionen gemeinsam nutzen.

Entsprechende Benutzeroberfläche: keine

Type

(DeployCloudFormationStack/Compute/Type)

(Erforderlich, wenn enthalten Compute ist)

Der Typ der Rechen-Engine. Sie können einen der folgenden Werte verwenden:

EC2 (visueller Editor) oder EC2 (YAML-Editor)

Optimiert für Flexibilität bei Aktionsausführungen.
Lambda (visueller Editor) oder Lambda (YAML-Editor)

Optimierte Startgeschwindigkeiten für Aktionen.

Weitere Informationen zu Datentypen finden Sie unter Über Berechnungstypen.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Erweitert – optional/Datenverarbeitungstyp

Fleet

(DeployCloudFormationStack/Compute/Fleet)

(Optional)

Geben Sie die Maschine oder Flotte an, die Ihren Workflow oder Ihre Workflow-Aktionen ausführen wird. Bei On-Demand-Flotten stellt der Workflow beim Start einer Aktion die benötigten Ressourcen bereit und die Maschinen werden nach Abschluss der Aktion zerstört. Beispiele für On-Demand-Flotten: Linux.x86-64.Large, Linux.x86-64.XLarge. Weitere Informationen zu On-Demand-Flotten finden Sie unter Flotteneigenschaften auf Abruf.

Mit bereitgestellten Flotten konfigurieren Sie eine Reihe von dedizierten Maschinen für die Ausführung Ihrer Workflow-Aktionen. Diese Maschinen bleiben inaktiv und können sofort Aktionen verarbeiten. Weitere Informationen zu bereitgestellten Flotten finden Sie unter Bereitgestellte Flotteneigenschaften.

Wenn weggelassen Fleet wird, ist der Standardwert Linux.x86-64.Large.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Erweitert – optional/Datenverarbeitungsflotte

Timeout

(DeployCloudFormationStack/Timeout)

(Optional)

Geben Sie die Zeit in Minuten (YAML-Editor) oder Stunden und Minuten (visueller Editor) an, die die Aktion ausgeführt werden kann, bevor die Aktion CodeCatalyst beendet. Das Minimum beträgt 5 Minuten und das Maximum ist unter beschriebenKontingente für Workflows in CodeCatalyst. Das Standard-Timeout entspricht dem maximalen Timeout.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Timeout in Minuten – optional

Environment

(DeployCloudFormationStack/Environment)

(Erforderlich)

Geben Sie die CodeCatalyst Umgebung an, die mit der Aktion verwendet werden soll.

Weitere Informationen zu Umgebungen finden Sie unter Arbeiten mit Umgebungen und Erstellen einer Umgebung.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Umgebung/Konto/Rolle“/Umgebung

Name

(DeployCloudFormationStack/Environment/Name)

(Erforderlich, wenn enthalten Environment ist)

Geben Sie den Namen einer vorhandenen Umgebung an, die Sie der Aktion zuordnen möchten.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Umgebung/Konto/Rolle“/Umgebung

Connections

(DeployCloudFormationStack/Environment/Connections)

(Erforderlich, wenn enthalten Environment ist)

Geben Sie die Kontoverbindung an, die der Aktion zugeordnet werden soll. Sie können maximal eine Kontoverbindung unter angebenEnvironment.

Weitere Informationen zu Kontoverbindungen finden Sie unter Verwaltung AWS-Konten für einen Raum. Informationen zum Zuordnen einer Kontoverbindung zu Ihrer Umgebung finden Sie unter Erstellen einer Umgebung.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Umgebung/Konto/Rolle“/AWSKontoverbindung

Name

(DeployCloudFormationStack/Environment/Connections/Name)

(Erforderlich)

Geben Sie den Namen der Kontoverbindung an.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Umgebung/Konto/Rolle“/AWSKontoverbindung

Role

(DeployCloudFormationStack/Environment/Connections/Role)

(Erforderlich)

Geben Sie den Namen der IAM-Rolle an, die die Aktion AWS CloudFormationStack bereitstellen für den Zugriff auf AWS und den AWS CloudFormation Service verwendet.

Stellen Sie sicher, dass diese Rolle die folgenden Richtlinien enthält:

Die folgende Berechtigungsrichtlinie:

Warnung

Beschränken Sie die Berechtigungen auf die in der folgenden Richtlinie aufgeführten. Die Verwendung einer Rolle mit umfassenderen Berechtigungen kann ein Sicherheitsrisiko darstellen.


{
    "Version": "2012-10-17",
    "Statement": [{
    "Action": [
        "cloudformation:CreateStack",
        "cloudformation:DeleteStack",
        "cloudformation:Describe*",
        "cloudformation:UpdateStack",
        "cloudformation:CreateChangeSet",
        "cloudformation:DeleteChangeSet",
        "cloudformation:ExecuteChangeSet",
        "cloudformation:SetStackPolicy",
        "cloudformation:ValidateTemplate",
        "cloudformation:List*",
        "iam:PassRole"
    ],
    "Resource": "*",
    "Effect": "Allow"
}]
}

Anmerkung

Wenn die Rolle zum ersten Mal verwendet wird, verwenden Sie den folgenden Platzhalter in der Ressourcenrichtlinienanweisung und schränken Sie dann die Richtlinie nach ihrer Verfügbarkeit mit dem Ressourcennamen ein.


"Resource": "*"

Die folgende benutzerdefinierte Vertrauensrichtlinie:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service":  [
                   "codecatalyst-runner.amazonaws.com",
                   "codecatalyst.amazonaws.com"
                 ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Stellen Sie sicher, dass diese Rolle der Kontoverbindung in Ihrem Bereich hinzugefügt wird. Weitere Informationen zum Hinzufügen einer IAM-Rolle zu einer Kontoverbindung finden Sie unter Hinzufügen von IAM-Rollen zu Kontoverbindungen.

Anmerkung

Sie können den Namen der CodeCatalystWorkflowDevelopmentRole-spaceName Rolle hier angeben, wenn Sie möchten. Weitere Informationen über diese Rolle finden Sie unter Erstellen der CodeCatalystWorkflowDevelopmentRole-spaceName Rolle für Ihr Konto und Ihren Bereich. Beachten Sie, dass die CodeCatalystWorkflowDevelopmentRole-spaceName Rolle über sehr umfassende Berechtigungen verfügt, die ein Sicherheitsrisiko darstellen können. Wir empfehlen, diese Rolle nur in Tutorials und Szenarien zu verwenden, in denen die Sicherheit weniger ein Problem darstellt.

Entsprechende Benutzeroberfläche: Registerkarte „Konfiguration“/„Umgebung/Konto/Rolle“/Rolle

Inputs

(DeployCloudFormationStack/Inputs)

(Optional)

Der Inputs Abschnitt definiert die Daten, die der während einer Workflow-Ausführung DeployCloudFormationStack benötigt.

Anmerkung

Pro Deploy-AWS CloudFormationStack-Aktion sind maximal vier Eingaben (eine Quelle und drei Artefakte) zulässig.

Wenn Sie auf Dateien verweisen müssen, die sich in verschiedenen Eingaben befinden (z. B. eine Quelle und ein Artefakt), ist die Quelleingabe die primäre Eingabe und das Artefakt ist die sekundäre Eingabe. Verweise auf Dateien in sekundären Eingaben verwenden ein spezielles Präfix, um sie vom primären zu trennen. Details hierzu finden Sie unter Beispiel: Referenzieren von Dateien in mehreren Artefakten.

Entsprechende Benutzeroberfläche: Registerkarte Eingaben

Sources

(DeployCloudFormationStack/Inputs/Sources)

(Erforderlich, wenn Ihre - CloudFormation oder -AWS SAMVorlage in einem Quell-Repository gespeichert ist)

Wenn Ihre - CloudFormation oder -AWS SAMVorlage in einem Quell-Repository gespeichert ist, geben Sie die Bezeichnung dieses Quell-Repositorys an. Derzeit ist die einzige unterstützte Bezeichnung WorkflowSource.

Wenn Ihre - CloudFormation oder -AWS SAMVorlage nicht in einem Quell-Repository enthalten ist, muss sie sich in einem Artefakt befinden, das durch eine andere Aktion generiert wurde, oder in einem Amazon S3-Bucket.

Weitere Informationen zu Quellen finden Sie unter Mit Quellen arbeiten.

Entsprechende Benutzeroberfläche: Registerkarte/Quellen – optional

Artifacts - input

(DeployCloudFormationStack/Inputs/Artifacts)

(Erforderlich, wenn Ihre - CloudFormation oder -AWS SAMVorlage in einem Ausgabeartefakt aus einer vorherigen Aktion gespeichert ist)

Wenn die - CloudFormation oder -AWS SAMVorlage, die Sie bereitstellen möchten, in einem Artefakt enthalten ist, das von einer vorherigen Aktion generiert wurde, geben Sie dieses Artefakt hier an. Wenn Ihre CloudFormation Vorlage nicht in einem Artefakt enthalten ist, muss sie sich in Ihrem Quell-Repository oder in einem Amazon S3-Bucket befinden.

Weitere Informationen zu Artefakten, einschließlich Beispielen, finden Sie unter Mit Artefakten arbeiten.

Entsprechende Benutzeroberfläche: Registerkarte/Artefakte der Konfiguration – optional

Configuration

(DeployCloudFormationStack/Configuration)

(Erforderlich)

Ein Abschnitt, in dem Sie die Konfigurationseigenschaften der Aktion definieren können.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration

name

(DeployCloudFormationStack/Configuration/name)

(Erforderlich)

Geben Sie einen Namen für den CloudFormation Stack an, den die Aktion AWS CloudFormationStack bereitstellen erstellt oder aktualisiert.

Entsprechende Benutzeroberfläche: Registerkarte/Stack-Name der Konfiguration

region

(DeployCloudFormationStack/Configuration/region)

(Erforderlich)

Geben Sie die an, AWS-Region in der der Stack bereitgestellt werden soll. Eine Liste der Regionscodes finden Sie unter Regionale Endpunkte.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Stack-Region

template

(DeployCloudFormationStack/Configuration/template)

(Erforderlich)

Geben Sie den Namen und den Pfad zu Ihrer - CloudFormation oder -AWS SAMVorlagendatei an. Die Vorlage kann im JSON- oder YAML-Format vorliegen und sich in einem Quell-Repository, einem Artefakt aus einer vorherigen Aktion oder einem Amazon S3-Bucket befinden. Wenn sich die Vorlagendatei in einem Quell-Repository oder Artefakt befindet, ist der Pfad relativ zum Quell- oder Artefaktstamm. Wenn sich die Vorlage in einem Amazon S3-Bucket befindet, ist der Pfad der Wert der Objekt-URL der Vorlage.

Beispiele:

./MyFolder/MyTemplate.json

MyFolder/MyTemplate.yml

https://MyBucket.s3.us-west-2.amazonaws.com/MyTemplate.yml

Anmerkung

Möglicherweise müssen Sie dem Dateipfad der Vorlage ein Präfix hinzufügen, um anzugeben, in welchem Artefakt oder welcher Quelle sie gefunden werden soll. Weitere Informationen finden Sie unter Verweisen auf Dateien in einem Quell-Repository und Referenzieren von Dateien in einem Artefakt.

Entsprechende Benutzeroberfläche: Registerkarte/Vorlage „Konfiguration“

role-arn

(DeployCloudFormationStack/Configuration/role-arn)

(Erforderlich)

Geben Sie den Amazon-Ressourcennamen (ARN) der Stack-Rolle an. CloudFormation verwendet diese Rolle, um auf Ressourcen in Ihrem Stack zuzugreifen und diese zu ändern. Zum Beispiel: arn:aws:iam::123456789012:role/StackRole.

Stellen Sie sicher, dass die Stack-Rolle Folgendes enthält:

Eine oder mehrere Berechtigungsrichtlinien. Die Richtlinien hängen von den Ressourcen ab, die Sie in Ihrem Stack haben. Wenn Ihr Stack beispielsweise eine -AWS LambdaFunktion enthält, müssen Sie Berechtigungen hinzufügen, die Zugriff auf Lambda gewähren. Wenn Sie das unter beschriebene Tutorial befolgt habenTutorial: Bereitstellen einer serverlosen Anwendung mit AWS CloudFormation, enthält es ein Verfahren mit dem Titel Um eine Stack-Rolle zu erstellen, das die Berechtigungen auflistet, die die Stack-Rolle benötigt, wenn Sie einen typischen Serverless-Anwendungs-Stack bereitstellen.

Warnung
Beschränken Sie die Berechtigungen auf diejenigen, die der CloudFormation Service für den Zugriff auf Ressourcen in Ihrem Stack benötigt. Die Verwendung einer Rolle mit umfassenderen Berechtigungen kann ein Sicherheitsrisiko darstellen.

Die folgende Vertrauensrichtlinie:


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service": "cloudformation.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Ordnen Sie diese Rolle optional Ihrer Kontoverbindung zu. Weitere Informationen zum Zuordnen einer IAM-Rolle zu einer Kontoverbindung finden Sie unter Hinzufügen von IAM-Rollen zu Kontoverbindungen. Wenn Sie die Stack-Rolle nicht mit der Kontoverbindung verknüpfen, wird die Stack-Rolle nicht in der Dropdown-Liste Stack-Rolle im visuellen Editor angezeigt. Der Rollen-ARN kann jedoch weiterhin im role-arn Feld mit dem YAML-Editor angegeben werden.

Anmerkung

Entsprechende Benutzeroberfläche: Registerkarte/Stack-Rolle Konfiguration – optional

capabilities

(DeployCloudFormationStack/Configuration/capabilities)

(Erforderlich)

Geben Sie eine Liste der IAM-Funktionen an, die erforderlich sind, damit bestimmte AWS CloudFormation Stacks erstellen kann. In den meisten Fällen können Sie capabilities mit dem Standardwert belassenCAPABILITY_IAM,CAPABILITY_NAMED_IAM,CAPABILITY_AUTO_EXPAND.

Wenn Sie ##[error] requires capabilities: [capability-name] in den Protokollen Ihrer Deploy-AWS CloudFormationStack-Aktion sehen, finden Sie unter Wie behebe ich Fehler bei den IAM-Fähigkeiten? Informationen zur Behebung des Problems.

Weitere Informationen zu IAM-Funktionen finden Sie unter Bestätigung von IAM-Ressourcen in -AWS CloudFormationVorlagen im IAM-Benutzerhandbuch.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Erweitert/Funktionen

parameter-overrides

(DeployCloudFormationStack/Configuration/parameter-overrides)

(Optional)

Geben Sie Parameter in Ihrer - AWS CloudFormation oder -AWS SAMVorlage an, die keine Standardwerte haben oder für die Sie Nicht-Standardwerte angeben möchten. Weitere Informationen zu Parametern finden Sie unter Parameter im AWS CloudFormation-Benutzerhandbuch.

Die -parameter-overridesEigenschaft akzeptiert:

Eine JSON-Datei, die die Parameter und Werte enthält.
Eine durch Komma getrennte Liste von Parametern und Werten.

So geben Sie eine JSON-Datei an

Stellen Sie sicher, dass die JSON-Datei eine der folgenden Syntaxen verwendet:
```
{
  "Parameters": {
    "Param1": "Value1",
    "Param2": "Value2",
    ...
  }
}
```
Oder...
```
[
  {
     "ParameterKey": "Param1",
     "ParameterValue": "Value1"
  },
  ...
]
```
(Es gibt andere Syntaxen, aber sie werden von CodeCatalyst zum Zeitpunkt des Schreibens nicht unterstützt.) Weitere Informationen zum Angeben von CloudFormation Parametern in einer JSON-Datei finden Sie unter Unterstützte JSON-Syntax in der AWS CLI -Befehlsreferenz.

Geben Sie den Pfad zur JSON-Datei mit einem der folgenden Formate an:

Wenn sich Ihre JSON-Datei in einem Ausgabeartefakt aus einer vorherigen Aktion befindet, verwenden Sie:

file:///artifacts/current-action-name/output-artifact-name/path-to-json-file

Einzelheiten finden Sie in Beispiel 1.

Wenn sich Ihre JSON-Datei in Ihrem Quell-Repository befindet, verwenden Sie:

file:///sources/WorkflowSource/path-to-json-file

Einzelheiten finden Sie in Beispiel 2.

Beispiel 1 – Die JSON-Datei befindet sich in einem Ausgabeartefakt


##My workflow YAML
...
Actions:
  MyBuildAction:
    Identifier: aws/build@v1
    Outputs:
      Artifacts:
        - Name: ParamArtifact
          Files:
            - params.json
    Configuration:
    ...
  MyDeployCFNStackAction:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      parameter-overrides: file:///artifacts/MyDeployCFNStackAction/ParamArtifact/params.json

Beispiel 2 – Die JSON-Datei befindet sich in Ihrem Quell-Repository in einem Ordner mit dem Namen my/folder


##My workflow YAML
...
Actions:
  MyDeployCloudFormationStack:
    Identifier: aws/cfn-deploy@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:
      parameter-overrides: file:///sources/WorkflowSource/my/folder/params.json

So verwenden Sie eine durch Komma getrennte Liste von Parametern

Fügen Sie Parameter-Name-Wert-Paare in der -parameter-overridesEigenschaft im folgenden Format hinzu:

param-1=value-1,param-2=value-2

Angenommen, es wird die folgende AWS CloudFormation Vorlage verwendet:
```
##My CloudFormation template

Description: My AWS CloudFormation template

Parameters:
  InstanceType:
    Description: Defines the Amazon EC2 compute for the production server.
    Type: String
    Default: t2.micro
    AllowedValues:
      - t2.micro
      - t2.small
      - t3.medium
    
Resources:
...
```
... Sie können die parameter-overrides Eigenschaft wie folgt festlegen:
```
##My workflow YAML
...
Actions:
...
  DeployCloudFormationStack:
    Identifier: aws/cfn-deploy@v1
    Configuration:
      parameter-overrides: InstanceType=t3.medium,UseVPC=true   
```
Anmerkung
Sie können einen Parameternamen ohne einen entsprechenden Wert angeben, indem Sie undefined als Wert verwenden. Beispielsweise:
parameter-overrides: MyParameter=undefined
Dies hat zur Folge, dass während einer Stack-Aktualisierung den vorhandenen Parameterwert für den angegebenen Parameternamen CloudFormation verwendet.

Entsprechende Benutzeroberfläche:

Konfigurations-Registerkarte/Erweitert/Parameter-Überschreibungen
Konfigurations-Registerkarte/Erweitert/Parameterüberschreibungen/Überschreibungen mithilfe einer Datei angeben
Registerkarte Konfiguration/Erweitert/Parameterüberschreibungen/Überschreibungen unter Verwendung eines Wertsatzes angeben

no-execute-changeset

(DeployCloudFormationStack/Configuration/no-execute-changeset)

(Optional)

Geben Sie CodeCatalyst an, ob Sie den CloudFormation Änderungssatz erstellen und dann anhalten möchten, bevor Sie ihn ausführen. Auf diese Weise haben Sie die Möglichkeit, den Änderungssatz in der CloudFormation Konsole zu überprüfen. Wenn Sie feststellen, dass der Änderungssatz gut aussieht, deaktivieren Sie diese Option und führen Sie den Workflow erneut aus, damit den Änderungssatz erstellen und ausführen CodeCatalyst kann, ohne ihn zu beenden. Standardmäßig wird der Änderungssatz erstellt und ausgeführt, ohne ihn anzuhalten. Weitere Informationen finden Sie unter dem AWS CloudFormation Bereitstellungsparameter in der AWS CLI -Befehlsreferenz. Weitere Informationen zum Anzeigen von Änderungssätzen finden Sie unter Anzeigen eines Änderungssatzes im AWS CloudFormation -Benutzerhandbuch.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Erweitert/Keine Ausführungsänderungssatz

fail-on-empty-changeset

(DeployCloudFormationStack/Configuration/fail-on-empty-changeset)

(Optional)

Geben Sie CodeCatalyst an, ob die Aktion AWS CloudFormationStack bereitstellen fehlschlagen soll, wenn der CloudFormation Änderungssatz leer ist. (Wenn ein Änderungssatz leer ist, bedeutet dies, dass während der letzten Bereitstellung keine Änderungen am Stack vorgenommen wurden.) Standardmäßig wird die Aktion fortgesetzt, wenn der Änderungssatz leer ist, und eine -UPDATE_COMPLETENachricht zurückgegeben, obwohl der Stack nicht aktualisiert wurde.

Weitere Informationen zu dieser Einstellung finden Sie im AWS CloudFormation Bereitstellungsparameter in der AWS CLI -Befehlsreferenz. Weitere Informationen zu Änderungssätzen finden Sie unter Aktualisieren von Stacks mithilfe von Änderungssätzen im AWS CloudFormation -Benutzerhandbuch.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Erweitert/Fehler bei leerem Änderungssatz

disable-rollback

(DeployCloudFormationStack/Configuration/disable-rollback)

(Optional)

Geben Sie CodeCatalyst an, ob Sie die Stack-Bereitstellung zurücksetzen möchten, falls sie fehlschlägt. Das Rollback setzt den Stack in den letzten bekannten stabilen Zustand zurück. Standardmäßig werden Rollbacks aktiviert. Weitere Informationen zu dieser Einstellung finden Sie im AWS CloudFormation Bereitstellungsparameter in der AWS CLI -Befehlsreferenz.

Weitere Informationen darüber, wie die Aktion AWS CloudFormationStack bereitstellen mit Rollbacks umgeht, finden Sie unter Rollbacks konfigurieren.

Weitere Informationen zum Rollback eines Stacks finden Sie unter Stack-Fehleroptionen im AWS CloudFormation -Benutzerhandbuch.

Entsprechende Benutzeroberfläche: Konfigurations-Tab/Erweitert/Deaktivieren des Rollbacks

termination-protection

(DeployCloudFormationStack/Configuration/termination-protection)

(Optional)

Geben Sie an, ob der Deploy-AWS CloudFormationStack dem Stack, den er bereitstellt, einen Beendigungsschutz hinzufügen soll. Wenn ein Benutzer versucht, einen Stack mit aktiviertem Beendigungsschutz zu löschen, schlägt das Löschen fehl und der Stack – einschließlich seines Status – bleibt unverändert. Standardmäßig wird der Beendigungsschutz deaktiviert. Weitere Informationen finden Sie unter Schützen eines Stacks vor dem Löschen im AWS CloudFormation -Benutzerhandbuch.

Entsprechende Benutzeroberfläche: Konfigurations-Tab/Erweitert/Beendigungsschutz

timeout-in-minutes

(DeployCloudFormationStack/Configuration/timeout-in-minutes)

(Optional)

Geben Sie die Zeit in Minuten an, die zuweisen CloudFormation soll, bevor ein Timeout für Operationen zur Stack-Erstellung durchgeführt und der Stack-Status auf festgelegt wirdCREATE_FAILED. Wenn CloudFormation innerhalb des zugeteilten Zeitraums nicht den gesamten Stack erstellen kann, schlägt die Stack-Erstellung aufgrund des Timeouts fehl und für den Stack wird ein Rollback durchgeführt.

Standardmäßig gibt es keinen Timeout für die Stack-Erstellung. Allerdings gibt es möglicherweise für einzelne Ressourcen einen Timeout, basierend auf der Art des von ihnen implementierten Services. Wenn beispielsweise eine einzelne Ressource in Ihrem Stack abläuft, läuft die Stack-Erstellung ebenfalls aus, auch wenn der von Ihnen angegebene Timeout für die Stack-Erstellung noch nicht erreicht wurde.

Entsprechende Benutzeroberfläche: Registerkarte Konfiguration/Erweitert/CloudFormationTimeout

notification-arns

(DeployCloudFormationStack/Configuration/notification-arns)

(Optional)

Geben Sie den ARN eines Amazon SNS-Themas CodeCatalyst an, an das Sie Benachrichtigungen senden möchten. Beispiel: arn:aws:sns:us-east-1:111222333:MyTopic Wenn die Aktion AWS CloudFormationStack bereitstellen ausgeführt wird, CodeCatalyst koordiniert mit , CloudFormation um eine Benachrichtigung pro AWS CloudFormation Ereignis zu senden, das während des Stack-Erstellungs- oder Aktualisierungsprozesses auftritt. (Die Ereignisse sind auf der Registerkarte Ereignisse der AWS CloudFormationKonsole für den Stack sichtbar.) Sie können bis zu fünf Themen angeben. Weitere Informationen finden Sie unter Was ist Amazon SNS?.

Entsprechende Benutzeroberfläche: Konfigurations-Registerkarte/Erweitert/Benachrichtigungs-ARNs

monitor-alarm-arns

(DeployCloudFormationStack/Configuration/monitor-alarm-arns)

(Optional)

Geben Sie den Amazon-Ressourcennamen (ARN) eines Amazon- CloudWatch Alarms an, der als Rollback-Auslöser verwendet werden soll. Beispiel: arn:aws:cloudwatch::123456789012:alarm/MyAlarm Sie können maximal fünf Rollback-Auslöser haben.

Anmerkung

Wenn Sie einen CloudWatch Alarm-ARN angeben, müssen Sie auch zusätzliche Berechtigungen konfigurieren, damit die Aktion auf zugreifen kann CloudWatch. Weitere Informationen finden Sie unter Rollbacks konfigurieren.

Entsprechende Benutzeroberfläche: Konfigurations-Registerkarte/Erweitert/Überwachung von Alarm-ARNs

monitor-timeout-in-minutes

(DeployCloudFormationStack/Configuration/monitor-timeout-in-minutes)

(Optional)

Geben Sie eine Zeitspanne von 0 bis 180 Minuten an, in der die angegebenen Alarme CloudFormation überwacht. Die Überwachung beginnt, nachdem alle Stack-Ressourcen bereitgestellt wurden. Wenn der Alarm innerhalb der angegebenen Überwachungszeit auftritt, schlägt die Bereitstellung fehl und CloudFormation setzt den gesamten Stack-Vorgang zurück.

Standard: 0. überwacht CloudFormation nur Alarme, während die Stack-Ressourcen bereitgestellt werden, nicht danach.

Entsprechende Benutzeroberfläche: Konfigurations-Tab/Erweitert/Überwachungszeit