Amazon Elastic Container Service

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

Wichtig

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

Bevor Sie Ihre Pipeline erstellen, müssen Sie bereits die Amazon ECS-Ressourcen erstellt, das Image mit Tags versehen und in Ihrem Image-Repository gespeichert haben und die BuildSpec -Datei in Ihr -Repository.

Anmerkung

Dieses Referenzthema beschreibt die Amazon ECS-Standardbereitstellungsaktion für CodePipeline. Referenzinformationen zu Amazon ECS finden Sie unter CodeDeploy -Blau/Grün-Bereitstellungsaktionen in CodePipelinefinden Sie unterAmazon Elastic Container Service undCodeDeploy Blau-Grün-.

Aktionstyp

• Kategorie: Deploy

• Eigentümer: AWS

• Anbieter: ECS

• Version: 1

Konfigurationsparameter

ClusterName

Erforderlich: Ja

Der Amazon ECS-Cluster in Amazon ECS.

ServiceName

Erforderlich: Ja

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

FileName

Erforderlich: Nein

Der Name Ihrer Abbild-Definitionsdatei, die JSON-Datei, die den Namen des Containers Ihres -Service beschreibt sowie Abbild und Tag. Sie verwenden diese Datei für ECS-Standardbereitstellungen. Weitere Informationen erhalten Sie unter Input artifacts (Eingabeartefakte) und imagedefinitions.json-Datei für Amazon ECS-SStandardbereitstellungsaktionen.

DeploymentTimeout

Erforderlich: Nein

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

"DeploymentTimeout": "15"

Input artifacts (Eingabeartefakte)

• Anzahl der Artefakte: 1

• Beschreibung Die Aktion sucht nach einemimagedefinitions.json-Datei im Quelldatei-Repository für die Pipeline. Ein Abbild-Definitionsdokument ist eine JSON-Datei, die den Namen Ihres -Amazon ECS-Containers sowie Abbild und Tag beschreibt. CodePipeline verwendet die Datei, um das Image aus Ihrem Image-Repository wie Amazon ECR abzurufen. Sie können manuell eine hinzufügenimagedefinitions.json-Datei für eine Pipeline, in der die Aktion nicht automatisiert ist. Informationen zur imagedefinitions.json-Datei finden Sie unter imagedefinitions.json-Datei für Amazon ECS-SStandardbereitstellungsaktionen.

  Die Aktion erfordert ein vorhandenes Image, das bereits in Ihr Bild-Repository übertragen wurde. Weil das Image-Mapping vonimagedefinitions.json-Datei erfordert die Aktion nicht, dass die Amazon ECR-Quelle als Quellaktion in die Pipeline aufgenommen wird.

Ausgabeartefakte

• Anzahl der Artefakte: 0

• Beschreibung Ausgabe-Artefakte sind für diesen Aktionstyp nicht gültig.

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"
        }
    ]
},

Weitere Informationen finden Sie auch unter

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

• Tutorial: Kontinuierliche Bereitstellung mit CodePipeline— In diesem Tutorial erfahren Sie, wie Sie ein Dockerfile erstellen, das Sie in einem Quelldatei-Repository wie CodeCommit. Als nächstes erfahren Sie, wie Sie eine CodeBuild BuildSpec -Datei, die Ihr Docker-Image erstellt und an Amazon ECR überträgt und Ihre imagedefinitions.json-Datei erstellt. Schließlich erstellen Sie einen Amazon ECS-Service und eine Aufgabendefinition und dann erstellen Sie Ihre Pipeline mit einer Amazon ECS-Bereitstellungsaktion.

  Anmerkung

  Dieses Thema und Tutorial beschreiben die Amazon ECS-Standardbereitstellungsaktion für CodePipeline. Weitere Informationen zu Amazon ECS finden Sie unter CodeDeploy -Blau/Grün-Bereitstellungsaktionen in CodePipelinefinden Sie unterTutorial: Eine Pipeline mit einer Amazon ECR-Quelle und ECS-TO-Bereitstellung erstellen CodeDeploy .

• Amazon Elastic Container Service Entwicklerhandbuch— Weitere Informationen zum Arbeiten mit Docker-Images und Containern, Amazon ECS-Services und -Clustern sowie Amazon ECS-Tasksets finden Sie unterWas ist Amazon ECS?