Référence des actions de déploiement d'Amazon Elastic Container Service - AWS CodePipeline
Type d'actionParamètres de configuration Artefacts d'entréeArtefacts de sortieDéclaration d'actionConsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Référence des actions de déploiement d'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 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 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 déjà avoir créé les ressources Amazon ECS, é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 standard d'Amazon ECS pour CodePipeline. Pour obtenir des informations de référence sur les actions de déploiement d'Amazon ECS 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 cluster Amazon ECS dans Amazon ECS.

ServiceName

Obligatoire : oui

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

FileName

Obligatoire : non

Le nom de votre fichier de définitions d'images, le fichier JSON 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 standard ECS. 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 de l'action de déploiement d'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'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 fichier JSON qui décrit le nom de votre conteneur Amazon ECS, 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'Amazon ECR. 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 d'image est fourni par le imagedefinitions.json fichier, 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'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"
        }
    ]
},

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

  • Consultez Tutoriel : Créez et envoyez une image Docker vers Amazon ECR avec CodePipeline un didacticiel qui explique comment utiliser le pour ECRBuildand PublishAction envoyer une image, puis utiliser l'action standard ECS pour le déployer sur Amazon ECS.

  • 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 un service Amazon ECS et une définition de tâche, puis vous créez votre pipeline avec 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 les actions de déploiement d'Amazon ECS vers le CodeDeploy bleu/vert dans CodePipeline, consultez. Tutoriel : Création d'un pipeline avec une source Amazon ECR et déploiement ECS-to-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, ainsi que des ensembles de tâches Amazon ECS, consultez Qu'est-ce qu'Amazon ECS ?