GenerativeX Infra Portal
GenerativeX のインフラ構築と運用に関するドキュメントです。Azure Container Apps をベースとしたマルチテナント型のインフラストラクチャを構築・運用するためのガイドです。
はじめに
このドキュメントは、GenerativeX のインフラ構築の考え方と使い方を説明しています。
- インフラ利用者(アプリ開発チーム): アプリケーションの開発とデプロイに必要な情報
- インフラ構築者(インフラチーム): 環境の構築と運用に必要な情報
GenerativeX のインフラ構築
GenerativeX のインフラ構築の考え方とアーキテクチャについて理解するためのドキュメントです。
- コンセプトと設計思想 - GenerativeX のインフラ構築の基本思想
- アーキテクチャ - 構築されるインフラのアーキテクチャ
- 責任範囲と役割分担 - インフラチームとアプリ開発チームの責任分界点
- ネットワーク構成 - ネットワークアーキテクチャの詳細
- 環境の種類(dev / prd) - 開発環境と本番環境の違い
インフラ利用者が知るべきこと
アプリケーションの開発とデプロイに必要な情報です。
クイックスタート
- ユーザーガイド - 日常的な操作のクイックガイド
- プロジェクト開始ガイド - 新しいプロジェクトの開始方法
CI/CD の使い方
GitHub Actions を使ったデプロイと環境変数の管理方法です。
- CI/CD の使い方 - CI/CD の全体像と使い方
- infra.config.yml の基本設定 - 設定ファイルの作成方法
- イメージのビルド - Docker イメージのビルド設定
- 環境変数の管理 - 環境変数の管理方法(CI/CD または Azure Portal)
- デプロイ後の確認 - デプロイが成功したかどうかの確認方法
アプリ開発ガイド
アプリケーション開発に必要な情報です。
- 環境変数の取得 - アプリケーションでの環境変数の使い方
- MySQL 接続 - データベースへの接続方法
- Redis 接続 - Redis への接続方法
- ストレージ - Azure Storage の使い方
- データベースマイグレーション - データベースのマイグレーション方法
トラブルシューティング
- トラブルシューティング - よくある問題と解決方法
インフラ構築者向けのガイド
環境の構築と運用に必要な情報です。
環境構築
環境構築の実践ガイド
実際に環境を構築する手順です。
- テナント登録 - テナントの初期化
- 環境変数の更新 - 環境変数の設定
- Terraform の適用 - Terraform の実行
- ドメイン名の設定 - カスタムドメインの設定
- CI/CD の初期設定 - CI/CD パイプラインのセットアップ
CI/CD の初期設定
アプリケーションリポジトリへの CI/CD パイプラインの設定方法です。
- GitHub Secrets の設定 - GitHub Secrets の設定方法
- GitHub Actions ワークフローの設計 - ワークフローの設計方法
- デプロイワークフロー - デプロイワークフローの詳細
- Terraform 提供の環境変数 - Terraform が自動注入する環境変数
環境設定と運用
環境の設定と運用に関する情報です。
- 設定ファイル - config.toml の設定方法
- Terraform CI Service Principal の設定 - CI/CD 用の認証設定
- カスタムドメイン - カスタムドメインの設定
- RBAC ロール - 権限管理の設定
- マイグレーション - 環境の移行方法
- Bastion/Jumpbox アクセス - セキュアなアクセス方法
Terraform と CI/CD の統合
Terraform と CI/CD の責任分界点と統合方法です。
- Terraform と CI/CD の統合 - 責任分界点と統合方法
- テンプレート一覧 - 利用可能なテンプレート
- Frontend-Backend Template - フロントエンド/バックエンド分離構成
- Monolith Template - モノリシック構成
リファレンス
技術的な詳細情報です。
- インストール - CLI ツールのインストール方法
- infra-cli の仕組み - CLI ツールの内部実装
- CLI コマンドリファレンス - 全コマンドの詳細
- infra.config.yml 仕様 - CI/CD 設定ファイルの仕様
- Terraform 提供の環境変数 - インフラ側からアプリ側に提供される環境変数
- AI エージェント使用ガイド - AI エージェント向けの非インタラクティブモード使用ガイド
サポート
問題が発生した場合:
- トラブルシューティング を確認
- GitHub Issues で報告