microservices-terraform

LinuxClub サークルの運営基盤（LC-Cloud）を Terraform で管理するリポジトリです。

アプリケーションのデプロイや LC-Cloud インフラ構築自体はこのリポジトリの対象外です。

microservices-terraform/
├── terraform/
│   ├── platform/      # 🔴 管理者のみ（IdP・メンバー・クォータ・GitHub Org）
│   ├── catalog/       # 🟡 権限者が編集、誰でも PR 可（チーム・プロジェクト・請求アカウント）
│   ├── workspaces/    # 🟢 チーム・個人の自由空間（CODEOWNERS に従う）
│   └── modules/       # 🔴 管理者が管理する共通モジュール
├── documents/terraform/  # 設計ドキュメント（下記参照）
└── .github/              # Actions ワークフロー・CODEOWNERS

変更はすべて Pull Request 経由で行い、CODEOWNERS による承認ゲートを通過してから apply します。

目的に合わせて手順書を参照してください。

1. terraform/platform/members/active/<コホート>/members_secrets.yaml.enc に email・student_id・role を追記して SOPS で暗号化
2. PR を作成 → circle-admin または tech-lead が承認 → apply
3. メンバーに招待リンクが発行される（7 日間有効）
4. メンバーが招待リンクから username・display_name・パスワードを設定
5. Bot が auto-gen-members.yaml を自動更新 → 次回 apply でアカウント確定

詳細は 03-member-management.md を参照してください。

1. terraform/catalog/teams/_template/ をコピーして terraform/catalog/teams/<チーム名>/ を作成
2. PR を作成 → circle-admin または lc-cloud-platform が承認 → apply

詳細は 05-project-lifecycle.md を参照してください。

GitHub Actions ワークフローを手元で実行するには act を使います。

# セットアップ（初回のみ）
cp local/.secrets.example local/.secrets   # 値を入力する
cp local/.act.env.example local/.act.env

# plan ワークフローを実行
act pull_request \
  -W .github/workflows/plan.yml \
  --matrix stack:terraform/catalog/teams/_template

# modules-check を実行
act pull_request -W .github/workflows/modules-check.yml

詳細は 15-local-development.md を参照してください。

操作権限はロールによって管理されています。

詳細は 10-roles-and-permissions.md を参照してください。