AWS ECSでNginx

SSKR

2023年2月15日 22:13

AWSのコンテナサービスECSを試してみた
ローカル環境はWindows11を使っている

大まかな流れ

事前準備
DockerDesktopでコンテナイメージを作成
Amazon ECRにコンテナイメージを登録
Amazon ECSにデプロイ
動作確認

事前準備

ECSはバックエンドの仕事をするうえで重要な知識だと思う
しかしいろいろわかりにくい
少しだけ整理してみた

まずはDocker Desktopのインストールが必要

AWS CLIもインストールが必要

DockerDesktopでコンテナイメージを作成

まずはDockecr DesktopとWindows Power Shellを起動しておく

ローカル環境にフォルダを作り（この場合は適当にnginx）その下にDockerfileとindex.htmlファイルを作成する

nginx
┗ Dockerfile
┗index.html

ファイルの内容は以下の通り

Dockerfile

FROM nginx:latest
COPY index.html /usr/share/nginx/html
EXPOSE 80

index.html

<!DOCTYPE HTML>
<html lang=”ja”>
<head>
  <meta charset="UTF-8">
  <title>Hello, World</title>
</head>
<body>
  <h1>Hello, World</h1>
</body>
</html>

PowerShell上で作成したフォルダに移動

cd X:\xxxx\xxx\nginx

Dockerイメージをnginx-testという名前で作成する
コマンドの一番最後の . はカレントディレクトリを意味する . なので
かならすnginx-test のあと空白をいれて . と入力する

docker build -t nginx-test .

成功するとDockerDesktopのImagesに追加されるのが確認できる

念のため動作確認
ローカル環境にコンテナをデプロイ

docker run -p 80:80 -d nginx-test

ブラウザ上で

http://localhost/

にアクセスして

と出ればOK
起動し続ける必要はないのでDockerDesktopのContainers上でコンテナを破棄しておく

Amazon ECRにコンテナイメージを登録

ECRはElastic Container Registryの略で、コンテナイメージを登録しておくDockerHubのような場所

ECR上にリポジトリを作成する

GUI上で作成してもいいが今回はコマンドラインで作ってみる

aws ecr create-repository --repository-name nginx-test

成功すると作られたリポジトリの情報が表示される

{
    "repository": {
        "repositoryArn": "arn:aws:ecr:ap-northeast-1:????????????:repository/nginx-test",
        "registryId": "????????????",
        "repositoryName": "nginx-test",
        "repositoryUri": "????????????.dkr.ecr.ap-northeast-1.amazonaws.com/nginx-test",
        "createdAt": "2023-02-14T11:35:48+07:00",
        "imageTagMutability": "MUTABLE",
        "imageScanningConfiguration": {
            "scanOnPush": false
        },
        "encryptionConfiguration": {
            "encryptionType": "AES256"
        }
    }
}

dockerコマンドでECRにアクセスできるようにする

aws ecrのログインパスワードを取得してdockerにログインする
リージョンは東京(ap-northeast-1)の前提

aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin 255885943062.dkr.ecr.ap-northeast-1.amazonaws.com

成功するとLogin Succeededと表示される

コンテナイメージをリネームする

ECRにコンテナイメージを登録するためには決められた名前が必要らしい
docker tagコマンドを使う

docker tag [既存のイメージID] [新しいイメージ名]

新しいイメージ名はaws ecr create-repositoryを使ったときに表示された
repositoryUriにタグを追加したものになる

docker tag {イメージID} {アカウントID}.dkr.ecr.ap-northeast-1.amazonaws.com/nginx-test:{タグ}

{アカウントID}.dkr.ecr.ap-northeast-1.amazonaws.com
ここのアカウントIDはリポジトリの作成時に表示された
"repositoryUri": "????????????.dkr.ecr.ap-northeast-1.amazonaws.com/nginx-test",
この????????????に相当する12桁の数値になる

別の確認の仕方としては

aws sts get-caller-identity

を実行すると表示されるAccountの数字がそう

また、{イメージID}のほうは

docker images

このコマンドを使えば確認することができる１２桁の数値だ

{タグ}はイメージを識別するための文字列で
バージョン情報などを追加しておく
今回はlatestとつけることにする

まとめると以下のようなコマンドになる

docker tag 999999999999 000000000000.dkr.ecr.ap-northeast-1.amazonaws.com/nginx-test:latest

成功するとDockerDesktopのImagesタブで、新しい名前のコンテナイメージが追加されているのを確認することができる

ECRにプッシュする

docker push {アカウントID}.dkr.ecr.ap-northeast-1.amazonaws.com/nginx-test:{タグ}

{アカウントID}と{タグ}は上と同じ

実行するとデータのアップロードが始まり数分程度で終了する

GUIで確認してみる

AWSコンソールからElastic Container Serviceに飛ぶ

左のタブからリンクで移動できる

左のタブからRepositoriesを選択

追加されていることが確認できる

Amazon ECSにデプロイ

ECRに登録したコンテナイメージをECSにデプロイする
ここからはGUIを使ってすすめる

ECSのトップ画面から

クラスターを作成する

ECSトップ画面で左のタブからクラスターを選択したあとで
クラスターの作成を押す

クラスター名を適当に設定
今回は nginx-test-cluster とつけた

VPCとサブネットを選択

VPCは、AWSのアカウントを作ればデフォルトのVPCが作られているのでそれを選択してもよいし、新たに作り直してもよい

以下の記事はVPCの説明と作成手順を書いている

VPCとサブネットを選択する
サブネットはパブリックサブネットを最低２つ選択する

インフラを選択する
Fargateを利用するのでデフォルトのまま

モニタリングとタグも特に設定せず
[作成]を選択

メッセージが表示されて作成される

タスク定義を作成する

タスク定義ではコンテナイメージのURLや起動させるインスタンスに割り当てるメモリやCPUなどを指定する

左のタブからタスク定義を選択し[新しいタスク定義の作成]を押す

二つの選択肢が選べるので、今回はJSONを使わない方法ですすめる

Step1
タスク定義ファミリー名：nginx-test-task-family
コンテナ名：nginx
イメージURI：????????????.dkr.ecr.ap-northeast-1.amazonaws.com/nginx-test
コンテナポート：80
プロトコル：TCP
ポート名：nginx-80-tcp（自動作成）
アプリケーションプロトコル：HTTP