TerraformでEC2 Instanceを構築してみよう

【はじめに】
現在、EC2 InstanceをGUIで数クリックですぐ構築できる素晴らしい技術がある反面、同じ設定でInstanceを起動したいとき、同じ作業を何回もやらなければならないのは地道で大変だしヒューマンエラーも起きてしまいますよね。
そこで、今回はTerraformに設定を保存して、いつでも迅速にInstanceの起動・停止を可能にできる環境の構築をしていきたいと思います。

それじゃあやってみよ〜！

＜目次＞
・Terraform扱い方
・EC2インスタンス設定方法
・ssh接続方法

【前提】
・Terraformがインストールされていること（無料）
・AWSアカウントが作成されていること（無料）

『Terraform扱い方』

早速、Terraformで設定していくためのディレクトリを作成します。
私はVSCode経由のターミナルで作成していきますが、お好きなエディタ等で編集してください。
ファイル場所は任意ですので、今回はデスクトップに保存します。（ちなみに私はMacOSです）

mkdir -p /Users/macuser/Desktop/terraform

では、作業ディレクトリに移動し、ファイルを作成しておきましょう。

cd /Users/macuser/Desktop/terraform

ここまで行ったら、VSCodeの編集画面で作業していきます。
やり方はいろいろありますが、せっかくなのでショートカットキーなんかを使いながら作成してみます。

上の画面になったら、下記を実施します。
もし、ショートカットが嫌な方は、左上のOpen Editorsの右隣にあるプラスボタンを押せばファイルが作成できます。

Command (Ctl) + n　⇨新規ファイル作成

カレントディレクトリ内にファイルが作成され、保存しようとすれば勝手にそのディレクトリが表示されるので楽です。

作成したら早速記入していきましょう。

まずは、下記のように書きます。

"provider"の部分は使いたいサービスを指定します。今回はawsを使用したいので、awsと記入。
"region"は、awsのリージョンを指定します。今回は東京の"ap-northeast-1"でInstanceを作成していきたいと思います。

"profile"だけは少し厄介です。ここではAWS CLIとの連携が必要になるので、その作業をやっていきます。

このURLに行けばAWS CLIのインストールができるので、ない人はURLにいき、自分の環境に合ったものをインストールしてください。

完了したら、AWSアカウントでAccess Keyを作成します。

AWSアカウントログイン後、右上に見える名前をクリックし、Security credentialsをクリックすると下記のような画面がありますので、Access Keyをそこで作成していきます。
作成後は、そこで出てくる、２種類のキーを使うので、頭に入れておきます。

次に、Terminalを開き、下記コマンドを実施後、それぞれ取得したAccess Key等を入力していきます。

aws configure

こんな感じです。Default region等は特にしていなければそのままでもOKです。

本来、Access Key等は絶対に他者に教えないようにしてください。

そうすると、ターミナルから.awsのディレクトリに行くと欲しい情報が隠されています。

cd .aws
cat credentials

実行後の画面を見ると、[default]と書かれていることがわかりました。これがここの"default"にかかってきます。他の名前があると上手く機能しないのでよく確認してください。

それでは、完成したので、ここでプロバイダーであるawsをダウンロードするために下記を実行します。
これをすることで、ようやく書いた設定内容をawsに反映する土台が作成できます。

terraform init

カレントディレクトリにTerraformのconfigファイルがないと上手く機能しませんので注意。
必ず作成したterraformディレクトリに移り、その中にconfigファイルがあることを確認してください。

※失敗バージョンと成功バージョンが載っています⇩⇩

ここまで来たら、Instanceを作成していきましょう。
一旦の完成系はこのようになります。細かく見ていきましょう。

それぞれ項目がありますが、単にGUIで設定していたことをここに明記しているだけなので難しく考える必要はありません。

名前	内容
app_server	terraform内での名前
ami	Linuxとか、Ubuntuとか。ここではidのようなもので指定
instance_type	無料のt2.microを設定
key_name	ssh接続ように使用する鍵の名前
vpc_security_group_ids	セキュリティグループのIDを記載
tags	管理しやすくするためのタグ

terrafom作成時の文法やフォーマットは、VSCodeで作成するとかなりアシストしてくれるので、そこまで知らなくても今回はOKです。詳しく知りたい方は公式ドキュメント参照してください。

次に、セキュリティグループを作成していきます。
完成系はこちら。こちらも同様に細かく見ていきましょう。

ここでもテーブルに内容を記載しておきます。それぞれの内容の深掘りはまたの機会として、今回はこのまま残りのsshキー作成＆Instance起動を行い、終了しましょう。

名前	内容
ssh_connection	terraform内での名前
name	セキュリティグループの名前
ingress	インバウンドの設定
from_port	ポート設定
to_port	ポート設定
protocol	プロトコル設定
cidr_blocks	アクセス許可するIPの設定

『SSH鍵の作成方法』
ここまで来たらあとは鍵を作成して、インスタンス起動してアクセスして終わりです。ラストスパートに差し掛かりましょう。

まず、自分のIPとのSSH接続をセキュリティグループで設定したので、自分のターミナルから作業を行います。

AWSのGUIを操作すればすぐ作成できますが、今回はコマンドを実行して作成してみましょう。

ssh-keygen -t ed25519 -f ~/.ssh/my-key

パスワードが聞かれるので、自分でパスワードを入力し作成します。
実行後はmy-keyとmy-key.pubが作成されます。
鍵のファイルは権限を変えて安全に保管しておきましょう。

chmod 400 ~/.ssh/my-key

次に、公開鍵をaws側に登録したいので、以下コマンドを実行します。

aws ec2 import-key-pair \
  --key-name my-key \
  --public-key-material fileb://my-key.pub

これで、ローカルで作成した公開鍵をEC2 Instanceで使用できるようになったはずです。

fileb://の後ろは、相対パスか絶対パスにしてください。
今回は鍵のあるディレクトリにいるので、ファイル名のみの記載にしてます。
例：fileb://~/.ssh/my-key.pub

あとはterraformから起動させてみて、検証してみましょう！
起動させるコマンドは下記です。

terraform apply

実行後、こんな形で聞かれるので、yesと打てば作成されます。最後に緑色の箇所が出てくればOKです。

では早速ssh接続してみましょう。接続するためのIPアドレスの調べ方⇩
instanceのあとは、terraformのconfigファイルで指定したterraform内の名前です。

terraform state show aws_instance.app_server

たくさん情報が入っていますので、パブリックIPを探すのが面倒であればgrepで指定しましょう。

terraform state show aws_instance.app_server | grep public_ip

いよいよ、SSH接続をして終了です。

ssh -i ~/.ssh/my-key ubuntu@public_ip

私は今回Ubuntuのamiを選択していたので、ubuntu@となりますが、ご自分の環境に合わせて調整してください。

パブリックIPはInstance起動するごとに変わるので、繋がらないと思ったら要確認

最終的にログインできて、緑のような形でプロンプトが表示されれば完成です！