Comment me connecter à une base de données à partir d'une tâche Amazon ECS sur Fargate ?

Résolution

Prérequis :

• Vous devez disposer d’un cluster Amazon ECS qui s’exécute sur Fargate
• Vous devez disposer d’une base de données Amazon Relational Database Service (Amazon RDS). Amazon ECS et Amazon RDS peuvent rencontrer des problèmes de communication. Pour plus d'informations, consultez Comment résoudre les problèmes de connectivité entre mes tâches Amazon ECS pour un type de lancement Amazon EC2 et une base de données Amazon RDS ?.

Remarque : l'exemple suivant utilise MySQL comme type de moteur. Pour plus d’informations sur les types de moteurs, consultez la section Premiers pas avec Amazon RDS.

Connectez votre tâche à votre base de données

Procédez comme suit :

1. Créez un script Python qui se connecte à votre base de données MySQL. L'exemple de script rds.py suivant envoie les résultats de la connexion à la base de données vers Amazon CloudWatch :

   import pymysqlimport os
   Database_endpoint = os.environ['ENDPOINT']
   Username = os.environ['USER']
   Password = os.environ['PASS']
   try:
     print("Connecting to " + Database_endpoint)
     db = pymysql.connect(host = Database_endpoint, user = Username, password = Password)
     print("Connection successful to " + Database_endpoint)
   db.close()
   except Exception as e:
     print("Connection unsuccessful due to " + str(e))

   Remarque : remplacez POINT DE TERMINAISON, UTILISATEUR et PASSER par les valeurs de votre base de données.
2. Pour assembler une image, créez un Dockerfile qui inclut les commandes requises. Exemple :

   FROM pythonRUN pip install pymysql cryptography
   COPY rds.py /
   CMD [ "python", "/rds.py" ]

   Important : placez votre script rds.py et Dockerfile dans le même dossier.
3. Créez un référentiel Amazon ECR, puis transférez l’image Docker vers ce référentiel.
4. Créez une définition de tâche, puis ajoutez l'image Docker en tant qu’image du conteneur. Exemple :

   {
     "executionRoleArn": "arn:aws:iam::account_ID:role/ecsTaskExecutionRole",
     "containerDefinitions": [
       {
         "name": "sample-app",
         "image": "YOUR-ECR-Repository-URL",
         "essential": true
       }
     ],
     "requiresCompatibilities": [
       "FARGATE"
     ],
     "networkMode": "awsvpc",
     "cpu": "256",
     "memory": "512",
     "family": "sample-app"
   }

   Remarque : dans la définition de votre tâche, définissez les valeurs des variables d'environnement POINT DE TERMINAISON, UTILISATEUR, et PASSER. Vous pouvez transmettre ces valeurs directement sous forme de variables d'environnement ou récupérer les valeurs de secrets dans AWS Secrets Manager. Pour plus d’informations, consultez Comment puis-je transmettre des secrets ou des informations sensibles en toute sécurité à des conteneurs dans le cadre d’une tâche Amazon ECS ?
5. Ouvrez la console Amazon ECS.
6. Dans le volet de navigation, choisissez Définitions de tâche.
7. Sélectionnez votre définition de tâche, choisissez Actions, puis sélectionnez Exécuter la tâche.
8. Pour le Type de lancement, choisissez FARGATE.
9. Pour Cluster, choisissez le cluster pour la définition de votre tâche.
10. Dans Nombre de tâches, entrez le nombre de tâches que vous souhaitez copier.
11. Dans la section VPC et groupes de sécurité, pour Cluster VPC, choisissez votre Amazon Virtual Private Cloud (Amazon VPC).
12. Pour Sous-réseaux, choisissez vos sous-réseaux.
13. Pour Groupes de sécurité, sélectionnez au moins un groupe de sécurité.
14. Choisissez Exécuter la tâche.

Le script rds.py arrête la tâche et renvoie le message suivant :

« Le contenant essentiel de la tâche est sorti ».

Vérifiez que votre tâche est connectée à votre base de données

Procédez comme suit :

1. Ouvrez la console Amazon ECS.
2. Dans le volet de navigation, choisissez Clusters, puis sélectionnez votre cluster.
3. Choisissez l'onglet Tâches.
4. Pour Statut des tâches souhaitées, pour afficher la liste des tâches arrêtées, choisissez Arrêté.
5. Choisissez votre tâche arrêtée.
6. Dans l'onglet Détails de votre tâche arrêtée, dans la section Conteneurs, développez la section.
7. Choisissez Afficher les journaux dans CloudWatch.

Le message suivant s’affiche dans la console CloudWatch :

« Connexion réussie à [Votre point de terminaison] »