【macOS】LocalStack+terraformでEC2+RDSを立ててみた

ハク（エンジニア）

2023.06.19

注意

LocalStackのPro版（有料版）のAPIキーが必要
- Pro版の体験版（14日間）があるので、そちらを使用しています
LocalStackとterraformとAWSのネットワーク設定周りは素人のため、間違っている箇所があるかもしれないがご容赦ください

準備

LocalStackをインストール

参考: https://docs.localstack.cloud/getting-started/installation
- 僕はLocalStack CLIでインストール
下記ツールが必要のため、事前にインストール
- python (version: 3.7 ~ 3.10)
- pip
- docker
LocalStackをインストール

PHP

brew install localstack

1

brew install localstack
LocalStackがインストールされていることを確認

PHP

$ localstack --version 2.1.0

1
2

$ localstack --version
2.1.0
LocalStack Pro版のAPIキーを環境変数に登録

PHP

export LOCALSTACK_API_KEY=xxxxxxxxxx

1

export LOCALSTACK_API_KEY=xxxxxxxxxx

LocalStackを起動

LocalStackが起動していることを確認

$ localstack status
┌─────────────────┬───────────────────────────────────────────────────────┐
│ Runtime version │ 2.1.1.dev                                             │
│ Docker image    │ tag: latest, id: 9ff2ae7ae1a0, 📆 2023-06-02T11:46:41 │
│ Runtime status  │ ✔ running (name: "localstack_main", IP: 172.17.0.2)   │
└─────────────────┴───────────────────────────────────────────────────────┘

$ docker ps
CONTAINER ID   IMAGE                       COMMAND                  CREATED         STATUS                   PORTS                                                                                                                                    NAMES
5f55c6aea975   localstack/localstack-pro   "docker-entrypoint.sh"   9 minutes ago   Up 9 minutes (healthy)   127.0.0.1:443->443/tcp, 127.0.0.1:4510-4559->4510-4559/tcp, 0.0.0.0:53->53/tcp, 0.0.0.0:53->53/udp, 127.0.0.1:4566->4566/tcp, 5678/tcp   localstack_main

$ localstack status

┌─────────────────┬───────────────────────────────────────────────────────┐

│ Runtime version │ 2.1.1.dev │

│ Docker image │ tag: latest, id: 9ff2ae7ae1a0, 📆 2023-06-02T11:46:41 │

│ Runtime status │ ✔ running (name: "localstack_main", IP: 172.17.0.2) │

└─────────────────┴───────────────────────────────────────────────────────┘

$ docker ps

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

5f55c6aea975 localstack/localstack-pro "docker-entrypoint.sh" 9 minutes ago Up 9 minutes (healthy) 127.0.0.1:443->443/tcp, 127.0.0.1:4510-4559->4510-4559/tcp, 0.0.0.0:53->53/tcp, 0.0.0.0:53->53/udp, 127.0.0.1:4566->4566/tcp, 5678/tcp localstack_main

IPアドレスは必要なのでメモを取る

terraformをインストール

参考: https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli
- 僕はHomebrew on OS Xでインストール
terraformのリポジトリを追加

PHP

brew tap hashicorp/tap

1

brew tap hashicorp/tap
terraformをインストール

PHP

brew install hashicorp/tap/terraform

1

brew install hashicorp/tap/terraform

terraformがインストールされていることを確認

EC2で使うイメージを用意する

参考: https://docs.localstack.cloud/user-guide/aws/elastic-compute-cloud/#base-images
ubuntu:focalのイメージをpullします

PHP

docker pull ubuntu:focal

1

docker pull ubuntu:focal

イメージがpullされていることを確認

LocalStack用のtagを追加

PHP

docker tag ubuntu:focal localstack-ec2/ubuntu-focal-ami:ami-000001

1

docker tag ubuntu:focal localstack-ec2/ubuntu-focal-ami:ami-000001

tagが追加されたことを確認

AWSプロフィールを設定

aws-cliで設定

AWS Access Key ID: dummy
AWS Secret Access Key: dummy
Default region name: ap-northeast-1
Default output format: json

AWSプロフィールが設定されていることを確認

サーバー構成図

RDS: LocalStackのコンテナー内にMySQLが起動する
web-server: 一つのdockerコンテナーとして作られる
- web-serverの役割は通信の出入りで、リクエストが来たらapp-serverに通す（リバースプロキシ）
app-server: 一つのdockerコンテナーとして作られる
- リクエストのIDをMySQLに格納されているデータを取得し、その結果を返却するプログラム

terraformでEC2とRDSを構築

ディレクトリ構図

上記のファイルはgit（url）に上げています

initとplanをします

PHP

$ terraform init $ terraform plan

1
2

$ terraform init
$ terraform plan
内容を確認したらapplyを実行します

PHP

$ terraform apply

1

$ terraform apply
- 途中でプロンプトが出るので、planと同じ内容出ていたらyesを打ちます
  
  PHP
  
  Do you want to perform these actions? Terraform will perform the actions described above. Only 'yes' will be accepted to approve. Enter a value: yes
  
  1
  2
  3
  4
  5
  
  Do you want to perform these actions?
  Terraform will perform the actions described above.
  Only 'yes' will be accepted to approve.
  
  Enter a value: yes

EC2とRDSが起動していることを確認

EC2確認

dockerのコンテナーを確認

$ docker ps
CONTAINER ID   IMAGE                                        COMMAND                  CREATED          STATUS                    PORTS                                                                                                                                    NAMES
f16e0697c324   localstack-ec2/ubuntu-focal-ami:ami-000001   "sleep 43200"            17 minutes ago   Up 17 minutes             0.0.0.0:32983->22/tcp, 0.0.0.0:60385->80/tcp, 0.0.0.0:35709->8080/tcp                                                                    localstack-ec2.i-85a837419413c12d9
c9e63e3ae05b   localstack-ec2/ubuntu-focal-ami:ami-000001   "sleep 43200"            17 minutes ago   Up 17 minutes             0.0.0.0:22->22/tcp, 0.0.0.0:80->80/tcp, 0.0.0.0:8080->8080/tcp                                                                           localstack-ec2.i-0265072bfb2fbdc0a
ed08d7441d54   localstack/localstack-pro                    "docker-entrypoint.sh"   20 minutes ago   Up 20 minutes (healthy)   127.0.0.1:443->443/tcp, 127.0.0.1:4510-4559->4510-4559/tcp, 0.0.0.0:53->53/tcp, 0.0.0.0:53->53/udp, 127.0.0.1:4566->4566/tcp, 5678/tcp   localstack_main

$ docker ps

CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

f16e0697c324 localstack-ec2/ubuntu-focal-ami:ami-000001 "sleep 43200" 17 minutes ago Up 17 minutes 0.0.0.0:32983->22/tcp, 0.0.0.0:60385->80/tcp, 0.0.0.0:35709->8080/tcp localstack-ec2.i-85a837419413c12d9

c9e63e3ae05b localstack-ec2/ubuntu-focal-ami:ami-000001 "sleep 43200" 17 minutes ago Up 17 minutes 0.0.0.0:22->22/tcp, 0.0.0.0:80->80/tcp, 0.0.0.0:8080->8080/tcp localstack-ec2.i-0265072bfb2fbdc0a

ed08d7441d54 localstack/localstack-pro "docker-entrypoint.sh" 20 minutes ago Up 20 minutes (healthy) 127.0.0.1:443->443/tcp, 127.0.0.1:4510-4559->4510-4559/tcp, 0.0.0.0:53->53/tcp, 0.0.0.0:53->53/udp, 127.0.0.1:4566->4566/tcp, 5678/tcp localstack_main

dockerのコンテナーIDc9e63e3ae05bとf16e0697c324は立てられたEC2で、起動していることが確認できた
- c9e63e3ae05bはweb-serverとします
- f16e0697c324はapp-serverとします

LocalStackのログを確認

インスタンスIDi-0265072bfb2fbdc0aとi-85a837419413c12d9は起動していることが確認できた
IPアドレスとポート番号は必要なのでメモを取る

RDS確認

LocalStackのコンテナーに入る
- ↑の出力からコンテナーIDはed08d7441d54
PHP

docker exec -it ed08d7441d54 bash

1

docker exec -it ed08d7441d54 bash

プロセス確認

ポート番号はLocalStackのログで確認

ポート番号は4510であることがわかりました

MySQLは起動していることが確認できた

接続情報

RDSデータ準備

MySQLにログイン

テーブルを作成

PHP

MariaDB [terraform_practice]> CREATE TABLE practice (id INT, name VARCHAR(10), update_time DATETIME); Query OK, 0 rows affected (0.022 sec)

1
2

MariaDB [terraform_practice]> CREATE TABLE practice (id INT, name VARCHAR(10), update_time DATETIME);
Query OK, 0 rows affected (0.022 sec)

データを挿入

挿入したデータを確認

web-server設定

web-serverのコンテナーに入る

PHP

docker exec -it c9e63e3ae05b bash

1

docker exec -it c9e63e3ae05b bash
インストール済みのプログラムを更新

PHP

apt-get update -y

1

apt-get update -y
必要なプログラムやツールをインストール

PHP

apt-get install vim net-tools procps curl nginx -y

1

apt-get install vim net-tools procps curl nginx -y
nginxがインストールされていることを確認

PHP

$ nginx -v nginx version: nginx/1.18.0 (Ubuntu)

1
2

$ nginx -v
nginx version: nginx/1.18.0 (Ubuntu)
nginxを起動

PHP

nginx

1

nginx

nginxにアクセスできるかを確認

ホストマシンからcurlで確認

PHP

curl http://127.0.0.1/

1

curl http://127.0.0.1/
dockerのコンテナー内からcurlで確認

PHP

curl http://172.17.0.3/

1

curl http://172.17.0.3/

出力は下記

nginxの通信をすべてapp-serverに向くよう設定

/etc/nginx/sites-available/default

nginxを再起動

PHP

nginx -s reload

1

nginx -s reload
リバースプロキシの設定反映されていることを確認
- ホストマシンからcurlで確認
  
  PHP
  
  curl http://127.0.0.1/
  
  1
  
  curl http://127.0.0.1/
- dockerのコンテナー内からcurlで確認
  
  PHP
  
  curl http://172.17.0.3/
  
  1
  
  curl http://172.17.0.3/
- 出力は下記
  
  PHP
  
  <html> <head><title>502 Bad Gateway</title></head> <body> <center><h1>502 Bad Gateway</h1></center> <hr><center>nginx/1.18.0 (Ubuntu)</center> </body> </html>
  
  1
  2
  3
  4
  5
  6
  7
  
  <html>
  <head><title>502 Bad Gateway</title></head>
  <body>
  <center><h1>502 Bad Gateway</h1></center>
  <hr><center>nginx/1.18.0 (Ubuntu)</center>
  </body>
  </html>
- ステータスコード502であれば正しく反映されている

app-server設定

app-serverのコンテナーに入る

PHP

docker exec -it f16e0697c324 bash

1

docker exec -it f16e0697c324 bash
インストール済みのプログラムを更新

PHP

apt-get update -y

1

apt-get update -y
必要なプログラムやツールをインストール

PHP

apt-get install vim net-tools procps curl git golang-go -y

1

apt-get install vim net-tools procps curl git golang-go -y
gitがインストールされていることを確認

PHP

$ git --version git version 2.25.1

1
2

$ git --version
git version 2.25.1
golangがインストールされていることを確認

PHP

$ go version go version go1.13.8 linux/arm64

1
2

$ go version
go version go1.13.8 linux/arm64
golangのMySQLのドライバーをインストール

PHP

go get -u github.com/go-sql-driver/mysql

1

go get -u github.com/go-sql-driver/mysql
スクリプトのディレクトリを作成

PHP

mkdir /root/src

1

mkdir /root/src

スクリプトを作成

/root/src/main.go

スクリプトファイルができたかを確認

PHP

$ ls -l /root/src total 4 -rw-r--r-- 1 root root 1083 Jun 9 16:31 main.go

1
2
3

$ ls -l /root/src
total 4
-rw-r--r-- 1 root root 1083 Jun 9 16:31 main.go
スクリプトをビルド

PHP

go build -o /root/src/main /root/src/main.go

1

go build -o /root/src/main /root/src/main.go
ビルドしたファイルができたかを確認

PHP

ls -l /root/src/ total 7532 -rwxr-xr-x 1 root root 7815206 Jun 9 16:34 main -rw-r--r-- 1 root root 1083 Jun 9 16:31 main.go

1
2
3
4

ls -l /root/src/
total 7532
-rwxr-xr-x 1 root root 7815206 Jun 9 16:34 main
-rw-r--r-- 1 root root 1083 Jun 9 16:31 main.go
ビルドしたファイルを実行

PHP

/root/src/main

1

/root/src/main
動作確認
- ホストマシンからcurlで確認
  
  PHP
  
  $ curl http://127.0.0.1:35709/dummy_uri\?id=1
  
  1
  
  $ curl http://127.0.0.1:35709/dummy_uri\?id=1
- dockerのコンテナー内からcurlで確認
  
  PHP
  
  curl http://172.17.0.4:8080/dummy_uri?id=1
  
  1
  
  curl http://172.17.0.4:8080/dummy_uri?id=1
- 出力は下記
  
  PHP
  
  Hello, you've requested: dummy_uri Your requested id's (id: 1) result is [id: 1; name: a; update_time: 2023-06-09 04:49:58]
  
  1
  2
  
  Hello, you've requested: dummy_uri
  Your requested id's (id: 1) result is [id: 1; name: a; update_time: 2023-06-09 04:49:58]