f:id:fyui001:20220406154645p:plain

みなさんどうもこんにちは。エンジニアのゆい（@fyui_001）です。

前回に引き続きEB(Elastic Beanstalk)からECSに移行したプロジェクトでの取り組みを紹介します。

今回はECSのコンテナにアクセスするためのECS ExecというAWSのサービスを使ってECS上で動いているコンテナに入る方法についてお話しようと思います。

前回の記事はこちら！

Laravel on ECSで動かすQueueとScheduleワーカー

背景

弊社ではデプロイ時にデータ投入のための一度限りのバッチ実行をEBにSSHで入り行っていたのですが、ECSに移行し、どうやってサービスの実行環境に入りリリース作業を行うかと言う課題がありました。

Dockerコンテナにsshエージェントを入れるのはイケてないなと言う判断があり、なにか手段がないか調べいていたところECS Execにたどり着きました。

AWSにはデバッグ用にECS Execと言うサービスが用意されており、ECS Execを使うことでコンテナのポートを開けてsshしたりsshキーの管理をすることなく直接ECS環境のコンテナで作業することができます。

公式ドキュメントはこちら

ECS ExecでECS環境に入る

前提条件

以下がマシンにインストールされている必要があります。

aws cli
session manager (公式ドキュメント)

※session managerが入ってないと使えないのでちゃんとインストールして設定が必要です。

またSSMサービスに必要なアクセス許可をコンテナに付与するために、タスクIAMロールを設定する必要があります。

Fargateのコンテナにアクセス

入りたいコンテナのタスクIDを調べる

ecs execにはtask-idを指定しないと行けないですが、コンソールで見つけられなかったので以下がCLIで覗く方法です。

下記コマンドでクラスター名とサービス名を指定するとタスクのリストを出してくれるので見てます。

# 環境毎にクラスタ名とサービス名は違うので適宜いい感じに書き換えてください。
aws ecs list-tasks --cluster {cluster-name} --service-name {service-name}

こんな感じに出てきます。クラスター名から先の文字列がタスクIDなのでちょっとメモっておく。

f:id:fyui001:20220406182521p:plain

コンテナの中に飛び込む

次のコマンドを実行してコンテナに入ります。 taskオプションにさっき調べたタスクIDを渡して、containerオプションでコンテナ名を指定します。詳しくは公式ドキュメントを参照。

aws ecs execute-command --cluster {cluster-name} \
    --task {task-id} \
    --container {container-name} \
    --interactive \
    --command "/bin/sh"

実際に入ってみる

※ タスクIDはちゃんとAWS CLIで確認して実行しましょう。(下記コマンドをコピペするべからず

aws ecs execute-command --cluster ecs-cluster \
    --task ************************* \
    --container app \
    --interactive \
    --command "/bin/sh"

こんな感じになっていれば成功！

f:id:fyui001:20220406182606p:plain