Amazon Elastic Container Service

Vous pouvez utiliser une action Amazon ECS pour déployer un service et un ensemble de tâches Amazon ECS. Un service Amazon ECS est une application conteneur déployée sur un cluster Amazon ECS. Un cluster Amazon ECS est un cluster Amazon ECS est un cluster Amazon ECS est un cluster Amazon ECS. 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'images qui CodePipeline utilise pour déployer l'image.

Important

L'action de déploiement standard d'Amazon ECS 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 service Amazon ECS. Si vous créez de nouvelles révisions pour la définition de tâche sans mettre à jour le service Amazon ECS, l'action de déploiement ignorera ces révisions.

Avant de créer votre pipeline, vous devez avoir déjà créé les ressources Amazon ECS, balisé et stocké l'image dans votre référentiel d'images, et 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 standard d'Amazon ECS pour CodePipeline. Pour obtenir des informations de référence sur Amazon ECS, veuillez CodeDeploy actions de déploiement bleu/vert dans CodePipeline, voirAmazon Elastic Container Service etCodeDeploy bleu-vert.

Type d'action

• Catégorie : Deploy

• Propriétaire : AWS

• Fournisseur : ECS

• Version : 1

Paramètres de configuration

ClusterName

Obligatoire : Oui

Le cluster Amazon ECS dans Amazon ECS.

ServiceName

Obligatoire : Oui

Le service Amazon ECS que vous avez créé dans Amazon ECS.

FileName

Obligatoire : Non

Nom de définitions d'image, fichier de définitions d'image et balise. Vous utilisez ce fichier pour les déploiements standard d'ECS. Pour plus d’informations, consultez Artefacts d'entrée et Fichier imagedefinitions.json pour les actions de déploiement standard Amazon ECS.

DeploymentTimeout

Obligatoire : Non

Délai d'expiration de l'action de déploiement Amazon ECS 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'artefacts : 1

• Description : L'action cherche unimagedefinitions.jsonfichier dans le référentiel de fichiers source du pipeline. Un fichier JSON est un document de définitions d'image et de définitions d'image et de balise. CodePipeline utilise le fichier pour récupérer l'image à partir de votre référentiel d'images tel que Amazon ECR. Vous pouvez ajouter manuellement unimagedefinitions.jsonfichier pour un pipeline dont 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 Amazon ECS.

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

Artefacts de sortie

• Nombre d'artefacts : 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"
        }
    ]
},

Consulter aussi

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

• Didacticiel : 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. Ce didacticiel vous montre ensuite comment intégrer un CodeBuild BuildSpec fichier qui génère et transmet votre image Docker vers Amazon ECR et crée votre fichier imagedefinitions.json. Enfin, vous créez un service Amazon ECS et une définition de tâche, puis vous créez votre pipeline à l'aide d'une action de déploiement Amazon ECS.

  Note

  Cette rubrique et ce didacticiel décrivent l'action de déploiement standard d'Amazon ECS pour CodePipeline. Pour plus d'informations sur Amazon ECS, veuillez CodeDeploy actions de déploiement bleu/vert dans CodePipeline, voirTutoriel : Création d'un pipeline avec une source Amazon ECR et ECS-to-deployment CodeDeploy .

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