Fargate の Amazon ECS タスクからデータベースに接続する方法を教えてください。

解決策

前提条件:

• Fargate で実行される Amazon ECS クラスターが必要です
• Amazon Relational Database Service (Amazon RDS) のデータベースが必要です。Amazon ECS と Amazon RDS に通信の問題がある場合は、「Amazon EC2 起動タイプの Amazon ECS タスクと Amazon RDS データベースとの間の接続に関する問題のトラブルシューティングするにはどうすればよいですか?」を参照してください。

注: 次の解決策では MySQL データベースエンジンを使用しています。他のエンジンタイプを使用するデータベースに接続する方法の詳細については、「Amazon RDS のスタート方法」を参照してください。

タスクをデータベースに接続する

次の手順を実行します。

1. MySQL データベースに接続する Python スクリプトを作成します。次の rds.py サンプルスクリプトでは、データベースへの接続の結果を Amazon CloudWatch に送信します。

   import pymysql
   import os
   
   DATABASE_ENDPOINT = os.environ['example_endpoint']
   USERNAME = os.environ['example_username']
   PASSWORD = os.environ['example_password']
   
   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))

   注: example_endpoint を実際のデータベースのエンドポイントに置き換えてください。example_username をユーザー名に置き換えてください。**example_password ** を実際のパスワードに置き換えてください。

2. イメージを組み立てるために、必要なコマンドを含む Dockerfile を作成します。次のサンプルファイルには、必要なコマンドが含まれています。

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

3. Amazon Elastic Container Registry (Amazon ECR) リポジトリを作成し、そのリポジトリに Docker イメージをプッシュします。

4. タスク定義を作成し、その後に Docker イメージをコンテナイメージとして追加します。

   {  "executionRoleArn": "arn:aws:iam::example_account_ID:role/ecsTaskExecutionRole",  
     "containerDefinitions": [
       {
         "name": "example_app",
         "image": "example_repository_URL",
         "essential": true
       }
     ],
     "requiresCompatibilities": [
       "FARGATE"
     ],
     "networkMode": "awsvpc",
     "cpu": "256",
     "memory": "512",
     "family": "example_app"
   }

   注: example_account_ID を、お使いの AWS アカウント ID に置き換えてください。**example_app ** をアプリケーションの名前に置き換えてください。example_repository_URL を Amazon ECR リポジトリの URL に置き換えてください。タスク定義で ENDPOINT、USER、および PASS 環境変数の値を設定するのがベストプラクティスです。これらの値は、環境変数として直接渡すか、AWS Secrets Manager のシークレットから取得できます。詳細については、「Amazon ECS タスクにおいて、シークレットや機密情報をコンテナに安全に渡す方法を教えてください」を参照してください。

5. Amazon ECS コンソールを開きます。

6. ナビゲーションペインで、[タスク定義] をクリックします。

7. タスク定義を選択し、[アクション]、[タスクの実行] の順にクリックします。

8. [起動タイプ] で [FARGATE] を選択します。

9. [クラスター] で、タスク定義用のクラスタを選択します。

10. [タスクの数] に、実行するタスクの数を入力します。

11. [VPC とセキュリティグループ] セクションの [クラスター VPC] で、Amazon Virtual Private Cloud (Amazon VPC) を選択します。

12. [サブネット] で、サブネットを選択します。

13. [セキュリティグループ] で、少なくとも 1 つのセキュリティグループを選択します。

14. [タスクの実行] をクリックします。

タスクがデータベースに接続されると、rds.py スクリプトはタスクを停止し、次のメッセージを表示します。

"Essential container in task exited."

タスクがデータベースに接続されたことを確認する

次の手順を実行します。

1. Amazon ECS コンソールを開きます。
2. ナビゲーションペインで [クラスター] をクリックしてから、クラスターを選択します。
3. [タスク] タブをクリックします。
4. [必要なタスクのステータス] で、停止したタスクのリストを表示するために、[停止] を選択します。
5. 停止したタスクを選択します。
6. 停止したタスクの [詳細] タブの [コンテナ] セクションを展開します。
7. [CloudWatch でログを表示] をクリックします。

タスクをデータベースに正常に接続すると、CloudWatch コンソールに次のメッセージが表示されます。

"Connection successful to [your endpoint]"