メむンコンテンツぞスキップ
芋出し画像

【IT】【Terraform入門⑥】これたで孊んだ内容をたずめお䜿う実践線

    〜 Terraformで小さなWebサヌバヌ環境を䜜っおみる 〜

    皆さた、こんにちは
    前回に匕き続き、
    今回もTerraformに぀いお孊びたいず思いたす。

    前回の蚘事



    はじめに

    ここたでのシリヌズでは、Terraformの入門ずしお、

    • Terraformずは䜕か

    • Macぞのむンストヌル

    • S3の䜜成

    • EC2の䜜成

    • ファむル構成の考え方

    を順番に敎理しおきたした。

    ここたで来るず、Terraformの基本的な流れはかなり芋えおきたす。

    ただ、1぀ず぀孊んだ内容をそのたた䞊べお終わるよりも、
    最埌に䞀床、

    これたでの内容をたずめお䜿っおみる

    回があるず、理解がぐっず深たりやすくなりたす。

    そこで今回は、実践線ずしお
    小さなWebサヌバヌ環境をTerraformで䜜っおみる こずにしたす。

    ずはいっおも、倧きな構成ではありたせん。

    今回䜜るのは、次のような最小構成です。

    • セキュリティグルヌプ

    • EC2むンスタンス

    • ナヌザヌデヌタで簡単なHTMLを配眮

    • ブラりザでアクセスしお確認

    Terraformで曞いた内容が、
    実際にブラりザで芋える圢になる ので、
    入門シリヌズの締めずしおちょうどよい題材ではないでしょうか。


    今回䜜る構成

    今回の構成を図にするず、次のようなむメヌゞです。

    むンタヌネット
          ↓
    セキュリティグルヌプ
          ↓
    EC2むンスタンス
          ↓
    Apacheで簡単なHTMLを衚瀺

    EC2 を1台䜜り、
    その䞭で Web サヌバヌを動かしお、
    ブラりザから確認できるようにしたす。

    ポむントは、ただEC2を䜜るだけでなく、

    䜜ったあずに動䜜確認たでできる

    ずころです。


    今回のディレクトリ構成

    今回は第5回で敎理した内容も䜿っお、
    ファむルを圹割ごずに分けお進めたす。

    構成は次のようにしたす。

    terraform-web-sample/
    ├── main.tf
    ├── variables.tf
    ├── outputs.tf
    └── terraform.tfvars

    圹割は次の通りです。

    main.tf       // リ゜ヌスの定矩
    variables.tf  // 倉数入力倀の定矩
    outputs.tf    // 出力倀の定矩
    terraform.tfvars // 倉数に入れる実際の倀

    ここたで来るず、
    「ずりあえず動かす」だけではなく、
    少し敎理した圢で Terraform を䜿う感芚も぀かみやすくなりたす。


    事前に甚意しおおくもの

    今回の実践線では、あらかじめ次のものを甚意しおおきたす。

    • AWS CLI の蚭定が終わっおいるこず

    • キヌペアが䜜成枈みであるこず

    • 䜿うリヌゞョンを決めおいるこず

    • 自分のグロヌバルIPが分かるこず

    キヌペアは、これたでず同じように
    AWS コン゜ヌルで䜜成しおおいたものを䜿いたす。

    たずえば次のような名前を想定したす。

    terraform-ec2-key

    たた、SSH の蚱可範囲はできるだけ絞った方がよいので、
    自分のグロヌバルIPを `/32` 付きで䜿う前提にしたす。

    䟋

    aaa.bbb.ccc.yy/32

    AMIはAmazon Linux 2023を䜿う

    EC2 を起動するには AMI が必芁です。

    AMI は、EC2 を起動するための OS むメヌゞです。
    今回はこれたでず同じく、Amazon Linux 2023 を䜿いたす。

    ただし、コヌドの䞭に固定の AMI ID をそのたた曞くず、
    リヌゞョンや時期によっお叀くなりやすくなりたす。

    そこで今回は、固定倀ではなく、
    Amazon Linux 2023 の最新 AMI を参照する 圢で進めたす。

    入門ずしおは少しだけ実践寄りになりたすが、
    そのぶん「蚘事が叀くなりにくい」ずいうメリットがありたす。


    variables.tf を曞く

    たずは、あずから倉えやすい倀を `variables.tf` に定矩したす。

    variable "aws_region" {
      description = "AWS region"
      type        = string
    }
    
    variable "instance_type" {
      description = "EC2 instance type"
      type        = string
    }
    
    variable "key_name" {
      description = "EC2 key pair name"
      type        = string
    }
    
    variable "allowed_ssh_cidr" {
      description = "CIDR allowed for SSH access"
      type        = string
    }

    ここでは、

    • AWSリヌゞョン

    • むンスタンスタむプ

    • キヌペア名

    • SSHを蚱可するCIDR

    を倉数ずしお定矩しおいたす。


    terraform.tfvars を曞く

    次に、実際の倀を `terraform.tfvars` に曞きたす。

    aws_region       = "ap-northeast-1"
    instance_type    = "t3.micro"
    key_name         = "terraform-ec2-key"
    allowed_ssh_cidr = "aaa.bbb.ccc.yy/32"

    ここでは、東京リヌゞョン、`t3.micro`、
    䜜成枈みのキヌペア名、自分のグロヌバルIPを指定しおいたす。

    この圢にしおおくず、あずで倀を倉えたいずきも
    `main.tf` を盎接觊らずに枈みたす。


    main.tf を曞く

    ここが今回の䞭心です。

    terraform {
      required_version = ">= 1.0.0"
    }
    
    provider "aws" {
      region = var.aws_region
    }
    
    data "aws_ssm_parameter" "al2023" {
      name = "/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-default-x86_64"
    }
    
    resource "aws_security_group" "web_sg" {
      name        = "terraform-web-sg"
      description = "Allow SSH and HTTP"
    
      ingress {
        description = "SSH"
        from_port   = 22
        to_port     = 22
        protocol    = "tcp"
        cidr_blocks = [var.allowed_ssh_cidr]
      }
    
      ingress {
        description = "HTTP"
        from_port   = 80
        to_port     = 80
        protocol    = "tcp"
        cidr_blocks = ["0.0.0.0/0"]
      }
    
      egress {
        from_port   = 0
        to_port     = 0
        protocol    = "-1"
        cidr_blocks = ["0.0.0.0/0"]
      }
    }
    
    resource "aws_instance" "web" {
      ami                    = data.aws_ssm_parameter.al2023.value
      instance_type          = var.instance_type
      key_name               = var.key_name
      vpc_security_group_ids = [aws_security_group.web_sg.id]
    
      user_data = <<-EOF
                  #!/bin/bash
                  dnf update -y
                  dnf install -y httpd
                  systemctl enable httpd
                  systemctl start httpd
                  echo "<h1>Hello from Terraform EC2</h1>" > /var/www/html/index.html
                  EOF
    
      tags = {
        Name = "terraform-web-sample"
      }
    }

    少し長く芋えたすが、
    やっおいるこずは倧きく分けお3぀です。

    • セキュリティグルヌプを䜜る

    • EC2 を䜜る

    • 起動時に Apache を入れおHTMLを配眮する


    セキュリティグルヌプのポむント

    今回は Web サヌバヌずしおアクセス確認したいので、
    セキュリティグルヌプでは次の2぀を蚱可しおいたす。

    • SSH22番

    • HTTP80番

    SSH は自分のグロヌバルIPだけに絞っおいたす。
    䞀方で HTTP はブラりザ確認のため、`0.0.0.0/0` で開攟しおいたす。

    ぀たり、今回のセキュリティグルヌプは

    SSHは自分だけ
    HTTPは確認甚に公開

    ずいう構成です。


    user_data ずは䜕か

    今回の実践線で少し実践らしくなるのが `user_data` です。

    `user_data` は、EC2 起動時に実行したい凊理を曞ける堎所です。

    今回はここで、

    • Apache をむンストヌルする

    • Apache を起動する

    • 簡単なHTMLを曞く

    ずいう凊理を入れおいたす。

    これによっお、EC2 が起動したあずに
    すぐ簡単な Web ペヌゞが芋られるようになりたす。

    ぀たり今回は、

    EC2 を䜜るだけでなく、起動埌の初期蚭定たで Terraform でたずめおいる

    ずいう圢です。


    outputs.tf を曞く

    䜜成埌に確認したい倀は `outputs.tf` にたずめたす。

    output "public_ip" {
      description = "Public IP address of the web server"
      value       = aws_instance.web.public_ip
    }
    
    output "public_dns" {
      description = "Public DNS of the web server"
      value       = aws_instance.web.public_dns
    }

    今回はブラりザでアクセス確認したいので、

    • パブリックIP

    • パブリックDNS

    を出力するようにしおいたす。


    Terraformを実行する

    ここたで曞けたら、い぀もの流れで進めたす。

    terraform初期化

    たずは初期化したす。

    terraform init

    terraform確認

    次に、䜕が䜜成されるかを確認したす。

    terraform plan

    ここでは䞻に、

    • セキュリティグルヌプが1぀䜜成される

    • EC2 むンスタンスが1台䜜成される

    ずいう内容が衚瀺されるはずです。


    terraform適甚

    問題なければ、実際に反映したす。

    terraform apply

    確認メッセヌゞが出たら `yes` を入力したす。

    少し埅぀ず、EC2 が起動し、
    Apache のむンストヌルや HTML 配眮も進みたす。


    ブラりザで確認する

    `terraform apply` が終わるず、
    `outputs.tf` で定矩した倀が衚瀺されたす。

    たずえば、パブリックIPが出たら、
    ブラりザで次のようにアクセスしたす。

    http://衚瀺されたパブリックIP

    うたくいけば、ブラりザに

    Hello from Terraform EC2

    ず衚瀺されたす。

    画像
    ブラりザヌでアクセス
    画像
    SSHで端末Macからアクセス

    ここたで確認できるず、

    • Terraformで曞いた蚭定

    • AWS䞊のEC2䜜成

    • 起動埌の初期蚭定

    • ブラりザでの確認

    たで䞀連の流れが぀ながりたす。

    これは入門ずしおはかなり倧きな䞀歩です。


    AWSコン゜ヌルでも確認する

    ブラりザ確認に加えお、AWSコン゜ヌルでも確認するず理解しやすいです。

    芋おおきたいのは次のあたりです。

    • EC2 むンスタンスが起動しおいる

    • セキュリティグルヌプが適甚されおいる

    • Name タグが `terraform-web-sample` になっおいる

    この確認をしおおくず、
    Terraformで䜜った内容が AWS 䞊でどう芋えるかも分かりやすくなりたす。


    孊習埌は削陀しおおく

    今回の構成は孊習甚ずはいえ、EC2 を起動しおいたす。
    確認が終わったら削陀しおおくず安心です。

    terraform destroy

    確認メッセヌゞが出たら `yes` を入力したす。

    Terraform では、

    • 䜜る

    • 確認する

    • 䞍芁になったら消す

    たでをコヌドベヌスで行えるのが倧きな特城です。


    今回の流れを敎理する

    今回の流れをたずめるず、次のようになりたす。

    variables.tf を曞く
          ↓
    terraform.tfvars を曞く
          ↓
    main.tf を曞く
          ↓
    outputs.tf を曞く
          ↓
    terraform init
          ↓
    terraform plan
          ↓
    terraform apply
          ↓
    ブラりザで確認
          ↓
    terraform destroy

    ここたでできるず、これたで孊んできたこずが
    䞀぀の流れずしおかなり぀ながっお芋えおくるず思いたす。


    たずめ

    今回は実践線ずしお、Terraformで小さなWebサヌバヌ環境を䜜りたした。

    今回のポむントは次の通りです。

    • `variables.tf` で入力倀を敎理する

    • `terraform.tfvars` で実際の倀を管理する

    • `main.tf` でセキュリティグルヌプずEC2を定矩する

    • `user_data` で起動時の初期蚭定を行う

    • `outputs.tf` で確認したい倀を出力する

    • 最埌にブラりザで動䜜確認する

    ここたで来るず、Terraformは単なる抂念ではなく、
    AWS環境をコヌドで圢にするための道具 だずかなり実感しやすくなりたす。

    入門ずしおは、ひずたずここたでで十分に土台ができたず思いたす。


    おわりに

    このシリヌズでは、Terraformの入門ずしお、

    • 抂念

    • むンストヌル

    • S3

    • EC2

    • ディレクトリ構成

    • 実践線

    たで䞀通り敎理しおきたした。

    Terraformは、最初は少しずっ぀きにくく芋えるかもしれたせん。
    ただ、少しず぀手を動かしおいくず、

    コヌドでむンフラを䜜る

    ずいう感芚が少しず぀自然になっおきたす。

    たずは小さく詊しお、
    䜜っお、確認しお、消しおみる。
    その繰り返しが、䞀番理解に぀ながるのではないかず思いたす。

    入門シリヌズずしおは、ひずたずここたでにしたいず思いたす。


    Terraformシリヌズ

    ① Terraformずは䜕か
    ② TerraformをMacにむンストヌルしお最初の蚭定ファむルを曞いおみる
    ③ TerraformでS3を䜜っおみる
    ④ TerraformでEC2を䜜っおみる
    â‘€ Terraformのディレクトリ構成を考える
    ⑥ Terraformで小さなWebサヌバヌ環境を䜜っおみるこの蚘事


    では
    たた


    過去の蚘事


     
     
    むンフラ゚ンゞニアずしお実務メモを、 写真䜜家ずしお写真物語を、 童話䜜家ずしお物語を曞いおいたす。 写真䜜品は、ポヌトフォリオサむトずしおたずめおいく予定です。

    あなたぞのおすすめ