Référence des actions de déploiement d'Amazon Elastic Container Service

Vous pouvez utiliser une ECS action Amazon pour déployer un ECS service et un ensemble de tâches Amazon. Un ECS service Amazon est une application conteneur déployée sur un ECS cluster Amazon. Un ECS cluster Amazon est un ensemble d'instances qui hébergent votre application conteneur dans le cloud. Le déploiement nécessite une définition de tâche que vous créez dans Amazon ECS et un fichier de définitions d'image CodePipeline utilisé pour déployer l'image.

Important

L'action de déploiement ECS standard d'Amazon pour CodePipeline crée sa propre révision de la définition de tâche en fonction de la révision utilisée par le ECS service Amazon. Si vous créez de nouvelles révisions pour la définition de tâche sans mettre à jour le ECS service Amazon, l'action de déploiement ignorera ces révisions.

Avant de créer votre pipeline, vous devez déjà avoir créé les ECS ressources Amazon, étiqueté et stocké l'image dans votre référentiel d'images, puis téléchargé le BuildSpec fichier dans votre référentiel de fichiers.

Note

Cette rubrique de référence décrit l'action de déploiement ECS standard d'Amazon pour CodePipeline. Pour des informations de référence sur les actions de déploiement ECS d'Amazon vers le CodeDeploy bleu/vert dans CodePipeline, consultez. Amazon Elastic Container Service et référence CodeDeploy sur les actions de déploiement bleu-vert

Type d'action

• Catégorie : Deploy

• Propriétaire : AWS

• Fournisseur : ECS

• Version : 1

Paramètres de configuration

ClusterName

Obligatoire : oui

Le ECS cluster Amazon dans AmazonECS.

ServiceName

Obligatoire : oui

Le ECS service Amazon que vous avez créé sur AmazonECS.

FileName

Obligatoire : non

Le nom de votre fichier de définitions d'images, le JSON fichier qui décrit le nom du conteneur de votre service, ainsi que l'image et le tag. Vous utilisez ce fichier pour les déploiements ECS standard. Pour plus d’informations, consultez Artefacts d'entrée et fichier imagedefinitions.json pour les actions de déploiement standard d'Amazon ECS.

DeploymentTimeout

Obligatoire : non

Délai d'expiration ECS de l'action de déploiement d'Amazon en minutes. Le délai d'expiration est configurable dans la limite du délai d'expiration par défaut maximal pour cette action. Par exemple :

"DeploymentTimeout": "15"

Artefacts d'entrée

• Nombre d'objets : 1

• Description : l'action recherche un imagedefinitions.json fichier dans le référentiel de fichiers source pour le pipeline. Un document de définition d'image est un JSON fichier qui décrit le nom de votre ECS conteneur Amazon ainsi que l'image et le tag. CodePipeline utilise le fichier pour récupérer l'image depuis votre référentiel d'images tel qu'AmazonECR. Vous pouvez ajouter manuellement un imagedefinitions.json fichier pour un pipeline dans lequel l'action n'est pas automatisée. Pour de plus amples informations concernant le fichier imagedefinitions.json, veuillez consulter fichier imagedefinitions.json pour les actions de déploiement standard d'Amazon ECS.

  L'action nécessite une image existante qui a déjà été transférée vers votre référentiel d'images. Comme le mappage de l'image est fourni par le imagedefinitions.json fichier, l'action ne nécessite pas que la ECR source Amazon soit incluse en tant qu'action source dans le pipeline.

Artefacts de sortie

• Nombre d'objets : 0

• Description : les artefacts de sortie ne s'appliquent pas à ce type d'action.

Déclaration d'action

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

Consultez aussi

Les ressources connexes suivantes peuvent s'avérer utiles dans le cadre de l'utilisation de cette action.

• Tutoriel : déploiement continu avec CodePipeline — Ce didacticiel vous montre comment créer un Dockerfile que vous stockez dans un référentiel de fichiers source tel que. CodeCommit Ensuite, le didacticiel vous montre comment intégrer un CodeBuild BuildSpec fichier qui génère et envoie votre image Docker vers Amazon ECR et crée votre fichier imagedefinitions.json. Enfin, vous créez une définition de ECS service et de tâche Amazon, puis vous créez votre pipeline avec une action de ECS déploiement Amazon.

  Note

  Cette rubrique et ce didacticiel décrivent l'action de déploiement ECS standard d'Amazon pour CodePipeline. Pour plus d'informations sur les actions de déploiement ECS d'Amazon vers le CodeDeploy bleu/vert dans CodePipeline, consultez. Tutoriel : Création d'un pipeline avec une ECR source Amazon et déploiement en ECS vue d'un déploiement CodeDeploy

• Guide du développeur Amazon Elastic Container Service — Pour plus d'informations sur l'utilisation des images et des conteneurs Docker, des ECS services et clusters Amazon, ainsi que des ensembles de ECS tâches Amazon, consultez Qu'est-ce qu'Amazon ? ECS