インストール

📋 前提条件

必要なツール

• Node.js 20.0 以上 - インストールガイド
• Yarn - npm install -g yarn
• Terraform 1.0 以上 - インストールガイド
• Azure CLI - インストールガイド
• GitHub CLI (gh) - インストールガイド

node --version    # v20.0.0 以上
yarn --version    # 1.22.0 以上
terraform version # v1.0.0 以上
az version        # 2.30.0 以上
gh --version      # 2.0.0 以上

Azure サブスクリプション

以下の Azure サブスクリプションへのアクセス権限が必要です:

• 本番環境（推奨）: gx-prod-subscription (ID: e3143cb2-4707-4614-bbba-3ddeb66669c2) - ⚠️ すべてのリソースを Terraform で一元管理
• 開発環境: gx-dev-subscription (ID: 8bebe608-cec5-41c4-9ee0-4377b03cb235) - 手動構築も許可（検証・実験用）

🚀 インストール手順

1. リポジトリをクローン

git clone git@github.com:GenerativeX/infra.git
cd infra

2. 依存関係をインストール

yarn install

3. CLI ツールをビルド

yarn build

4. CLI ツールをグローバルにインストール

yarn install:global

これで infra コマンドが利用可能になります。

5. Azure にログイン

# Azureにログイン
az login

# 本番環境（推奨）に切り替え
az account set --subscription e3143cb2-4707-4614-bbba-3ddeb66669c2

# または開発環境（検証用）
# az account set --subscription 8bebe608-cec5-41c4-9ee0-4377b03cb235

# 確認
az account show --output table

6. 環境変数のセットアップ

# 1Password CLI を使用して環境変数をセットアップ
op inject -i .env.example -o .env.local

重要: GX_SHARED_PRIVATE_KEY は、.env.local ファイルから自動的に読み込まれます。この環境変数は、すべてのテンプレートで Terraform 生成時に自動的に注入される必須環境変数です。.env ファイルに明示的に記載する必要はありません。

詳細は 役割分担とワークフロー を参照。

7. インストール確認

infra --version  # CLIコマンドが正しくインストールされているか確認
infra --help     # ヘルプを表示

✅ 次のステップ

• インフラ管理のコンセプト - GenerativeX のインフラ管理方針
• プロジェクト開始ガイド - 新しいプロジェクトを開始する手順
• テナント登録 - 初回テナント環境の作成