Infrastructure as Code ツールキット

# Infrastructure as Code ツールキット — 使い方ガイド

## このプラグインできること

Infrastructure as Code ツールキットは、3つのスキルを連携させてクラウドデプロイメントライフサイクルをカバーします：Terraformでインフラをプロビジョニングし、Helmでアプリケーションをパッケージ化し、Kubernetesにデプロイします。AIアシスタントから離れずに、ゼロから実行中の本番環境を構築できます。

---

## ワークフロー例

**シナリオ：** Node.js APIをAWS EKSにデプロイする

**ステップ1 — クラウドインフラのプロビジョニング** (`wshobson-terraform-module-library`)
```
Create a Terraform module for AWS EKS cluster:
- Region: us-east-1
- Node group: 3x t3.medium
- VPC with private subnets
- Enable cluster autoscaler

Run: terraform init → terraform plan → terraform apply
```
出力：EKSクラスター、ノードグループ、ネットワークが設定されたTerraformモジュールファイル（`main.tf`、`variables.tf`、`outputs.tf`）。Planでは約12リソースの作成が表示される。Applyで約15分以内にクラスターがプロビジョニングされる。

**ステップ2 — アプリケーションのパッケージ化** (`wshobson-helm-chart-scaffolding`)
```
Create a Helm chart for my-node-api:
- Image: my-registry/node-api:v1.2.0
- Replicas: 2
- Port: 3000
- Health check: /health
- ConfigMap for environment variables
- HorizontalPodAutoscaler: 2-10 replicas at 70% CPU
```
出力：`Chart.yaml`、`values.yaml`、`templates/deployment.yaml`、`templates/service.yaml`、`templates/hpa.yaml`、`templates/configmap.yaml`を含む完全なHelmチャート。デプロイ前にリントするための`validate-chart.sh`スクリプトを含む。

**ステップ3 — Kubernetesへのデプロイ** (`wshobson-k8s-manifest-generator`)
```
Generate K8s manifests to deploy my-node-api to the EKS cluster:
- Namespace: production
- Deployment: 2 replicas, resource limits 256Mi/500m
- Service: ClusterIP on port 80
- ConfigMap: LOG_LEVEL=info, NODE_ENV=production
- Secret: DATABASE_URL from Secrets Manager
```
出力：`deployment.yaml`、`service.yaml`、`configmap.yaml`、`secret.yaml`が`kubectl apply -f`の準備完了。

---

## スコープと境界

**このツールキットに必要なもの：**
- ローカルCLIツールのインストール：`terraform` (>=1.0)、`helm` (>=3.0)、クラスターに 구성된`kubectl`
- Cloud credentialsの設定（AWS CLI、GCP authなど）— Terraform適用に必要
- 既存のKubernetesクラスター、またはステップ1でプロビジョニングしたクラスター

**このツールキットはしない：**
- 代わりに`terraform apply`や`kubectl apply`を実行しない — ファイル 生成し、コマンドはユーザーが実行
- 完全なCI/CDパイプライン（GitHub Actions、ArgoCD、FluxCD）の代用品にならない — 自動デプロイにはこれらを使用
- クラスターアップグレード、証明書ローテーション、シークレットローテーションを管理しない
- 独自プラットフォーム（Heroku、Railway、Render）では動作しない — 標準的なK8s/Terraformを対象

---

## 障害からの回復

**Terraform：Providerが設定されていない**
エラー：`No valid credential sources found`。修正：`terraform init`の前に`aws configure`（または該当する場合はクラウド用の同等ツール）を実行。`terraform plan`で確認 — リソースに触る前に認証エラーが表示される。

**Terraform：Permission denied**
エラー：apply中の`AccessDenied`。IAMロール/サービスアカウントに必要な権限がない。特定のアクションのエラーを確認（例：`eks:CreateCluster`）。不足している権限をIAMポリシーに追加し、`terraform apply`を再実行 — Terraformは残りのリソースのみを作成する。

**Helm：Chartのバリデーション失敗**
具体的なエラーを確認するには`helm lint ./my-chart`を実行。原因としてよくあるもの：`values.yaml`の必要な値の欠落、テンプレートのYAMLインデント不正。報告された行を修正し、デプロイ前に再リント。

**Helm：Releaseが既に存在する**
エラー：`cannot re-use a name that is still in use`。`helm install`の代わりに`helm upgrade my-release ./my-chart`を使用するか、`--create-namespace --replace`フラグを追加。

**kubectl：クラスターに到達不能**
エラー：`Unable to connect to the server`。修正：`kubectl config get-contexts`で正しいクラスターが選択されていることを確認。EKSの場合：`aws eks update-kubeconfig --name <cluster-name> --region <region>`で認証情報を更新。

**デプロイ後のPod CrashLoopBackOff**
アプリケーションエラーを確認するには`kubectl logs <pod-name> -n production`を実行。Manifest内のすべてのConfigMapキーとSecret参照がアプリケーションが期待するものと同じか確認。Manifestを修正して再適用。