About
hcl-guide.com とは何か。誰のためのサイトで、何を学べて、どう作られているか。
このサイトについて
hcl-guide.com は、Terraform を これから学び始める初学者 を対象に、HCL（HashiCorp Configuration Language）の書き方・AWS の代表リソースの定義・GitHub での運用までを 一貫して学べる日本語ガイド です。
公式ドキュメント（HashiCorp / AWS / GitHub）の内容を一次情報源とし、初学者がつまずきやすい順番と「なぜそうするのか」を補いながら章立てしています。
誰のためのサイトか
- クラウドインフラをコードで管理し始めたい人
- HCL の構文を体系的に押さえたい人
- AWS のリソース定義を Terraform で書く際の 典型パターン を一望したい人
- GitHub Actions / OIDC / pre-commit など、Terraform 周りの運用を整理したい人
章立て
- GitHub × 7 章: Git 基本／リポジトリ構成／.gitignore／pre-commit／GitHub Actions × Terraform／OIDC × AWS／ブランチ保護
- HCL × 9 章: 基本構文／値（variable・local・output）／型／resource と data／式と関数／反復構築／モジュール／state とワークフロー
- AWS × 11 章: プロバイダ／VPC／EC2／S3／IAM／RDS・DynamoDB／Lambda・API GW／CloudFront・Route53・ACM／CloudWatch・SNS・SQS／ECS・ECR・ALB／データソース集
- Azure / GCP: Coming soon
このサイト自身が「教材の続編」
hcl-guide.com そのものが 当サイトで解説している技術スタックそのもので構築 されています:
- HCL で書かれた Terraform コードが、サイトのインフラ全体を定義
- AWS（S3 + CloudFront + ACM + Route 53 + OAC）で配信
- 静的ファイルそのものも
aws_s3_objectで Terraform 管理（章 04 のパターン） - 独自ドメイン + HTTPS は章 08 のコードと同じ構成
つまり、各章で読んだコードが このサイトをいま動かしているコード です。AWS 章 08 を参照してください。
使っている技術
| 領域 | 使用技術 |
|---|---|
| 言語 / IaC | Terraform 1.14+, HCL 2 |
| クラウド | AWS (S3, CloudFront, ACM, Route 53, OAC, DynamoDB) |
| フロント | Vanilla HTML / CSS / JS（フレームワーク無し、依存ゼロ） |
| シンタックスハイライト | 自前の軽量 HCL ハイライター（assets/app.js） |
| デプロイ | terraform apply でファイル一括アップロード ＋ CloudFront キャッシュ無効化 |
ライセンス
当サイトの本文・コード例・図表は クリエイティブ・コモンズ 表示 4.0 国際 (CC BY 4.0) の下で提供されます。出典を明記いただければ、複製・改変・再配布・商用利用を許諾します。
謝辞
本サイトのコンテンツは、以下の公式ドキュメントを一次情報源として参照しています。