はじめに
この記事では、ECS コンテナ内で MySQL クライアントを使用して RDS に接続する手順を解説します。
個人の備忘録程度の走り書きとなっておりますが、温かい目で見守っていただければ幸いです。
ECS 上で動作するアプリケーションが RDS を利用する場合に役立ちます。
書こうと思ったきっかけ
ECS を使用した環境で、RDS に正しく接続する方法がわからず困っている人が多いと感じました。
特に、環境変数の設定やセキュリティグループの設定が原因で接続に失敗するケースがよくあります。
本記事では、そうしたトラブルを防ぐための具体的な手順をまとめました。
1. RDS の接続情報を確認
RDS に接続するためには、以下の情報が必要です。
| 項目 | 説明 |
|---|---|
| RDS ホスト名 |
MYSQL_HOST 環境変数に設定されている |
| ポート |
MYSQL_PORT=3306 (通常は 3306) |
| ユーザー名 |
MYSQL_USER 環境変数 (例: myuser) |
| パスワード |
MYSQL_PW 環境変数 (基本的にAWS Secrets Manager から取得される) |
| データベース名 |
MYSQL_DB 環境変数 (例: mydatabase) |
環境変数の確認
まず、ECS コンテナ内で環境変数を確認してください。
/app # env | grep MYSQL
期待される出力例:
MYSQL_HOST=mydatabase.abcd1234.ap-northeast-1.rds.amazonaws.com
MYSQL_PORT=3306
MYSQL_USER=myuser
MYSQL_DB=mydatabase
MYSQL_PW=mypassword123 # AWS Secrets Manager から取得される場合、表示されない
2. MySQL クライアントをインストール
ECS のコンテナに MySQL クライアント (mysql) がインストールされていない場合は、apk を使用してインストールできます。
/app # apk add --no-cache mysql-client
3. RDS に接続
以下のコマンドを実行して、RDS に接続します。
/app # mysql -h $MYSQL_HOST -P $MYSQL_PORT -u $MYSQL_USER -p$MYSQL_PW $MYSQL_DB
または、環境変数を直接入力する場合:
/app # mysql -h mydatabase.abcd1234.ap-northeast-1.rds.amazonaws.com -P 3306 -u myuser -p mydatabase
成功すると、以下のような MySQL プロンプトが表示されます。
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 123
Server version: 8.0.39 MySQL Community Server - GPL
mysql>
4. RDS に接続できない場合の確認ポイント
もし RDS に接続できない場合、以下をチェックしてください。
-
MYSQL_HOSTの値が正しいか？
/app # echo $MYSQL_HOST
-
RDS のセキュリティグループに ECS のセキュリティグループが許可されているか？
Terraform で ECS のセキュリティグループ (ecs_sg) から RDS のセキュリティグループ (rds_sg) にアクセス許可があるか確認。 -
RDS のステータスが
availableになっているか？
aws rds describe-db-instances --query "DBInstances[*].DBInstanceStatus"
もし stopped になっていたら、起動する。
- RDS のパスワード (
MYSQL_PW) を AWS Secrets Manager から取得する場合、正しく設定されているか？
/app # echo $MYSQL_PW
もし空欄なら、ECS のタスク定義で AWS Secrets Manager の参照が正しく設定されているか確認。
5. RDS のテーブル一覧を確認
RDS に接続できたら、データベースのテーブル一覧を表示してみましょう。
SHOW TABLES;
もし migrate_app でテーブルが作成されているなら、
users, categories, questions, answers, choices, scores などのテーブルが表示されるはずです。
まとめ
-
env | grep MYSQLで環境変数を確認 -
apk add --no-cache mysql-clientで MySQL クライアントをインストール -
mysql -h $MYSQL_HOST -P $MYSQL_PORT -u $MYSQL_USER -p$MYSQL_PW $MYSQL_DBで接続 - 接続できない場合は RDS のセキュリティグループやステータスを確認
この手順に従えば、ECS コンテナから RDS に接続できるはずです。