この記事ではNode.jsアプリケーションをビルドし、Amazon Elastic Container Registry (ECR)およびAmazon Elastic Container Service (ECS)を用いてAmazon Web Services (AWS)へ展開することについてお話しします。具体的に言えば、以下のような手順があります。

1) 環境構築

NodeとNpmodeについて こちら へアクセスしてから最新バージョンをインストールしてください。

Docker(ドッカー)について こちら へアクセスしてから最新バージョンをインストールしてください。

AWS アカウントについて無料アカウントを登録しておいてください。

AWS CLIについてこちらへアクセスしてから、お使いのOSに応じて手順を行ってください。

2) DockerおよびAWSの概要

Dockerとは、どこへもプッシュし、実行できるコンテナを用いてアプリケーションと依存関係や環境変数をビルドするためのオープンソースソフトウェアをいいます。Dockerではハードウェアやフラットフォームから隔離しているのでコンテナに入るアプリケーションをどんな環境にも独立的に実行することができます。

Amazon Web Services (AWS)は費用のかからない拡張可能かつ安全なクラウドサービスを提供します。前述の如く、この記事ではECRとECSのサービスについてのみお話しします。

3) Node.jsアプリ作成

以下のように展開のためのサンプルアプリケーションを予め作成しておいてください。簡単なNode.jsアプリケーションで良いです。

端末に以下のように入力します。

// 新たなディレクトリー作成
$ mkdir ecs-nodejs-app

// 作成したてのディレクトリーへの移動 
$ cd ecs-nodejs-app

// npm初期化
$ npm init -y

// expressインストール
$ npm install express

// server.jsファイル作成
$ touch server.js

server.jsファイルを開いて、以下のコードをそこにコピー・ペーストします。

// server.js

const express = require('express')
const app = express()

app.get('/', (req, res) => {
res.send('Welcome from a Node.js app!')
})

app.listen(3000, () => {
console.log('Server is up on 3000')
})

以下のコマンドでアプリケーションを起動します。

$ node server.js

ブラウザを開いて http://localost:3000 にアクセスすると、「Welcome from a Node.js app! 」が表示されます。

次の手順でアプリケーションをビルドします。

4) Dockerファイル作成

以下のように、ルートディレクトリーにDockerファイルというユニークなファイルを作成することによりアプリケーションをビルドします。なお、このファイルには拡張子がありません。

FROM node:8-alpine
RUN mkdir -p /usr/src/app
WORKDIR /usr/src/app
COPY . .
RUN npm install
EXPOSE 3000
CMD [ "node", "server.js" ]

5. Dockerイメージのビルド

Dockerを設定して実行したことを確認してください。今やDockerファイルが作成済なので、以下のようにDockerイメージを「 -t 」コマンドでビルドします。

$ docker build -t ecs-nodejs-app .

6. Dockerコンテナ実行

これまで、Dockerイメージ作成の完了です。作成したDockerイメージを確認するために以下のコマンドを打ちます。

$ docker images

作成したてのDockerイメージは登録時間で一番新しいものです。

前もってイメージIDをコピーしておきます。コンテナを実行するために以下のコマンドを打ちます。

$docker run -p 80:3000 {image-id}

// コピーしたイメージIDを{image-id}に入れます。

ここで、ポート：80:3000へアプリケーションを展開します。Dockerをローカル実行するのでhttp: // localhost にアクセスして確認します。

7. レジストリ作成およびそこへのDockerイメージのプッシュ

Amazon Elastic Container Registry (ECR) は、完全マネージド型のコンテナレジストリです。このレジストリを使うと、コンテナイメージをどこにでも簡単に保存、管理、共有、デプロイすることができます。 Amazon ECR はAmazon Elastic Container Service (ECS)と連携して開発から本稼働までのワークフローを簡素化することができます。

Dockerイメージをプッシュする前に、以下のコマンドを実行して、AWS CLIが自分のAWSアカウントで接続できていることを確認してください。

$ aws configure

AWS CLIが既にインストールされた場合、AWS設定として以下の情報が求められます。

$ aws configure
AWS Access Key ID [None]: <accesskey>
AWS Secret Access Key [None]: <secretkey>
Default region name [None]: us-east-2
Default output format [None]:

AWS CLIが正確に設定されていることを確保するため、AWS設定コマンドを再度実行して、表示される確認プロンプトでエンターキー押下してください。

レジストリ作成の手順は以下の通りとなります。

まず、AWSマネジメントコンソール へアクセスし、ログインを行います。

つぎ、Servicesカテゴリーから、Containersの中にあるElastic Container Service（ECS）を選択します。

つぎ、左メニューのECRからはRepositoriesへ辿ってから、Create Repositoryメニューを選択した後に、リポジトリ名（例："ecs-nodejs-app"）を入力してCreate Repositoryボタンを押します。

つぎ、右上にあるView Push Commandsをクリックした時に表示される4つの手順どおりに、Dockerイメージをビルド、タグ作成し、プッシュします。

その後、Amazon ECRへ戻って、先ほど入力したリポジトリ名をクリックするとDockerイメージが見えます。 次の手順に使うので、そのイメージのURIをコピーしておいてください。

次の手順で、 EC2インスタンスでDockerイメージを実行するために使われるTask Definitionというタスク定義）、Clusterというクラスター、Serviceというサービスを作成します。

8. タスク定義の作成

AWSでのタスクはDocker CLIでのDocker実行コマンドのように機能しており、以下のように定義されています。

• Container images
• Volumes
• Networks Environment Variables
• Port mappings

以下に、タスク定義の作成手順を示します。

9. クラスターの作成

以下に、クラスターの作成手順を示します。

処理に数分がかかります。終わったらView Clusterを押下することで、Active状態が見えます。

10. クラスター実行用サービスの作成

この手順で、クラスターを実行するためのサービスを作成します。

以下に、サービスの作成手順を示します。

ClusterからEC2 instancesタブで対象のインスタンス・コンテナを押すことで公開DNSリンクを生成します。

ブラウザーでその公開DNSへアクセスすると、作成したアプリが開きます。

ec2-52-193-75-195.ap-northeast-1.compute.amazonaws.com

Githubからサンプルソースを参考にしましょう！

参考元

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started.html

https://blog.clairvoyantsoft.com/deploy-and-run-docker-images-on-aws-ecs-85a17a073281

https://medium.com/boltops/gentle-introduction-to-how-aws-ecs-works-with-example-tutorial-cea3d27ce63d