Comment gérer les volumes EBS pour les tâches Amazon ECS ?

Résolution

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Prérequis :

• Utilisez un rôle AWS Identity and Access Management (IAM) de l'infrastructure Amazon ECS pour créer un service ou une tâche autonome qui configure un volume lors du déploiement.
• Utilisez un système d'exploitation (OS) et un type de lancement pris en charge.
• Vérifiez les considérations relatives aux volumes Amazon EBS.
• Sélectionnez une option de stockage pour les tâches Amazon ECS en fonction de vos besoins.

Pour associer un nouveau volume EBS à votre tâche, spécifiez les configurations suivantes dans votre définition de tâche sous mountPoints :

• Pour sourceVolume, entrez le nom du volume que vous souhaitez monter.
• Pour containerPath, entrez le chemin dans l'instance de conteneur où vous montez le volume.
• Pour readOnly, entrez vrai ou faux selon que le conteneur dispose d'un accès en lecture seule au volume.

Puis, définissez configuredAtLaunch sur vrai.

Exemple de définition de tâche :

{
    "family": "mytaskdef",
    "containerDefinitions": [
        {
            ....
            #Some fields removed from example
            ....
            "mountPoints": [
                {
                    "sourceVolume": "myEBSVolume",  
                    "containerPath": "/mount/ebs",  
                    "readOnly": true                
                }
            ]
        }
     ],
     ....
     #Some fields removed from example
     ....
     "volumes": [
        {
            "name": "myEBSVolume",                 
            "configuredAtLaunch": true
        }
    ]
}

Enregistrez le modèle de définition de tâche dans un fichier JSON, puis exécutez register-task-definition pour enregistrer la définition de tâche :

aws ecs register-task-definition \
    --cli-input-json file://json_file_name.json \
    --region Region_name

Remarque : Remplacez json_file_name.json par votre fichier JSON et Region_name par votre région AWS.

Configurez ensuite le volume Amazon EBS lors du déploiement lorsque vous exécutez une tâche autonome. Vous pouvez également le configurer lorsque vous créez ou mettez à jour un service.

Pour utiliser les données d'un volume EBS existant, créez un instantané du volume. Puis, ajoutez l'ID de l’instantané pour SnapshotID sous VolumeConfigurations dans la définition de tâche. Pour un exemple de configuration, consultez la section Configurer un volume lors de la création du service.

Informations connexes

Résolution de problèmes liés aux pièces jointes de volumes Amazon EBS aux tâches Amazon ECS

Utiliser les volumes Amazon EBS avec Amazon ECS