目的
AWSのEC2でDockerで動かしていたプロジェクトを起動させ、アプリをHostingすること。
目次
- EC2 Instanceを起動
- SSHでInstanceに接続
- GitとDockerをインストールする
- 事前にBuildしたイメージを使うか、EC2でBuildするか
- RepositoryをcloneしてDockerイメージをBuildする方法
- Docker Hubからイメージをダウンロードする方法
- コンテナを立ち上げる
- セキュリティグループを設定する
EC2 Instanceを起動
まずはこれから使うクラウド上のEC2 Instanceを立ち上げます。
EC2は、AWSでいう巨大な機械の最も基礎的な部品です。クラウド上で仮想コンピューターを作ってくれるサービスです。
インスタンスを起動をクリックします。
マシンイメージを選択します。Linux、Windows、Macまでも選べますが、AWSのまーさる機能が込み込みのAmazon Linuxを使いたいので、一番上のKernel 5.10を選びましょう。
次はインスタンスタイプを指定します。これは、どれぐらいの資源を割り当てるかを決めるところですが、今回は無料枠を使いたいので、初期値のt2.microを使います。
機械学習とか、画像処理とか、多くのCPU資源を要するプロジェクトだったらここでその割り当てができます。
次は詳細の設定でネットワーク設定を行いますが、下記のネットワークの部分にデフォルトの選択肢を選びます。なければ、新しいVPCの作成をクリックして作ってください。
他の設定は変えなくてもいいので、そのまま確認と作成をクリックします。
そして次のページでネットワークのセキュリティがやばいけど？という警告は出ます。これは、Instanceへの接続をどのIPアドレスからも許可しているからです。今度、アクセスができるIPアドレスを指定する方法について解説します。今回はそのままで起動をクリック。
次の手順は非常に重要です。SSHで接続するには、キーペア（RSA鍵）が必要です。
新しいキーペアを作成し、名前をつけて、ダウンロードしましょう。この鍵を持っていれば、誰でも接続できる状態になっているので、扱いにご注意ください。
ダウンロードできたら、作成ボタンをクリックします。
インスタンスが起動するまで待ちます。起動できたらこのような画面が確認できます。
SSHでInstanceにアクセスする
まずダウンロードしたキーペア.pemファイルをユーザーのrootダイレクトリーに入れます。
Mac OSの場合だと、/Users/{ユーザー名}のところです。
それからTerminal（ターミナル）を開き、以下のCommandを実行
rootのダイレクトリーに念のために戻る
cd ~
ダウンロードした.pemファイルを隠れフォルダーの.sshに入れます。
mv next-socketio-chat.pem .ssh/
次、.pemファイルの権限をchownでお使いのパソコンのユーザーに直さないと読めないので、以下のCommandを実行します。
cd .ssh/
chmod 400 next-socketio-chat.pem
これでこのキーペアが使えるので、接続してみましょう。 -i で.pemファイルを接続するときに使うように指定します。00-00-00-00のところは自分のパブリックIPv4アドレスを入れてください。
ssh -i "next-socketio-chat.pem" ec2-user@ec2-00-00-00-00.ap-northeast-1.compute.amazonaws.com
これで、この画面が出てきて、EC2に入れたぞ！ってことがわかって、喜ぶ場面になり、ティッシュで涙を拭い、下記を読み続けます。
GitとDockerをインストール
EC2のAmazon Linuxはyumでパッケージをインストールします。
一番最初にパッケージのアップデートをした方がいいので、以下のCommandを実行します。 -y はYes・Noを聞かれる時に全部Yesで答えといてくれよーという意味を持っています。
sudo yum update -y
次、Gitをインストールします。
sudo yum install git -y
並びに、Dockerを。だけど、ここは普通のインストールじゃなくて、AWSのサービスを通してインストールすると楽なので、以下のCommandを実行します。
sudo amazon-linux-extras install docker
GitもDockerも無事にインストールされたことを以下のCommandで確認できます。
docker --version
git --version
DockerのServicesを起動させます。
sudo service docker start
ここまでくると、Dockerが普通に使えます。dockerのCommandの前にsudoを付ける必要があります。
事前にBuildしたイメージを使うか、EC2でBuildするか
進む前に、少し解説したいです。
EC2にイメージを持ってくるのに二つのやり方があります。
- EC2上にソースコードをGitなどでcloneし、そこでBuildする方法
- ローカルのパソコンで作ったイメージをDocker Hubなどにアップロードして、EC2でそれをダウンロードする方法
筆者は後者の方法をお勧めします。なぜなら、イメージを実行するのは環境に依存しないが、イメージをBuildするのは環境に依存することがあるからです。
Dockerでそういった悩みを解決したわけだし、せっかくローカルで駆動実験を行ったわけだから、それをそのまま使いたいでしょう？
しかし、ネット環境が悪かったりして、イメージをアップロードするのはめんどいということもあるだろうから、両方の方法をご紹介しましょうね。
RepositoryをcloneしてDockerイメージをBuildする方法
これから筆者が前回の記事で作ったNextアプリを使います。
https://qiita.com/tronicboy/items/7969a77817d8f2706b52
GitHubからソースコードをgitでcloneします。
git clone https://github.com/tronicboy1/next-socket.io-chat.git
そしてnext-socket.io-chatのフォルダーに入ってイメージをBuildします。
cd next-socket.io-chat/
sudo docker build -t next-socketio-chat .
このメッセージが表示されれば、無事にBuildできました！
Docker Hubからイメージをダウンロードする方法
もう一つのやり方があります。それは、Dockerイメージを事前にBuildして、Docker Hubなどにアップロードしたものを、EC2 Instanceにダウンロードする方法です。
今回は筆者がアップロードしたイメージを使いましょう。
https://hub.docker.com/repository/docker/tronicboy/next-socket.io-chat
以下のCommandを実行すればダウンロードされます。
sudo docker pull tronicboy/next-socket.io-chat:latest
ちなみに、次のdocker runのCommandを実行する時点で上記のイメージがダウンロードされていなければ、Dockerが自動でPullしてくれるので、正直にいうとこれは不要です。
とりあえず、イメージがあることを確認しましょう。
sudo docker images
バッチリ大丈夫やっさー
コンテナを立ち上げる
次はEC2上でコンテナを作って実行します。
sudo docker run -d --rm -p 80:3000 tronicboy/next-socket.io-chat
EC2側のPortは80番で、Nodeはソースコードで指定している3000番。EC2側でPortの80番を使うのは、下記のセキュリティグループ設定でわかりますが、外部からのHTTPリクエストは80番のみが許可される仕組みになっているからです。
セキュリティグループを設定する
今、Dockerでアプリを立ち上げて、よし！開けてみよう！と思ったら、ちょっと待った！今パブリックのIPアドレスで開こうとしてもつながりません。
セキュリティーグループで設定をしないと無理です。
まず、AWSで先ほど作成したInstanceの管理画面の下の方でセキュリティのタブをクリックして、セキュリティグループへのリンクをクリックします。
「インバウンドルールを編集」をクリックします。
今表示されているのはPortの22番でSSHのための接続を許可するルールです。HTTPリクエストを許可するルールを追加したいので、追加をクリックします。
そして以下のように設定を変えて、保存します。
そうするとパブリックのIPv4アドレスでアクセスすると、見事に顔を出してくれます！
まとめ
以上、最も簡単なやり方でDockerのイメージをEC2上で起動させ、外部からアクセスできるようにしました。
dockerの前にsudoを使わんといけんかったり、実はこの辺にEC2の大事なことが秘められているのですが、今回はそれらについて触れてないです。
これからはより洗練されたやり方について記事を書いていきたいと思っています。