手で作ったものは再現できない — Terraform入門

Terraform入門。構成ファイルとクラウド内のサーバー、設計図と確認チェック。

※本記事はアフィリエイト広告(PR)を含みます。

手で作ったサーバーは、同じものをもう一度作れません。Terraformで構成をコードにして、作る・変える・消すを繰り返します。

前回: AWSとVPSは値段が10倍違う — クラウドの選び方

はじめに のカリキュラムでは 第7段階「公開する」 にあたります。

作業場所は VM の中(Ubuntu Server)です。 ブラウザは「できたものを見る」ときだけ開きます。

この記事は本物のAWSにリソースを作ります。お金が動きます。

必ず クラウド料金は止め忘れで膨らむ — 先に上限を作る を先に読んで、 予算アラートを置いてから始めてください。 この記事は最後に必ず全部消すところまでを1本に含めています。

料金と無料枠の条件は、必ず公式で確認してください。 記事に書いた選択肢が無料枠の対象である保証はありません。 単価も条件も変わります。インスタンスタイプを選ぶ画面と公式の料金ページで、そのつど自分で確かめてください。

前回、EC2を1台立てて、壊しました。ブラウザの画面をクリックして、AMIを選んで、キーペアを作って、セキュリティグループに22番を1本開けて、最後に全部消しました。

動きました。そして、いま同じものをもう一度作れません。

  • インスタンスタイプは何を選んだか
  • セキュリティグループのソースは「マイIP」だったか「どこからでも」だったか
  • ディスクは何GBにしたか。暗号化のチェックは触ったか

思い出せません。 記事に書いた部分は残っていますが、画面には書かなかった項目が何十個もあって、そこは既定値のまま通り過ぎています。

そして前回、いちばん神経を使ったのは後片づけでした。

ボリュームは残っていないか。Elastic IP は取っていないか。別のリージョンに何か作っていないか。

画面を1つずつ見て回るしかありませんでした。 なぜなら、「自分が何を作ったか」を持っている場所がどこにもないからです。頭の中にしかありません。

この記事の道具は、その2つを同時に片づけます。

作ったものをファイルに書いておく。そのファイルに書いていないものは、コマンド1つで消える。

道具の名前は Terraform です。

対象レベル: 中級 / 区分: 必要に応じて読む

目次

この記事でわかること

  • 手で作ることの問題は「面倒」ではなく、「再現できない・消し忘れる・思い出せない」の3つだということ
  • Terraform に書くのは手順ではなく「あるべき状態」で、マイグレーションやGitOpsとまったく同じ発想だということ
  • terraform destroy があることが、手作業との最大の違いだということ。消し忘れが激減する
  • plan は「何が作られ、何が消えるか」の予告で、読まずに apply するのが一番危ないこと
  • terraform.tfstate は「自分が何を作ったか」の台帳で、消すと管理できなくなること。Gitに入れてはいけない理由
  • 手で変えるとずれる(ドリフト)こと。GitOpsの回で見たのと同じ現象が、クラウド側でも起きること
  • 1台立てるだけなら手のほうが速い場面があること

この記事でやること

  1. Terraform を Ubuntu に入れる(公式のリポジトリから)
  2. AWSの認証情報を、.tf に書かない形で渡す
  3. EC2を1台 + セキュリティグループの最小構成を書く
  4. init → plan → apply で作り、AWSの画面で実物を確認する
  5. 手で設定を変えて、plan にずれが出るのを見る
  6. destroy で全部消し、消えたことを確認する

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
IaC(Infrastructure as Code)サーバーやネットワークの構成を、画面の操作ではなくファイル(コード)で持つという考え方。Terraform はその道具の1つ
TerraformHashiCorp が作っている IaC の道具。書いた状態に合わせて、クラウド側を作る・変える・消す
HCLTerraform の設定ファイルの書き方。拡張子は .tf。JSONに似ているが、コメントと変数が書ける
プロバイダ(provider)「どのクラウドを相手にするか」の部品。AWS用、Google Cloud用、と分かれている。init のときにダウンロードされる
リソース(resource)Terraform が作る対象1つ。EC2インスタンス1台、セキュリティグループ1個が、それぞれ1リソース
プラン(plan)実行前の予告。 「何を作り、何を変え、何を消すか」を一覧で出す。この時点では何も起きない
アプライ(apply)プランの内容を実際にクラウドへ反映すること
デストロイ(destroy)管理しているリソースを全部消すこと。手作業には無い操作
ステート(tfstate)「自分が何を作ったか」の台帳ファイル。 Terraform はこれを見て、次に何をすべきかを決める
ドリフト(drift)ファイルに書いた状態と、実物がずれていること。手で画面をいじると起きる
べき等(idempotent)何回実行しても、結果が同じという性質。2回 apply してもサーバーが2台にならない、ということ

① 手で作ることの、何が問題なのか

「面倒だから自動化する」ではありません。面倒なのは、実は一番小さい問題です。

問題は3つあります。前回のEC2で、3つとも起きています。

問題1 — 同じものをもう一度作れない

前回、EC2を立てるときに決めたのは5つでした(名前・AMI・インスタンスタイプ・キーペア・セキュリティグループ)。

でも、画面にあった項目は5つではありませんでした。 ストレージのサイズ、ボリュームの種類、VPC、サブネット、パブリックIPの自動割り当て、詳細モニタリング、終了保護 — 触らなかった項目は、全部「既定値」で通っています。

「既定値で通した」ことは、どこにも記録されません。 しかも既定値はAWS側の都合で変わります。 半年後に同じ手順で作っても、同じものにならない可能性があります。

「動いたときの構成」を再現できない、というのが1つ目です。

問題2 — 消し忘れる

前回いちばん長く書いたのが後片づけの節でした。理由は単純で、「自分が作ったものの一覧」がどこにも無いからです。

手で作ったとき

  作ったもの → (記録されない) → 消すときに思い出すしかない
                                  ↑ ここで漏れる

漏れたものは、料金の回で見たとおり、静かに課金され続けます。 ボリューム、スナップショット、固定IP。しかも別のリージョンに作ったものは、画面を切り替えないと見えません。

前回、あれだけ警戒したのは、記録が無いからでした。

問題3 — 何を作ったか思い出せない

1週間後に「これ、何のために作ったんだっけ」となります。消していいのか、使っているのか分かりません。

分からないものは、怖くて消せません。 そして残ります。

3つとも、根っこは同じです。「作った結果」しか残っていない。 Terraform は「作りたい状態」をファイルとして先に残します。 ファイルがあるから、再現でき、一覧でき、消せます。

手順を書くのではありません

ここで、シェルスクリプトとの違いを先に押さえます。Linuxの総まとめの回で「3回打ったコマンドはスクリプトにする」をやりました。あれは手順の自動化です。

スクリプト  : 「AをしてBをしてCをする」  ← 手順を書く
Terraform  : 「最終的にこうなっていてほしい」 ← 状態を書く

違いが出るのは2回目です。

2回目に実行すると
サーバーを作るスクリプトもう1台できる(3回流せば3台)
Terraform何も起きない(すでにその状態なので)

これがべき等です。「何回やっても同じ結果」。手順ではなく状態を書いているから、こうなります。

② これは前にもやった発想です

新しい考え方ではありません。このサイトで2回やっています。

マイグレーションと同じ

ORMとマイグレーションの回で、ALTER TABLE を手で打つのをやめました。

理由は、手で打つと「いまテーブルがどういう形か」を誰も持っていないからでした。開発用のDBと本番のDBがいつのまにか違う形になり、どちらが正しいか分からなくなる。

だから、変更をファイルとして残しました。

GitOpsと同じ

ArgoCDの回では、もっと直接的でした。

Gitに書いてある状態が正しい。クラスタがそれと違っていたら、クラスタのほうを直す。

手で kubectl scale した変更が、勝手に戻るのを見ました。

3つ並べると

何をファイルにするか手で変えると
マイグレーションテーブルの形履歴とずれて、追えなくなる
GitOps(ArgoCD)クラスタの中身勝手に戻る(自動同期時)
Terraformクラウドのリソースplan にずれとして出る

層が違うだけで、主張は同じです。 「あるべき状態を書いたものが正。実物がそれと違うなら、実物のほうを直す」。

ここまで来ると、Kubernetes の回で出た「状態を宣言する」も、同じ列に並びます。宣言的というのは、この一列のことでした。

③ 先にお金の話 — destroy があることが最大の違い

この記事は本物のAWSにサーバーを作ります。動いている間、課金されます。

料金の回で置いたルールを、そのまま持ち込みます。

  • ☐ 予算アラートを設定してある
  • ☐ 請求の通知先メールが、普段見るアドレスになっている
  • ☐ 今日中に消す、と決めてある
  • ☐ インスタンスタイプは、画面で無料枠の対象と表示されているものを確認して選ぶ

そのうえで、Terraform が手作業と決定的に違うのはここです。

bash
$ terraform destroy

このコマンド1つで、Terraform が作ったものが全部消えます。

手作業のときは、こうでした。

手作業の後片づけ
  インスタンスを終了 → ボリュームを見に行く → Elastic IP を見に行く
  → スナップショットを見に行く → リージョンを切り替えてもう一周
  → 「たぶん全部消えた」
Terraform の後片づけ
  terraform destroy
  → 「これとこれとこれを消します」と一覧が出る → yes
  → 全部消える

消し忘れが激減する、というのが Terraform の一番大きい利点です。 速さでも、かっこよさでもありません。 作った本人ではなく、台帳が覚えているからです。

ただし、条件が2つあります。

条件意味
Terraform が作ったものだけが消える手で作ったものは対象外。 混ぜると結局手作業が残る
terraform.tfstate が残っていること台帳を失うと、destroy は「消すものが無い」と言う。 実物は残ったまま

2つ目が、後で出てくる一番の落とし穴です。

④ Terraform を入れる

VMの中(Ubuntu Server)で作業します。aptの回でやったとおり、素のUbuntuのリポジトリには入っていません。 公式が配っているリポジトリを足します。

まず、いま入っていないことを確認します。

bash
$ which terraform

何も表示されなければ、入っていません。 これが正常な出発点です。

公式リポジトリを足す

bash
$ sudo apt update
$ sudo apt install -y gnupg software-properties-common curl

鍵を入れます。

bash
$ curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg

配布元を登録します。

bash
$ echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
部分意味
signed-by=...この配布元は、さっき入れた鍵で署名されたものだけ信じるという指定
$(lsb_release -cs)Ubuntuのコード名(noble など)に自動で置き換わる。手で書かない
sudo teesudo は > には効かないので、書き込みだけ tee に渡している

入れます。

bash
$ sudo apt update
$ sudo apt install -y terraform

入ったか確かめる

bash
$ terraform -version
Terraform v1.x.x
on linux_amd64

[スクリーンショット: 01_terraform_version.png] VMの中で terraform -version を実行し、バージョンが表示されている画面を撮ってください。

バージョンの数字は違って構いません。 ただし.tf ファイルの書き方はバージョンで変わることがあるので、エラーが出たら公式ドキュメントの、自分のバージョンのページを見てください。

戻し方(消したくなったら):

bash
$ sudo apt remove terraform

⑤ 認証情報の渡し方 — .tf に書かない

ここが、この記事でいちばん事故りやすいところです。

Terraform が AWS を触るには、アクセスキーが要ります。そして、プロバイダの設定にはアクセスキーを書く欄があります。

# ⚠️ 絶対にやらないでください
provider "aws" {
  access_key = "AKIA................"
  secret_key = "wJalrXUtnFEMI/K7MDENG/........"
}

書けます。動きます。そして事故ります。

理由はGitHubの回でやった話と同じです。.tf はコードなので、Gitに入れて、GitHubに上げます。 そのとき、アクセスキーも一緒に上がります。

公開リポジトリに上がったアクセスキーは、数分で拾われます。 EC2の回で、立てた瞬間からSSHの試行が来るのを見ました。あれと同じことが、GitHubでも起きています。 拾われた鍵で高額なインスタンスを大量に立てられる、というのが典型的な被害です。 詳しくはセキュリティの回で見た「秘密は置き場所で守る」の話そのままです。

では、どう渡すか

.tf の外から渡します。 方法は2つです。

方法A: 環境変数(この記事はこれを使います)

そのターミナルの中だけで有効になります。ファイルに残りません。

bash
$ export AWS_ACCESS_KEY_ID="ここにアクセスキーID"
$ export AWS_SECRET_ACCESS_KEY="ここにシークレット"
$ export AWS_DEFAULT_REGION="ap-northeast-1"

export は、そのシェルの中だけの設定です。 ターミナルを閉じれば消えます。それが利点です。

ただし、履歴には残ります。 ~/.bash_history に export AWS_SECRET_ACCESS_KEY="..." が丸ごと残ります。 行の先頭にスペースを1つ入れて打つと、履歴に残りません(Ubuntuの既定の設定の場合)。

 export AWS_SECRET_ACCESS_KEY="ここにシークレット"

終わったら履歴を確認してください。

grep -c "AWS_SECRET" ~/.bash_history

0 以外が返ったら、その行を消してください。

方法B: AWS CLI の認証情報ファイル

aws configure で ~/.aws/credentials に保存する方法です。繰り返し使うならこちらが楽です。

使うなら、権限を必ず絞ってください。

bash
$ chmod 600 ~/.aws/credentials
$ ls -l ~/.aws/credentials
-rw------- 1 ubuntu ubuntu 116 Sep  7 10:00 /home/ubuntu/.aws/credentials

パーミッションの回でやった 600 です。自分だけが読める。 秘密鍵と同じ扱いをします。

アクセスキーそのものについて

ルートユーザーのアクセスキーは作らないでください。 AWSの画面自体が警告を出します。

  • IAMユーザーを1つ作り、そのアクセスキーを使う
  • 権限は、この記事でやること(EC2の作成・削除)に必要な範囲にとどめる
  • この記事が終わったら、そのアクセスキーは無効化するか削除する

最後の1つを忘れないでください。 後片づけの節で、もう一度出します。

⑥ 最小の構成を書く

作業用のフォルダを1つ作ります。

bash
$ mkdir -p ~/tf-study
$ cd ~/tf-study

まず .gitignore を先に置く

ファイルを書く前に、これを置きます。 理由は⑧で説明しますが、順番を逆にすると、うっかり秘密をコミットします。

bash
$ cat > .gitignore <<'EOF'
  *.tfstate
  *.tfstate.*
  .terraform/
  *.tfvars
  EOF

main.tf を書く

VS Code のリモート接続で開いて書くのが楽です。 nano でも構いません。

terraform {
  required_version = ">= 1.5"

  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

provider "aws" {
  region = var.region
  # アクセスキーは書かない。環境変数から読まれる
}

# Ubuntu の最新AMIを、名前で探して使う
data "aws_ami" "ubuntu" {
  most_recent = true
  owners      = ["099720109477"] # Canonical

  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd-gp3/ubuntu-noble-24.04-amd64-server-*"]
  }
}

resource "aws_security_group" "study" {
  name        = "tf-study-sg"
  description = "SSH from my IP only"

  ingress {
    description = "SSH"
    from_port   = 22
    to_port     = 22
    protocol    = "tcp"
    cidr_blocks = [var.my_ip_cidr]
  }

  egress {
    from_port   = 0
    to_port     = 0
    protocol    = "-1"
    cidr_blocks = ["0.0.0.0/0"]
  }

  tags = {
    Name = "tf-study-sg"
  }
}

resource "aws_instance" "study" {
  ami                    = data.aws_ami.ubuntu.id
  instance_type          = var.instance_type
  key_name               = var.key_name
  vpc_security_group_ids = [aws_security_group.study.id]

  tags = {
    Name = "tf-study-ec2"
  }
}

output "public_ip" {
  value = aws_instance.study.public_ip
}

variables.tf を書く

環境で変わるものは、外に出します。

variable "region" {
  description = "作る地域"
  type        = string
  default     = "ap-northeast-1"
}

variable "instance_type" {
  description = "インスタンスの大きさ。無料枠の対象かどうかは必ず公式で確認する"
  type        = string
  default     = "t3.micro"
}

variable "key_name" {
  description = "AWS側に登録済みのキーペア名"
  type        = string
}

variable "my_ip_cidr" {
  description = "SSHを許可する自分のIP。x.x.x.x/32 の形で書く"
  type        = string
}

instance_type の既定値を、そのまま信じないでください。 無料枠の対象は、リージョンと時期で変わります。 AWSのインスタンス起動画面に「無料利用枠の対象」の印が出るので、それを見てから決めてください。 料金は公式の料金ページで確認します。

読み方 — 5つだけ覚える

書き方何をしているか
terraform { ... }Terraform 自身の設定。 どのプロバイダを、どのバージョンで使うか
provider "aws" { ... }相手のクラウドの設定。 ここでは地域だけ
resource "種類" "名前" { ... }作るもの。 「種類」はAWSが決めた名前、「名前」は自分が付ける呼び名
data "種類" "名前" { ... }作らずに、既にあるものを調べる。 ここでは最新のUbuntu AMIのIDを探している
output "名前" { ... }作ったあとに表示してほしい値。 ここではパブリックIP

そして、参照はこの形です。

aws_security_group.study.id
    ↑種類          ↑名前  ↑欲しい値

順番を書いていないことに注目してください。 「セキュリティグループを先に作れ」とはどこにも書いていません。 aws_instance が aws_security_group.study.id を参照しているので、Terraform が順番を自分で決めます。 これが「手順ではなく状態を書く」ということです。

キーペアと自分のIPを用意する

キーペアは、この記事では作りません。 前回の記事で作ったものと同じ手順で、AWSの画面から1つ作っておいてください。 名前だけ使います。

自分のIPを調べます。

bash
$ curl -s https://checkip.amazonaws.com
203.0.113.10

この記事では、この2つを apply のときに手で渡します。 ファイルに書くなら terraform.tfvars ですが、.gitignore に入れてあるとおり、Gitには上げません。

⑦ init → plan → apply

init — プロバイダを取ってくる

bash
$ cd ~/tf-study
$ terraform init
Initializing the backend...
Initializing provider plugins...
- Finding hashicorp/aws versions matching "~> 5.0"...
- Installing hashicorp/aws v5.x.x...

Terraform has been successfully initialized!

.terraform/ というフォルダができます。 ここにAWS用のプロバイダがダウンロードされます。数百MBになることがあります。

これはnpmの回の node_modules と同じ立ち位置です。 消してよく、init すれば戻ります。 だから .gitignore に入れてあります。 一方、同時にできる .terraform.lock.hcl(使ったプロバイダの版を記録するファイル)は package-lock.json と同じ立ち位置で、HashiCorp は Git に入れるよう勧めています。だから .gitignore には入れていません。

plan — 必ず読む

この記事で、いちばん大事なコマンドです。

bash
$ terraform plan -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"

203.0.113.10 は、さっき curl で出た自分のIPに置き換えてください。

Terraform will perform the following actions:

  # aws_instance.study will be created
  + resource "aws_instance" "study" {
      + ami                          = "ami-0xxxxxxxxxxxxxxxx"
      + instance_type                = "t3.micro"
      + public_ip                    = (known after apply)
      ...
    }

  # aws_security_group.study will be created
  + resource "aws_security_group" "study" {
      + name        = "tf-study-sg"
      ...
    }

Plan: 2 to add, 0 to change, 0 to destroy.

最後の1行が、この記事で一番読んでほしい行です。

Plan: 2 to add, 0 to change, 0 to destroy.
       ↑作る      ↑変える      ↑消す
記号意味
+作られる
~変更される(そのまま残る)
-消される
-/+いったん消して作り直される(中身が消えます)

destroy の数を、毎回必ず見てください。

作るつもりで打った plan に 1 to destroy が出ていたら、そこで止まってください。 -/+(作り直し)が一番危険です。 「タグを1つ変えただけ」のつもりが、サーバーが作り直されて中身が消えることがあります。 plan は「予告」です。読まずに apply するのは、予告を破り捨てて実行するのと同じです。

この時点では、AWSには何も作られていません。 何度打っても無料で、何も起きません。納得するまで読んでください。

[スクリーンショット: 02_plan出力.png] terraform plan の最後の Plan: 2 to add, 0 to change, 0 to destroy. の行が見えている画面を撮ってください。

apply — 実際に作る

bash
$ terraform apply -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"

同じプランがもう一度表示され、最後に聞かれます。

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 と打ちます。y では通りません。

aws_security_group.study: Creating...
aws_security_group.study: Creation complete after 3s [id=sg-0xxxxxxxx]
aws_instance.study: Creating...
aws_instance.study: Still creating... [10s elapsed]
aws_instance.study: Creation complete after 32s [id=i-0xxxxxxxx]

Apply complete! Resources: 2 added, 0 changed, 0 destroyed.

Outputs:

public_ip = "203.0.113.55"

セキュリティグループが先に作られていることを見てください。 順番は書いていないのに、参照関係から Terraform が決めています。

[スクリーンショット: 03_apply完了.png] Apply complete! と public_ip が表示されている画面を撮ってください。IPアドレスは隠して構いません。

実物を確認する

ブラウザでAWSのコンソールを開いて、東京リージョンのEC2インスタンス一覧を見てください。 tf-study-ec2 が動いています。

[スクリーンショット: 04_コンソールのインスタンス.png] AWSの画面に tf-study-ec2 が「実行中」で表示されている画面を撮ってください。

SSHでも入れます(キーペアの .pem がある側から打ちます)。

bash
$ ssh -i ~/.ssh/study-ec2.pem ubuntu@203.0.113.55

入れなくても、この記事の目的は達成できています。 入れなかった場合の原因は前回の記事のつまずき表にまとめてあります。

もう一度 apply してみる

べき等を確かめます。

bash
$ terraform apply -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"
No changes. Your infrastructure matches the configuration.

Apply complete! Resources: 0 added, 0 changed, 0 destroyed.

2台になりません。 「書いた状態と実物が一致しているので、やることが無い」と言っています。

スクリプトなら2台目ができていました。 ここが手順と状態の違いです。

⑧ terraform.tfstate とは何か

ls してみてください。

bash
$ ls -a ~/tf-study
.  ..  .gitignore  .terraform  .terraform.lock.hcl  main.tf  terraform.tfstate  variables.tf

terraform.tfstate が増えています。 これが台帳です。

何が入っているか

「自分が作ったリソースの、実物のID」が入っています。

main.tf              terraform.tfstate            AWS の実物
「EC2が1台ほしい」  →  「aws_instance.study は   →  i-0abc123...
                          i-0abc123... のこと」

Terraform は毎回、この3つを突き合わせています。

  1. .tf に書いてある「あるべき状態」
  2. tfstate に書いてある「自分が作ったもの」
  3. AWSに実際にある「いまの状態」

この突き合わせの結果が plan です。

消すと管理できなくなる

ここが一番の落とし穴です。

bash
$ # ⚠️ 絶対にやらないでください
$ rm terraform.tfstate

これをやると、こうなります。

状態
AWSの実物動いたまま。課金され続ける
Terraform の認識「何も作っていない」
terraform destroy「消すものはありません」と言って終わる
terraform applyもう1台作ろうとする

台帳を失うと、destroy で消せなくなります。 消し忘れが激減するという利点が、そのまま消えます。 手で画面から消すしかありません。 そして、前回と同じ後片づけに逆戻りします。

~/tf-study のフォルダごと消す、も同じです。 実物は残ります。必ず destroy してからフォルダを消してください。

バックアップは自動で1つ残ります(terraform.tfstate.backup)。ただし1世代だけです。 頼りにしないでください。

Gitに入れてはいけない

理由は2つあります。

理由1: 秘密が入るから。

tfstate には、リソースの属性がそのまま記録されます。 RDSを作れば初期パスワードが、証明書を作れば秘密鍵が、平文で入ります。

.tf にパスワードを書かなかったとしても、tfstate には残ります。 ここが誤解されやすいところです。

.tf を守るだけでは足りません。 秘密が最終的に集まるのは tfstate のほうです。

理由2: 壊れるから。

tfstate はTerraform が書き換えるファイルです。人が書くファイルではありません。 2人が同時に apply すれば、どちらかの記録が消えます。 Gitでマージできるものではありません。

だから .gitignore に入れてあります。

bash
$ git check-ignore -v terraform.tfstate
.gitignore:1:*.tfstate	terraform.tfstate

この行が出れば、Gitは追跡しません。

.gitignore は「先に置く」ものです。 一度コミットしてしまうと、.gitignore を足しても追跡は止まりません。 GitHubの回でやったとおり、履歴に残ったものは、消すのが面倒です。

では、1人でないときはどうするか

チームで使うときは、tfstate を共有の場所に置きます(S3など)。「リモートバックエンド」と呼びます。

この記事ではやりません。 1人で1台のVMから触るなら、手元に置いたままで十分です。ただし、「1人だから手元で済んでいる」ということは意識しておいてください。

⑨ 手で変えるとどうなるか(ドリフト)

GitOpsの回でやったことを、クラウドでやります。

AWSのコンソールを開いて、tf-study-ec2 のタグを手で変えてください。 Name を tf-study-ec2 から 手で変えた にします。

そして、VMに戻って plan を打ちます。

bash
$ terraform plan -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"
  # aws_instance.study will be updated in-place
  ~ resource "aws_instance" "study" {
        id   = "i-0xxxxxxxx"
      ~ tags = {
          ~ "Name" = "手で変えた" -> "tf-study-ec2"
        }
    }

Plan: 0 to add, 1 to change, 0 to destroy.

ずれが見つかりました。これがドリフトです。

矢印の向きを読んでください。

"手で変えた" -> "tf-study-ec2"
   ↑いまの実物      ↑ .tf に書いてある状態

「実物のほうを、書いてある状態に戻す」と言っています。.tf を実物に合わせるのではありません。

apply すれば戻ります。

bash
$ terraform apply -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"

ArgoCDとの違い

同じ話ですが、1つだけ違います。

ずれたとき
ArgoCD(自動同期あり)勝手に戻る(人が何もしなくても)
Terraformplan を打った人が気づく。 打たなければ、ずれたまま

Terraform は監視していません。 コマンドを打ったときだけ突き合わせます。

つまり、Terraform で管理していても、手で画面をいじれば普通にずれます。 ずれを見つけるには、定期的に plan を打つ必要があります。 監視の回で書いた「見ていないものは、壊れていても分からない」が、そのまま当てはまります。

「Terraform を入れたから、もう手で触っても大丈夫」ではありません。 手で触らない、というのは人間側の約束事です。

⑩ やりすぎない

正直に書きます。この記事の作業だけを見れば、手のほうが速いです。

手(画面)Terraform
EC2を1台立てる5分.tf を書いて、init して、plan を読んで、30分
同じものをもう1回また5分(そして少し違うものになる)apply だけ。1分。完全に同じ
消す画面を何周も見て回るdestroy で終わり
何を作ったか説明するできない.tf を見せれば済む

1回きりで、その日に消すなら、手のほうが速いことがあります。 それは事実です。

Terraform が効いてくる条件

  • 同じ構成を、何度も作り直す(開発用・検証用・本番用)
  • 消し忘れを絶対に避けたい(この記事の理由がこれです)
  • 他人に説明する必要がある(.tf が説明そのものになる)
  • 作った理由を、後から自分が読み返す

逆に、無理に使わないほうがいいところ

  • 1回だけ触って、その日に消す実験。 画面のほうが速い
  • 画面でしかできない設定が混ざるとき。 中途半端に混ぜると、destroy が全部を消してくれなくなる
  • 既にあるものを全部取り込もうとするとき。 既存リソースの取り込み(import)は、そこそこ大変です

このサイトの方針は「仕組みが分かること」でした。 Terraform を使う本当の理由は、速さではありません。 「作ったものが、ファイルとして残る」ことです。 1台だけなら手のほうが速い、というのは認めたうえで、それでもファイルに残す価値がある、という判断です。

つまずいたところ

plan を読まずに apply して、サーバーを止めかけた

タグを変えるつもりで、instance_type を触ってしまったことがありました。

plan には ~ が出ていました。instance_type の変更は、インスタンスをいったん停止して起動し直す変更です(-/+ の作り直しになるのは ami を変えたときなどです)。流していたら、サーバーが止まっていました。

Plan: の行だけでも読む、を癖にしました。 destroy の数がゼロでない apply は、必ず一度止まって確認します。

tfstate を消して、実物が残った

「やり直そう」と思って、~/tf-study を消してから作り直しました。

AWSには、前のインスタンスが動いたまま残っていました。 Terraform は「何も作っていない」と思っているので、destroy しても何も起きません。手で消しました。

このとき初めて、tfstate が何なのかが分かりました。 .tf はただの願望で、実物と結び付けているのは tfstate のほうです。

消したいときは、フォルダを消すのではなく destroy する。 これは体で覚えました。

Error: No valid credential sources found

環境変数を設定したターミナルとは、別のターミナルで apply していました。

export はそのシェルの中だけです。VS Code のリモート接続で新しいターミナルを開くと、設定は引き継がれません。

bash
$ env | grep AWS_ACCESS_KEY_ID

何も出なければ、そのターミナルには設定されていません。

AMIが見つからないと言われた

data "aws_ami" の values に書いた名前のパターンが、リージョンや世代でヒットしないことがあります。

AWSのコンソールでAMIを検索して、実際の名前を見てからパターンを直しました。 「たぶんこの名前だろう」で書かない、というのは再現性の話と同じでした。

y と打って進まなかった

yes と全部打つ必要があります。 わざとそうなっています。指が滑って y を押しても実行されないようにするためです。

.gitignore を後から足した

main.tf を書いてコミットしたあとに .gitignore を足しました。 そのとき tfstate はもうコミットされていました。

.gitignore は、追跡していないファイルにしか効きません。 Gitの回で読んでいたはずの話を、実際にやってから思い出しました。先に置く、で解決しました。

後片づけ

この記事でいちばん重要な節です。ここだけは飛ばさないでください。

⑪ destroy する

まず、何が消えるかを見ます。

bash
$ cd ~/tf-study
$ terraform plan -destroy -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"
Plan: 0 to add, 0 to change, 2 to destroy.

2 to destroy を確認します。 作ったのは2つ(インスタンスとセキュリティグループ)なので、数が合っています。

数が合わないときは止まってください。 少なければ取りこぼしがあり、多ければ消すつもりのないものが入っています。

消します。

bash
$ terraform destroy -var="key_name=study-ec2" -var="my_ip_cidr=203.0.113.10/32"
Do you really want to destroy all resources?
  Terraform will destroy all your managed infrastructure, as shown above.
  There is no undo. Only 'yes' will be accepted to confirm.

  Enter a value: yes

aws_instance.study: Destroying... [id=i-0xxxxxxxx]
aws_instance.study: Still destroying... [30s elapsed]
aws_instance.study: Destruction complete after 42s
aws_security_group.study: Destroying... [id=sg-0xxxxxxxx]
aws_security_group.study: Destruction complete after 1s

Destroy complete! Resources: 2 destroyed.

インスタンスが先に消え、その後でセキュリティグループが消えています。 作るときと逆順です。依存関係を Terraform が理解しているからです。

There is no undo と書いてあるとおり、戻せません。 この記事はそれが目的なので、迷わず消します。

[スクリーンショット: 05_destroy完了.png] Destroy complete! Resources: 2 destroyed. が表示されている画面を撮ってください。

⑫ 消えたことを確認する

destroy が成功しても、確認はします。 料金の回で書いた「消したつもりと、消えたことは違う」は、道具を使っても変わりません。

まず Terraform 側。

bash
$ terraform show
The state file is empty. No resources are represented.

「台帳が空」= Terraform が管理しているものは、もう無いという意味です。

次に AWS の画面で、自分の目で見ます。

見る場所期待する状態
EC2 → インスタンスtf-study-ec2 が terminated
EC2 → セキュリティグループtf-study-sg が無い
EC2 → ボリュームavailable のものが無い
EC2 → Elastic IP1つも無い(この記事では取っていません)
右上のリージョンを切り替えて、もう一周東京以外にも何も無い

[スクリーンショット: 06_削除後の確認.png] インスタンスが terminated になり、tf-study-sg が一覧に無い画面を撮ってください。

destroy が消すのは、Terraform が作ったものだけです。 手で作ったキーペアは残っています。 消したければ、AWSの画面から消してください。

⑬ 認証情報を片づける

これを忘れないでください。

  1. AWSのIAMで、この記事のために作ったアクセスキーを無効化するか削除する
  2. 環境変数を捨てる(ターミナルを閉じるか、下のコマンド)
bash
$ unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_DEFAULT_REGION
  1. 履歴に残っていないか確認する
bash
$ grep -c "AWS_SECRET" ~/.bash_history
0

0 以外なら、その行を消してください。

  1. ~/.aws/credentials を使ったなら、中身を確認する
bash
$ ls -l ~/.aws/credentials

使わないなら消して構いません。

⑭ 請求を翌日にもう一度見る

カレンダーに「AWSの請求を見る」を、2日後に入れてください。

請求の反映には時間がかかります。 消した日に0円でも、確認になっていません。翌日か翌々日に、当月の発生額が増えていないことを見てください。

まとめ

  • 手で作ることの問題は「面倒」ではない。 再現できない・消し忘れる・思い出せないの3つ
  • 手で作ると、触らなかった項目は既定値で通り、それはどこにも記録されない。 既定値は変わる
  • Terraform に書くのは手順ではなく「あるべき状態」。 だから2回 apply しても2台にならない(べき等)
  • 順番は書かない。 参照関係から Terraform が決める。作るときと逆順で消える
  • これはマイグレーションやGitOpsと同じ発想。 層が違うだけで、主張は「書いたものが正」の一点
  • terraform destroy があることが、手作業との最大の違い。 消し忘れが激減する。作った本人ではなく台帳が覚えているから
  • アクセスキーを .tf に書かない。 環境変数か認証情報ファイルで渡し、ファイルは 600
  • plan は必ず読む。 + 作る / ~ 変える / - 消す / -/+ 作り直し(中身が消える)
  • Plan: の行の destroy の数を毎回見る。 数が合わないときは止まる
  • terraform.tfstate は「自分が何を作ったか」の台帳。 .tf は願望で、実物と結び付けているのは tfstate
  • tfstate を消すと destroy できなくなる。 実物は動いたまま残り、課金が続く
  • tfstate は Gitに入れない。 .tf に書かなかった秘密も tfstate には入る。 そして人が編集するファイルではない
  • .gitignore は先に置く。 一度コミットすると、後から足しても追跡は止まらない
  • 手で変えればずれる(ドリフト)。 ただし Terraform は監視していない。 plan を打った人だけが気づく
  • 1台立てるだけなら、手のほうが速い場面がある。 それでも書くのは、速さではなくファイルが残るから
  • この記事で作ったものは、全部消してあります

「作る・変える・消すを繰り返す」発想は AWS 専用ではありません。シンVPSは API や CLI でサーバー操作を自動化したい人向けの VPS として案内されており、1GB(1コア・30GB)が1ヶ月契約で750円、36ヶ月契約で451円(2026-11 時点・税込)です。ただし最低利用期間が3ヶ月で無料のお試しも無いため、EC2 のように apply と destroy を同じ日に繰り返す練習には向かず、固定の1台を長く育てる用途向きと考えてください。

参考リンク


次に読む

この記事は 【第7段階】公開する の 9 / 10 本目です。

記事
← 前の記事AWSとVPSは値段が10倍違う — クラウドの選び方
→ 次の記事待っている時間に課金されない — サーバーレスとLambda

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Infrastructure as Code
  • Terraform
  • Provisioning
  • 宣言的なインフラ管理

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次