AWS CloudFormation Artefakte

CodePipeline führt Aufgaben an Artefakten aus, während eine Pipeline CodePipeline ausgeführt wird. Denn AWS CloudFormation Artefakte können eine Stack-Vorlagendatei, eine Vorlagen-Konfigurationsdatei oder beides enthalten. CodePipeline verwendet diese Artefakte, um mit AWS CloudFormation Stacks und Änderungssätzen zu arbeiten.

Wenn Sie Amazon Simple Storage Service (Amazon S3) als Quell-Repository verwenden, müssen Sie die Vorlagen- und Vorlagenkonfigurationsdateien in einer einzigen ZIP-Datei komprimieren, bevor Sie sie in einen S3-Bucket hochladen. Laden Sie für andere Repositorys, wie z. B. GitHub und AWS CodeCommit, Artefakte hoch, ohne sie zu komprimieren. Weitere Informationen finden Sie CodePipelineim AWS CodePipeline Benutzerhandbuch unter Erstellen einer Pipeline.

Sie können so viele Dateien wie nötig zu Ihrem Repository hinzufügen. So können Sie beispielsweise zwei verschiedene Konfigurationen für dieselbe Vorlage einschließen: eine für eine Testkonfiguration und eine andere für eine Produktionskonfiguration.

In diesem Thema werden die einzelnen Artefakttypen beschrieben.

Stack-Vorlagendatei

Eine Stack-Vorlagendatei definiert die Ressourcen, die AWS CloudFormation bereitgestellt und konfiguriert werden. Bei diesen Dateien handelt es sich um dieselben Vorlagendateien, die Sie verwenden, wenn Sie Stacks mithilfe von erstellen oder aktualisieren. AWS CloudFormation Sie können Vorlagen im JSON Format YAML oder verwenden. Weitere Informationen zu Vorlagen finden Sie unter CloudFormation Vorlagenabschnitte.

Vorlagenkonfigurationsdatei

Eine Vorlagenkonfigurationsdatei ist eine Textdatei im JSON -Format, in der Vorlagenparameterwerte, eine Stack-Richtlinie und Tags angegeben werden können. Verwenden Sie diese Konfigurationsdateien, um Parameterwerte oder eine Stack-Richtlinie für einen Stack anzugeben. Alle Parameterwerte, die Sie angeben, müssen in der zugehörigen Vorlage deklariert sein.

Wenn Sie sensible Daten wie z. B. Passwörter einschließen, sollten Sie den Zugriff auf diese Datei beschränken. Wenn Sie beispielsweise Ihr Artefakt in einen S3-Bucket hochladen, verwenden Sie S3-Bucket-Richtlinien oder Benutzerrichtlinien zum Einschränken des Zugriffs.

Verwenden Sie zum Erstellen einer Konfigurationsdatei das folgende Format:

{
  "Parameters" : {
    "NameOfTemplateParameter" : "ValueOfParameter",
    ...
  },
  "Tags" : {
    "TagKey" : "TagValue",
    ...
  }, 
  "StackPolicy" : {
    "Statement" : [
      StackPolicyStatement
    ]
  }
}

Im folgenden Beispiel wird TestEC2Key für den Parameter KeyName angegeben und ein Department-Tag mit dem Wert Marketing sowie eine Stack-Richtlinie hinzugefügt, die alle Aktualisierungsaktionen außer einer Aktualisierung zulässt, die eine Ressource löscht.

{
  "Parameters" : {
    "KeyName" : "TestEC2Key"
  },
  "Tags" : {
    "Department" : "Marketing"
  },
  "StackPolicy" : {
    "Statement" : [
      {
        "Effect" : "Allow",
        "NotAction" : "Update:Delete",
        "Principal": "*",
        "Resource" : "*"
      }
    ]
  }
}

Weitere Informationen finden Sie auch unter

Die folgenden verwandten Ressourcen unterstützen Sie bei der Arbeit mit diesen Parametern.