Referenz zur Bereitstellungsaktion von Amazon Elastic Container Service - AWS CodePipeline
AktionstypKonfigurationsparameter Input artifacts (Eingabeartefakte)AusgabeartefakteAktionsdeklarationWeitere Informationen finden Sie auch unter

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 zur Bereitstellungsaktion von Amazon Elastic Container Service

Sie können eine ECS Amazon-Aktion verwenden, um einen ECS Service und eine Aufgabengruppe von Amazon bereitzustellen. Ein ECS Amazon-Service ist eine Container-Anwendung, die in einem ECS Amazon-Cluster bereitgestellt wird. Ein ECS Amazon-Cluster ist eine Sammlung von Instances, die Ihre Container-Anwendung in der Cloud hosten. Die Bereitstellung erfordert eine Aufgabendefinition, die Sie in Amazon erstellen, ECS und eine Image-Definitionsdatei, die zur Bereitstellung des Images CodePipeline verwendet wird.

Wichtig

Die ECS Amazon-Standardbereitstellungsaktion für CodePipeline erstellt eine eigene Version der Aufgabendefinition, die auf der vom ECS Amazon-Service verwendeten Version basiert. Wenn Sie neue Revisionen für die Aufgabendefinition erstellen, ohne den ECS Amazon-Service zu aktualisieren, ignoriert die Bereitstellungsaktion diese Revisionen.

Bevor Sie Ihre Pipeline erstellen, müssen Sie die ECS Amazon-Ressourcen bereits erstellt, das Bild markiert und in Ihrem Bild-Repository gespeichert und die BuildSpec Datei in Ihr Datei-Repository hochgeladen haben.

Anmerkung

In diesem Referenzthema wird die ECS standardmäßige Bereitstellungsaktion von Amazon für beschrieben CodePipeline. Referenzinformationen zu den Bereitstellungsaktionen von Amazon ECS to CodeDeploy Blue/Green finden Sie CodePipeline unterReferenz für Amazon Elastic Container Service und CodeDeploy blaugrüne Bereitstellungsaktionen.

Aktionstyp

  • Kategorie: Deploy

  • Eigentümer: AWS

  • Anbieter: ECS

  • Version: 1

Konfigurationsparameter

ClusterName

Erforderlich: Ja

Der ECS Amazon-Cluster in AmazonECS.

ServiceName

Erforderlich: Ja

Der ECS Amazon-Service, den Sie in Amazon erstellt habenECS.

FileName

Erforderlich: Nein

Der Name Ihrer Image-Definitionsdatei, die JSON Datei, die den Container-Namen Ihres Services beschreibt, sowie das Bild und das Tag. Sie verwenden diese Datei für ECS Standardbereitstellungen. Weitere Informationen erhalten Sie unter Input artifacts (Eingabeartefakte) und imagedefinitions.json-Datei für Amazon-Standardbereitstellungsaktionen ECS.

DeploymentTimeout

Erforderlich: Nein

Das Timeout der ECS Amazon-Bereitstellungsaktion in Minuten. Die Zeitüberschreitung kann bis zum maximalen Standard-Timeout für diese Aktion konfiguriert werden. Beispielsweise: 

"DeploymentTimeout": "15"

Input artifacts (Eingabeartefakte)

  • Anzahl der Artefakte: 1

  • Beschreibung: Die Aktion sucht nach einer imagedefinitions.json Datei im Quelldatei-Repository für die Pipeline. Ein Dokument mit Bilddefinitionen ist eine JSON Datei, die Ihren ECS Amazon-Container-Namen sowie das Bild und das Tag beschreibt. CodePipeline verwendet die Datei, um das Bild aus Ihrem Bild-Repository wie Amazon abzurufenECR. Sie können manuell eine imagedefinitions.json Datei für eine Pipeline hinzufügen, in der die Aktion nicht automatisiert ist. Informationen zur imagedefinitions.json-Datei finden Sie unter imagedefinitions.json-Datei für Amazon-Standardbereitstellungsaktionen ECS.

    Für die Aktion ist ein vorhandenes Image erforderlich, das bereits in Ihr Image-Repository übertragen wurde. Da die Image-Zuordnung von der imagedefinitions.json Datei bereitgestellt wird, erfordert die Aktion nicht, dass die ECR Amazon-Quelle als Quellaktion in die Pipeline aufgenommen wird.

Ausgabeartefakte

  • Anzahl der Artefakte: 0

  • Beschreibung: Ausgabeartefakte gelten nicht für diesen Aktionstyp.

Aktionsdeklaration

YAML
Name: DeployECS
ActionTypeId:
  Category: Deploy
  Owner: AWS
  Provider: ECS
  Version: '1'
RunOrder: 2
Configuration:
  ClusterName: my-ecs-cluster
  ServiceName: sample-app-service
  FileName: imagedefinitions.json
  DeploymentTimeout: '15'
OutputArtifacts: []
InputArtifacts:
  - Name: my-image
JSON
{
    "Name": "DeployECS",
    "ActionTypeId": {
        "Category": "Deploy",
        "Owner": "AWS",
        "Provider": "ECS",
        "Version": "1"
    },
    "RunOrder": 2,
    "Configuration": {
        "ClusterName": "my-ecs-cluster",
        "ServiceName": "sample-app-service",
        "FileName": "imagedefinitions.json",
        "DeploymentTimeout": "15"
    },
    "OutputArtifacts": [],
    "InputArtifacts": [
        {
            "Name": "my-image"
        }
    ]
},

Die folgenden verwandten Ressourcen bieten Ihnen nützliche Informationen für die Arbeit mit dieser Aktion.

  • Tutorial: Kontinuierliche Bereitstellung mit CodePipeline — Dieses Tutorial zeigt Ihnen, wie Sie ein Dockerfile erstellen, das Sie in einem Quelldatei-Repository speichern, wie z. CodeCommit Als Nächstes zeigt Ihnen das Tutorial, wie Sie eine CodeBuild BuildSpec Datei integrieren, die Ihr Docker-Image erstellt und an Amazon überträgt und Ihre ECR imagedefinitions.json-Datei erstellt. Schließlich erstellen Sie eine ECS Amazon-Service- und Aufgabendefinition und anschließend Ihre Pipeline mit einer ECS Amazon-Bereitstellungsaktion.

    Anmerkung

    In diesem Thema und in dieser Anleitung wird die ECS standardmäßige Bereitstellungsaktion von Amazon für beschrieben CodePipeline. Informationen zu den Bereitstellungsaktionen ECS von Amazon to CodeDeploy Blue/Green finden Sie CodePipeline unterTutorial: Eine Pipeline mit einer ECR Amazon-Quelle und ECS -to-Deployment erstellen CodeDeploy .

  • Amazon Elastic Container Service Developer Guide — Informationen zur Arbeit mit Docker-Images und Containern, ECS Amazon-Services und -Clustern sowie ECS Amazon-Tasksets finden Sie unter Was ist Amazon ECS?