メインコンテンツへスキップ
見出し画像

CloudFormation で作った構成を Terraform で作り直して、技術ブログの土台にする

    2026年11月10〜11日に、前回作った構成を Terraform で作り直し、自分の技術ブログを公開しました。前回は CloudFormation とスクリプトで作って消しましたが、今回は構成を置いたままにします。

    IT 派遣でヘルプデスクや POS レジの仕事をしています。AWS SAA、AWS Cloud Practitioner、LPIC-1を取得しました。社内 SE かクラウド運用への転職に向けて練習しています。

    この記事の言葉を、たとえで説明

    AWS をさわったことがない人向けに、この記事に出てくる言葉をお店にたとえて説明します。

    ■ Terraform(設計図を元に建ててくれる業者。AWS以外も扱えます)


    設定に書いた内容を元に、クラウドの構成を作る道具です。
    この記事では、TerraformでS3、CloudFront、OACを作りました。

    ■ Terraformのstate(何を建てたかのメモ)


    Terraformが、作った構成を記録しておくものです。
    この記事では、stateを別のS3バケットに保存しました。

    ■ plan(見積もり)


    実行すると何が変わるかを事前に確認する操作です。
    この記事では、planで変更内容を見てからapplyしました。

    ■ apply(建てる)


    planで確認した内容を実際に反映する操作です。
    この記事では、planを確認したあとにapplyで構成を作りました。

    ■ S3(倉庫)


    ファイルを保存しておく場所です。
    この記事では、非公開のS3にファイルを置きました。

    ■ CloudFront(お店の窓口)


    見る人にファイルを届ける窓口です。
    この記事では、CloudFrontの控えからファイルを届け、S3に負担がかかりにくい構成にしました。

    ■ OAC(窓口だけが持つ倉庫の鍵)


    CloudFrontからS3を読めるようにする仕組みです。
    この記事では、CloudFrontがOACを通してS3のファイルを読みました。

    ■ IAMユーザー(作業員の名札)


    AWSで操作するときに、誰が何をできるかを示すものです。
    この記事では、Terraform専用のユーザーにS3とCloudFrontの権限だけを付けました。

    ■ キャッシュ(窓口の控え)


    一度使ったファイルを窓口に置いておき、次の配信に使う仕組みです。
    この記事では、記事を直したあとに古い控えを無効化で捨てました。

    ■ 無効化(窓口の古い控えを捨てること)


    CloudFrontに残った古いファイルを捨て、次の配信で新しい内容を使えるようにする操作です。
    この記事では、記事を直したあとに無効化して古い控えを捨てました。

    作ったもの

    前回は、CloudFormation の template.yaml 1つで S3、OAC、CloudFront、バケットポリシー、Budgets を作りました。S3 は公開ブロックを4つ有効にし、SSE-S3 で暗号化しました。CloudFront は PriceClass_200、HTTP から HTTPS へのリダイレクト、CachingOptimized、SecurityHeadersPolicy を設定しました。deploy.ps1 で作り、delete.ps1 で削除しました。コードは aws-portfolio にあります。

    画像
    技術ブログの構成図

    今回は Terraform v1.17.0 と AWS プロバイダー v6.72.0 で、ブログを配信する構成を作りました。Terraform は、設定ファイルに書いた内容をもとにインフラを作成・変更するツールです。コードは tech-blog に置きました。公開前に、キー、アカウント ID、バケット名、メールアドレスが含まれていないことを確認しました。

    構成は bootstrap と infra の2つに分けました。bootstrap は Terraform の記録を置く S3 バケットを作り、最初に1回だけ apply します。infra はブログ本体の S3、OAC、CloudFront、CloudFront Functions、バケットポリシーを作ります。

    state の置き場を先に作る

    state は、Terraform が「AWS に何を作ったか」を覚えておくファイルです。bootstrap の state だけはパソコンに置き、ブログ本体の state は bootstrap で作った S3 バケットに置きました。

    state 用バケットには、公開ブロック4つ、SSE-S3 による暗号化、バージョン管理、古い版を90日で削除する設定を入れました。HTTP での読み書きを拒否するバケットポリシーと prevent_destroy も設定しました。prevent_destroy は、誤って destroy しても対象リソースを削除させない設定です。

    バケット名は bucket_prefix で AWS に自動で付けてもらいました。state のバケット名は backend.hcl に書き、.gitignore で GitHub に載らないようにしました。infra のバックエンドでは use_lockfile = true を指定し、S3 だけで state をロックするようにしました。

    Terraform 用の IAM ユーザー

    Terraform 用に terraform-deployers グループと terraform-blog ユーザーを作りました。グループには AmazonS3FullAccess と CloudFrontFullAccess だけを付け、AdministratorAccess は付けませんでした。

    アクセスキーは aws configure --profile terraform-blog で設定しました。前からある default プロファイルとは分け、aws sts get-caller-identity で使用するユーザーを確認しました。

    plan と apply

    bootstrap は terraform init のあと terraform plan を実行しました。Plan: 6 to add, 0 to change, 0 to destroy を確認してから terraform apply を実行し、Apply complete! Resources: 6 added になりました。

    画像
    state の置き場を作った(6 added)

    infra は terraform init -backend-config="backend.hcl" のあと terraform plan を実行し、7つ追加されることを確認しました。

    画像
    ブログ本体の plan(7 to add)

    続けて terraform apply を実行し、7つ追加しました。
    CloudFront の作成には数分かかりました。

    画像
    ブログ本体の apply(7 added)

    Hugo でページを作って置く

    ブログは Hugo v0.169.0 extended で作りました。Hugo は、記事などから静的な HTML ページを作るツールです。テーマは使わず、自分でレイアウトを書きました。外部サイトからフォントや JavaScript を読み込まない構成にし、最初の記事「このブログについて」を作りました。

    作業フォルダーは OneDrive の外に置きました。.terraform に数百 MB の部品がダウンロードされるためです。ページは hugo build --gc --minify で作り、aws s3 sync site\public "s3://(バケット)" --delete --profile terraform-blog で S3 に置きました。

    画像
    Hugo で作ったページを S3 に置いた

    Hugo は記事ごとにフォルダーと index.html を作ります。CloudFront Functions は、/posts/abc/ や /posts/abc を /posts/abc/index.html につなぐようにしました。CloudFront Functions は、CloudFront の配信時にリクエストを書き換える仕組みです。

    S3 は一覧を取得する権限を渡していないため、ないページへのアクセスには403を返します。CloudFront で403を404に変え、Hugo の 404.html を表示するようにしました。

    確かめたこと


    画像
    公開したブログのトップ

    2026年11月11日に、HTTP の URL が301で HTTPS にリダイレクトされることを確認しました。HSTS、X-Frame-Options、X-Content-Type-Options: nosniff の各ヘッダーが付くことも確認しました。

    トップページ、/posts/hello/、末尾の / がない /posts/hello、/posts/ が200になることを確認しました。ないページは404になり、「ページが見つかりません」の画面になることも確認しました。S3 のオブジェクト URL を直接開くと AccessDenied になることを確認しました。

    最初は一覧と404画面のタイトルが Posts と 404 Page not found になっていました。タイトルを直してから再度同期し、aws cloudfront create-invalidation --paths "/*" を実行しました。修正が配信に反映されたことを確認しました。

    画像
    この記事をブログで開いたところ

    つまずいたところ

    IAM ユーザーを作るとき、「コンソールへのアクセス」が有効になり、パスワードが作られました。「セキュリティ認証情報」タブで「コンソールアクセスを無効にする」に戻しました。このユーザーは Terraform がアクセスキーで使うだけです。

    Terraform を2つ同時に動かしたとき、another process has locked a portion of the file と表示されて止まりました。これは state のロックで、同時に state を書き換えないための仕組みです。1つの処理が終わってからやり直しました。

    ページを置く前は、ないページが404ではなく403になりました。404.html がまだなかったためです。ページを置いたあと、404になることを確認しました。

    CloudFormation との違い

    | 比較したこと | CloudFormation | Terraform |
    |---|---|---|
    | 作ったものの記録 | AWS がスタックとして持つ | state ファイルの置き場所、ロック、保護を自分で用意する |
    | 変更前の確認 | 変更セットの仕組みがある。今回は使っていない | plan で追加・変更・削除の数を確認する |
    | 書き方 | YAML で書き、!Sub や !GetAtt で値を参照する | HCL で書き、aws_s3_bucket.site.arn のように参照する。ポリシーには jsonencode を使う |
    | S3 の設定 | バケット1つの中に設定を書く | 公開ブロック、暗号化、バージョン管理などが別のリソースに分かれる |
    | 削除 | スタックを消すとまとめて削除される | destroy で削除する。prevent_destroy で対象を守れる |

    今回使ってみて、Terraform では変更前に plan で差分を確認できることと、state の置き場を自分で用意することが印象に残りました。前回は作って消しましたが、今回はブログの土台として置いたままにします。

    4つの目標でしたこと

    | 目標 | 今回したこと |
    |---|---|
    | ① コストパフォーマンス | サーバーを置かない静的サイトにし、CloudFront はCloudFront は Always free(ずっと無料の枠。毎月 1TB のデータ転送と 1,000 万リクエストまで)の範囲と PriceClass_200 を使いました。サイト用 S3 は、元の記事を Git に置いているためバージョン管理を付けませんでした。state の古い版は90日で削除します。作成前に公式の料金ページで計算しました。 |
    | ② 障害に強く、スケールできる | CloudFront のキャッシュから配信し、アクセスが増えても S3 に負担がかかりにくい構成にしました。state はバージョン管理で前の版に戻せるようにし、prevent_destroy も設定しました。 |
    | ③ 情報漏洩を起こさない | S3 を非公開にし、OAC で自分の配信からだけ読めるようにしました。HTTPS とセキュリティヘッダーを設定しました。IAM は S3 と CloudFront の権限だけにし、コンソールにはログインできない設定にしました。バケット名と state は GitHub に載せないようにしました。 |
    | ④ 容量が増えても対応できる | S3 は容量の上限を気にせず使える構成にしました。CloudFront のキャッシュで、アクセスが増えても S3 へのリクエストが増えにくくなるようにしました。 |

    次回やること

    次回は、使っていないのに料金がかかるリソースを毎晩調べて、メールで知らせる「消し忘れチェッカー」を Terraform で作ります。

    参考にした情報

    • Terraform ドキュメント「Backend Type: s3」

    • AWS CloudFront 開発者ガイド「Restrict access to an Amazon S3 origin」

    • Hugo ドキュメント「Introduction to templating」

     
     
    まことです。 IT 派遣で、ヘルプデスク・POS レジ・ネットワークの検証をしています。 AWS SAA・Cloud Practitioner・LPIC-1 を取得し、社内SE・クラウド運用を目指しています。 AWS で構成を作って確かめる練習を、ここに記録しています。

    あなたへのおすすめ