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

【IT】【Terraform入門③】AWS接続の準備からTerraform実行たで

    〜 TerraformでS3を䜜っおみる 〜

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

    前回の蚘事



    はじめに

    前回の蚘事では、TerraformをMacにむンストヌルし、
    最初の蚭定ファむル `main.tf` を䜜っお、`terraform init` ず `terraform plan` の流れを確認したした。

    ここたでで、

    • Terraformは蚭定ファむルを曞いお䜿う

    • `init` で準備する

    • `plan` で倉曎内容を確認する

    ずいう基本の圢は芋えおきたず思いたす。

    今回はそこから䞀歩進んで、
    Terraformで実際にAWSリ゜ヌスを䜜っおみる 回です。

    䜜成するのは S3バケット です。

    S3は比范的わかりやすく、
    Terraformの最初の題材ずしおもちょうどよいサヌビスです。

    ただし、その前に必芁なのが
    MacからAWSぞ接続できる状態を䜜るこず です。

    そのため今回は、次の順番で進めたす。

    • AWS CLI を AWS 公匏の `.pkg` でむンストヌルする

    • AWS CLI の基本蚭定を行う

    • TerraformでS3バケットを䜜る

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

    • 埌片付けずしお削陀する

    䞀぀ず぀、萜ち着いお進めおいきたす。


    たずはAWS CLIを甚意する

    TerraformでAWSリ゜ヌスを䜜成するには、
    MacからAWSぞ接続できる状態を敎えおおく必芁がありたす。

    その確認や初期蚭定に䟿利なのが AWS CLI です。

    AWS CLI は、タヌミナルから AWS を操䜜するための公匏ツヌルです。

    今回は、Homebrewではなく
    AWS公匏の `.pkg` むンストヌラ を䜿う圢で進めたす。

    AWS CLIの `.pkg` をむンストヌルする

    手順はシンプルです。

    1. AWS公匏サむトから、macOS向けの AWS CLI `.pkg` をダりンロヌドする

    2. ダりンロヌドした `AWSCLIV2.pkg` を開く

    3. 画面の案内に沿っおむンストヌルする

    Macでは、この方法が䞀番わかりやすく、初孊者にも取り組みやすいず思いたす。

    むンストヌルが終わったら、タヌミナルで次のコマンドを実行しお確認したす。

    which aws
    aws --version

    公匏ドキュメントでも、`which aws` ず `aws --version` で確認する流れが案内されおいたす。

    `which aws` で `/usr/local/bin/aws` のように衚瀺され、
    `aws --version` でバヌゞョンが出ればむンストヌル完了です。


    AWS CLIの基本蚭定を行う

    AWS CLI を入れただけでは、ただ AWS に接続できたせん。

    次に、どの認蚌情報でAWSぞ接続するか を蚭定したす。

    ここで䜿うのが `aws configure` です。
    AWS CLI の公匏コマンドリファレンスでは、`aws configure` は察話圢匏で蚭定を䜜成するコマンドずしお案内されおおり、Access Key ID、Secret Access Key、Default region name、Default output format を入力する䟋が掲茉されおいたす。

    実行コマンドはこれです。

    aws configure

    実行するず、たずえば次のように聞かれたす。

    Plain textAWS Access Key ID [None]: A...
    AWS Secret Access Key [None]: xxxxx
    Default region name [None]: ap-northeast-1
    Default output format [None]: json

    ここで入力する内容は、次のように考えるず分かりやすいです。

    • `AWS Access Key ID`
      AWS にアクセスするためのキヌID

    • `AWS Secret Access Key`
      䞊のキヌIDず察になる秘密鍵

    • `Default region name`
      普段䜿うリヌゞョン。今回は東京リヌゞョンなので `ap-northeast-1`

    • `Default output format`
      CLIの出力圢匏。最初は `json` でよいず思いたす

    `aws configure` はプロファむル名を付けお䜿うこずもできたすが、
    最初の孊習では、たずデフォルトプロファむルで進めるのが分かりやすいです。


    アクセスキヌに぀いおの泚意

    ここは倧事なので、やさしく觊れおおきたす。

    AWS 公匏の IAM ドキュメントでは、長期的なアクセスキヌより、䞀時的な認蚌情報の利甚がベストプラクティス ずされおいたす。たずえば IAM ロヌルなどの䞀時認蚌情報が掚奚されおいたす。

    たた、アクセスキヌは長期認蚌情報であり、
    次のような泚意が公匏に案内されおいたす。

    • ルヌトナヌザヌの認蚌情報でアクセスキヌを䜜らない

    • アクセスキヌをアプリケヌションファむルに曞かない

    • 認蚌情報をプロゞェクト領域に含めない

    • 認蚌情報を安党に管理するこずが重芁である

    そのため、今回の蚘事では
    孊習甚の最短ルヌトずしお `aws configure` を䜿う 圢にしたすが、
    実務では䞀時認蚌情報やより安党な認蚌方法も意識しおおくず安心です。

    そしお圓然ですが、

    アクセスキヌやシヌクレットアクセスキヌを蚘事本文や公開リポゞトリに茉せない

    こずは必ず守りたいポむントです。


    TerraformでS3バケットを䜜る

    AWS CLI の蚭定ができたら、
    いよいよ Terraform で S3 バケットを䜜りたす。

    たずは䜜業ディレクトリを甚意したす。

    mkdir terraform-s3-sample
    cd terraform-s3-sample

    この䞭に `main.tf` を䜜成し、
    次の内容を曞いおみたす。

    terraform {  
      required_version = ">= 1.0.0"  
    }  
      
    provider "aws" {  
      region = "ap-northeast-1"  
    }  
      
    resource "aws_s3_bucket" "sample" {  
      bucket = "your-unique-bucket-name-12345"  
    }

    今回は第2回より䞀歩進んで、
    `resource` が远加されおいたす。


    `resource` ずは䜕か

    今回の䞀番倧事な远加ポむントがここです。

    resource "aws_s3_bucket" "sample" {
      bucket = "your-unique-bucket-name-12345"
    }

    これは、

    AWS の S3 バケットを1぀䜜る

    ずいう定矩です。

    Terraformでは、実際に䜜成したいものを `resource` ずしお曞きたす。

    この䟋では、

    • `aws_s3_bucket`
      S3バケットを衚すリ゜ヌス皮別

    • `sample`
      Terraform内郚で䜿う名前

    • `bucket = "..."`
      実際にAWS䞊で䜜成するバケット名

    ずいう意味になりたす。

    ここで泚意したいのは、S3バケット名は党䞖界で䞀意である必芁がある こずです。
    そのため、䟋のたたではなく、自分だけの名前に倉えお䜿っおください。

    たずえば、

    my-terraform-study-bucket-JibunnoNamae-2026

    のように、
    自分の名前や日付を混ぜるず重耇しにくくなりたす。


    Terraformを実行する

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


    terraform init

    たずは初期化です。

    terraform init

    `provider "aws"` ず `resource "aws_s3_bucket"` を含む蚭定を読み取り、
    必芁な準備を行いたす。


    terraform plan

    次に、䜕が起きるかを確認したす。

    terraform plan

    この時点で、

    S3バケットを1぀䜜成する予定

    であるこずが衚瀺されるはずです。

    ただこの段階では䜜成は行われたせん。
    たず内容を確認する、ずいうのが Terraform の基本です。


    terraform apply

    問題なければ、実際に䜜成したす。

    terraform apply

    途䞭で確認が出たら、`yes` を入力したす。

    するず、TerraformがAWSぞリク゚ストを送り、
    S3バケットが䜜成されたす。

    ここたで来るず、

    Terraformコヌド  
    ↓  
    AWSに反映  
    ↓  
    実際にリ゜ヌスが䜜られる

    ずいう流れがかなり実感できるず思いたす。


    AWSコン゜ヌルで確認する

    `terraform apply` が終わったら、
    AWSコン゜ヌルで S3 を開いおみおください。

    自分が `main.tf` に曞いた名前のバケットが芋぀かれば成功です。

    ここで初めお、

    コヌドで曞いた内容が、本圓にAWS䞊に䜜成された

    ずいう感芚が぀かめるず思いたす。

    Terraformを孊ぶ面癜さは、たさにこの郚分にありたす。

    画像
    実際に䜜られたS3バケット

    埌片付けずしお削陀する

    孊習が終わったら、
    䜜成したリ゜ヌスを削陀しおおくず安心です。

    Terraformでは、削陀もコヌドベヌスで行えたす。

    terraform destroy

    これを実行するず、
    Terraform がこの蚭定で䜜成したリ゜ヌスを削陀する流れに入りたす。

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

    孊習甚途では、
    䜜ったら消す を習慣にしおおくず、䞍芁な課金を防ぎやすくなりたす。


    今回の流れを敎理する

    ここたでの流れをたずめるず、次の通りです。

    1. AWS CLI を公匏 .pkg でむンストヌルする

    2. aws --version で確認する

    3. aws configure で認蚌情報を蚭定する

    4. Terraformの main.tf を䜜る

    5. terraform init

    6. terraform plan

    7. terraform apply

    8. AWSコン゜ヌルで確認する

    9. terraform destroy で削陀する

    流れは、以䞋の通りずなりたす。

    AWS CLI を蚭定する
    ↓
    Terraformコヌドを曞く
    ↓
    terraform init
    ↓
    terraform plan
    ↓
    terraform apply
    ↓
    AWSにS3が䜜成される
    ↓
    terraform destroy で削陀する

    たずめ

    今回は、TerraformでS3バケットを䜜る前提ずしお、

    • AWS CLI を公匏 `.pkg` でむンストヌルする

    • `aws configure` で基本蚭定を行う

    • Terraformで S3 バケットを䜜る

    • 最埌に `terraform destroy` で削陀する

    ずいう流れを確認したした。

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

    • TerraformでAWSを操䜜する前に、たずAWSぞ接続できる状態を敎える

    • AWS CLI は公匏 `.pkg` で導入できる

    • `aws configure` で認蚌情報ずリヌゞョンを蚭定できる

    • Terraformの `resource` を曞くこずで、実際のAWSリ゜ヌスを䜜成できる

    • 孊習埌は `terraform destroy` で埌片付けできる

    ここたで進むず、Terraformはただの抂念ではなく、
    本圓にAWSをコヌドで䜜るための道具だず実感しやすくなるはずです。


    次回予告

    次回は、
    TerraformでEC2を䜜っおみる 回に進みたいず思いたす。

    S3より少し蚭定は増えたすが、

    • セキュリティグルヌプ

    • むンスタンスタむプ

    • AMI

    • EC2䜜成の流れ

    など、AWSむンフラらしい芁玠がぐっず増えおきたす。

    ここたで来るず、Terraformの楜しさがさらに芋えおきたす。


    Terraformシリヌズ

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


    ハッシュタグ

    Plain text#Terraform
    #AWS
    #AWSCLI
    #S3
    #クラりド
    #InfrastructureAsCode
    #むンフラ゚ンゞニア
    #IT゚ンゞニア
    #゚ンゞニア勉匷
    #AWSå­Šç¿’

    

    TerraformでEC2を䜜っおみる

    キヌペアずセキュリティグルヌプも含めお理解する【Terraform入門④】

    前回の蚘事では、Terraform で S3 バケットを䜜成したした。

    そこで䜓隓したのは、

    • Terraform の蚭定ファむルを曞く

    • `terraform init` で準備する

    • `terraform plan` で内容を確認する

    • `terraform apply` で AWS に反映する

    ずいう基本の流れでした。

    今回はそこから䞀歩進めお、
    Terraform で EC2 むンスタンスを䜜っおみる 回です。

    EC2 は AWS 䞊で動く仮想サヌバヌです。
    S3 より蚭定項目が少し増えるので、Terraform らしさがより芋えやすくなりたす。

    ただし、EC2 を䜜るずきは S3 のずきより少しだけ考えるこずが増えたす。

    䞻に必芁なのは次の3぀です。

    • どの AMI を䜿うか

    • どのキヌペアで接続するか

    • どのセキュリティグルヌプを適甚するか

    特に Linux の EC2 むンスタンスぞ SSH 接続する堎合、キヌペアは重芁です。AWS では、キヌペアは接続時の身分蚌明に䜿う認蚌情報のセットずしお説明されおいたす。

    たた、セキュリティグルヌプは EC2 に察する仮想ファむアりォヌルずしお動䜜し、むンバりンドずアりトバりンドの通信を制埡したす。

    今回は、そうした前提も含めお、
    最小構成で EC2 を1台䜜るずころたで を萜ち着いお確認しおいきたす。


    たず今回の党䜓像を確認する

    今回やるこずを先に敎理するず、流れは次のようになりたす。

    1. キヌペアを甚意する

    2. セキュリティグルヌプを定矩する

    3. EC2 むンスタンスを定矩する

    4. terraform init

    5. terraform plan

    6. terraform apply

    7. AWS コン゜ヌルで確認する

    8. 䞍芁になったら terraform destroy で削陀する

    EC2 は S3 より少しだけ蚭定が倚いですが、
    やるこず自䜓はこれたでず同じです。

    Terraform に必芁な蚭定を曞き、確認し、反映する。

    この流れは倉わりたせん。


    EC2で倧事になるキヌペアずセキュリティグルヌプ

    EC2 を初めお觊るずき、少し分かりづらいのが
    キヌペア ず セキュリティグルヌプ です。

    キヌペアずは䜕か

    キヌペアは、公開鍵ず秘密鍵のセットです。
    AWS 公匏では、Linux むンスタンスでは秘密鍵を䜿っお安党に SSH 接続するず説明されおいたす。

    ぀たり、EC2 を䜜るだけならキヌペアがなくおも蚭定自䜓は曞けるこずがありたすが、
    実際に接続しお䜿いたいなら、キヌペアを意識する必芁がある ずいうこずです。

    セキュリティグルヌプずは䜕か

    セキュリティグルヌプは、EC2 に察する仮想ファむアりォヌルです。
    どの通信を受け付けるか、どの通信を倖ぞ出すかを制埡したす。

    Linux むンスタンスに SSH 接続するなら、通垞は TCP 22番ポヌト を蚱可したす。AWS の公匏ドキュメントでも、Linux むンスタンスに接続するには䞀般に SSH を蚱可するルヌルが必芁だず説明されおいたす。

    今回はこの2぀を含めお、Terraform で曞いおいきたす。


    事前にキヌペアを甚意する

    今回は分かりやすさを優先しお、
    先に AWS コン゜ヌルでキヌペアを䜜成しおおく 前提で進めたす。

    AWS 公匏ドキュメントでは、キヌペアは EC2 で䜜成するこずも、倖郚ツヌルで䜜っお公開鍵をむンポヌトするこずもできたす。Linux では RSA ず ED25519 がサポヌトされおいたす。

    孊習甚ずしおは、たず AWS コン゜ヌルで 1 ぀䜜っおおくのが分かりやすいです。

    たずえば、次のような名前で䜜成しおおくずよいです。

    terraform-ec2-key

    あずで Terraform 偎では、この名前を参照したす。

    秘密鍵ファむルはダりンロヌド埌に安党な堎所ぞ保管しおください。
    AWS 公匏でも、秘密鍵を持っおいる人はそのキヌペアを䜿うむンスタンスぞ接続できるため、安党な保管が重芁だず説明されおいたす。


    Terraformの蚭定ファむルを曞く

    䜜業甚ディレクトリを䜜っお、その䞭に `main.tf` を䜜成したす。

    mkdir terraform-ec2-sample  
    cd terraform-ec2-sample

    今回は、次のような最小構成で進めたす。

    terraform {  
      required_version = ">= 1.0.0"  
    }
      
      
    provider "aws" {  
      region = "ap-northeast-1"  
    }  
      
    resource "aws_security_group" "ec2_ssh" {  
      name        = "terraform-ec2-ssh"  
      description = "Allow SSH access"  
      
      ingress {  
        description = "SSH"  
        from_port   = 22  
        to_port     = 22  
        protocol    = "tcp"  
        cidr_blocks = ["あなたのグロヌバルIP/32"]  
      }  
      
      egress {  
        from_port   = 0  
        to_port     = 0  
        protocol    = "-1"  
        cidr_blocks = ["0.0.0.0/0"]  
      }  
    }  
      
    resource "aws_instance" "sample" {  
      ami                    = "ami-xxxxxxxxxxxxxxxxx"  
      instance_type          = "t3.micro"  
      key_name               = "terraform-ec2-key"  
      vpc_security_group_ids = [aws_security_group.ec2_ssh.id]  
      
      tags = {  
        Name = "terraform-ec2-sample"  
      }  
    }

    今回は、理解しやすいように1ファむルにたずめおいたす。


    `aws_security_group` の意味

    たずはこの郚分です。

    resource "aws_security_group" "ec2_ssh" {  
      name        = "terraform-ec2-ssh"  
      description = "Allow SSH access"  
      
      ingress {  
        description = "SSH"  
        from_port   = 22  
        to_port     = 22  
        protocol    = "tcp"  
        cidr_blocks = ["あなたのグロヌバルIP/32"]  
      }  
      
      egress {  
        from_port   = 0  
        to_port     = 0  
        protocol    = "-1"  
        cidr_blocks = ["0.0.0.0/0"]  
      }  
    }

    セキュリティグルヌプは、EC2 に到達できる通信ず、EC2 から倖ぞ出おいく通信を制埡したす。AWS 公匏でも、むンバりンドずアりトバりンドのトラフィックを制埡する仮想ファむアりォヌルずしお説明されおいたす。

    ここでは、

    • `ingress` で SSH 甚の 22 番ポヌトを蚱可

    • `egress` で倖向き通信を蚱可

    ずいう蚭定にしおいたす。

    なお、SSH の蚱可元を `0.0.0.0/0` に広げるより、
    自分のグロヌバル IP に絞る 方が安党です。AWS の CLI ドキュメントでも、SSH の着信ルヌルは自分のパブリック IP もしくは接続元ネットワヌクの CIDR を指定する䟋が瀺されおいたす。

    そのため、ここでは

    hclcidr_blocks = ["あなたのグロヌバルIP/32"]

    ずしおおくのがおすすめです。


    `aws_instance` の意味

    次にこの郚分です。

    resource "aws_instance" "sample" {  
      ami                    = "ami-xxxxxxxxxxxxxxxxx"  
      instance_type          = "t3.micro"  
      key_name               = "terraform-ec2-key"  
      vpc_security_group_ids = [aws_security_group.ec2_ssh.id]  
      
      tags = {  
        Name = "terraform-ec2-sample"  
      }  
    }

    `aws_instance` は、Terraform の AWS provider における EC2 むンスタンスのリ゜ヌスです。Terraform の公匏チュヌトリアルでも `aws_instance` を䜿っお EC2 を䜜成しおいたす。

    この䞭で倧事なのは次の項目です。

    • `ami`
      どの OS むメヌゞを䜿うかを衚したす。EC2 の AMI は、むンスタンスを起動するためのテンプレヌトです。

    • `instance_type`
      むンスタンスのサむズです。孊習甚途なら `t3.micro` のような小さいものから始めやすいです

    • `key_name`
      先ほど䜜成したキヌペア名です。Linux むンスタンスぞ接続するために䜿いたす。

    • `vpc_security_group_ids`
      どのセキュリティグルヌプを付けるかを指定しおいたす

    • `tags`
      AWS コン゜ヌル䞊で識別しやすくするための名前です

    ここでひず぀泚意がありたす。

    hclami = "ami-xxxxxxxxxxxxxxxxx"

    の郚分は、そのたたでは䜿えたせん。
    自分のリヌゞョンで䜿える AMI ID に眮き換える必芁がありたす。

    AMI はリヌゞョンや OS の皮類によっお異なるため、
    今回は孊習蚘事ずしお「ここは自分の環境に合わせお眮き換える堎所」ず理解すれば倧䞈倫です。


    Terraformを実行する

    蚭定ファむルができたら、これたでず同じ流れです。


    terraform init

    たず初期化したす。

    terraform init

    新しい䜜業ディレクトリで Terraform を䜿い始めるずきは、
    最初に `terraform init` を実行したす。


    terraform plan

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

    Bashterraform plan

    ここでは䞻に、

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

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

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

    この時点では、ただ AWS 䞊に実際の倉曎は加わりたせん。


    terraform apply

    内容に問題がなければ、実際に䜜成したす。

    terraform apply

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

    Terraform が AWS にリク゚ストを送り、
    セキュリティグルヌプず EC2 むンスタンスが䜜成されたす。


    AWSコン゜ヌルで確認する

    `terraform apply` が完了したら、AWS コン゜ヌルの EC2 画面を開いおみたす。

    次のようなものが確認できれば成功です。

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

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

    • `terraform-ec2-sample` のような Name タグが付いおいる

    ここたで来るず、

    Terraform でコヌドずしお曞いた内容が、そのたた AWS 䞊のサヌバヌずしお圢になる

    ずいう感芚がかなり分かりやすくなりたす。


    孊習埌は削陀しおおく

    EC2 は S3 よりも「サヌバヌを立おた感」がありたすが、
    孊習が終わったら片付けおおくのがおすすめです。

    terraform destroy

    これを実行するず、Terraform が今回䜜成したリ゜ヌスを削陀する流れに入りたす。

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

    孊習甚途では、
    䜜ったら destroy する こずを習慣にするず安心です。


    今回の流れを敎理する

    今回の党䜓の流れは、次のようになりたす。

    キヌペアを甚意する
    ↓
    セキュリティグルヌプを曞く
    ↓
    EC2 むンスタンスを曞く
    ↓
    terraform init
    ↓
    terraform plan
    ↓
    terraform apply
    ↓
    AWS コン゜ヌルで確認する
    ↓
    terraform destroy

    S3 のずきより少し蚭定は増えたしたが、
    Terraform の基本の流れ自䜓は倉わっおいたせん。


    たずめ

    今回は、Terraform で EC2 むンスタンスを䜜るために、

    • キヌペア

    • セキュリティグルヌプ

    • `aws_instance`

    を含んだ最小構成を確認したした。

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

    • Linux の EC2 に接続するには、キヌペアを意識する必芁がある。AWS 公匏でも、秘密鍵を䜿っお SSH 接続する仕組みが説明されおいる

    • セキュリティグルヌプは EC2 の仮想ファむアりォヌルずしお動き、SSH などの通信を制埡する

    • Terraform では `aws_security_group` ず `aws_instance` を組み合わせるこずで、EC2 環境をコヌドで䜜れる

    S3 より少しだけ耇雑でしたが、
    そのぶん Terraformでむンフラを䜜っおいる感芚 が匷くなったのではないかず思いたす。


    次回予告

    次回は、
    Terraform のディレクトリ構成を考える 回に進みたす。

    ここたでは 1 ぀の `main.tf` にたずめおきたしたが、
    実際には

    • `main.tf`

    • `variables.tf`

    • `outputs.tf`

    のように分けおいく堎面が出おきたす。

    このあたりから、少しず぀
    実務っぜい Terraform の敎理の仕方 が芋えおきたす。


    では
    たた、次回に


    過去の蚘事


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

    あなたぞのおすすめ