アプリケーション

アプリケーションは、KamuiDash 上で実行されるデプロイ単位です。

アプリケーションの種類

Dynamic App

サーバーサイドで動作するアプリケーションです。

対応言語	例
Node.js	Express, Next.js, Fastify など
Go	Echo, Gin, 標準 net/http など
Python	Flask, FastAPI, Django など

Static App

静的ファイル（HTML、CSS、JavaScript）のみで構成されるサイトです。

SPA（Single Page Application）
静的サイトジェネレーター出力（Hugo, Gatsby, Astro など）
シンプルな HTML サイト

アプリケーションを作成する

Dynamic App

プロジェクト詳細画面で「新規アプリ」→「Dynamic App」をクリック
基本設定を入力：

項目	説明	例
アプリ名	アプリケーションの名前	`api-server`
言語	使用するプログラミング言語	Node.js / Go / Python

デプロイソースを選択：

GitHub リポジトリから

項目	説明	例
リポジトリ	デプロイ元のリポジトリ	`myorg/my-api`
ブランチ	デプロイするブランチ	`main`
ディレクトリ	モノレポの場合のサブディレクトリ	`apps/api`（空欄でルート）

ビルド設定 — 言語ごとの具体的な値は各ページを参照：
- Node.js
- Python
- Go

実行設定：

項目	説明	デフォルト
ヘルスチェックエンドポイント	ヘルスチェック用のパス（任意）。未設定の場合、ヘルスチェックは無効になります。	なし
レプリカ数	実行するインスタンス数	1

オプション設定：
環境変数
データベース接続
「作成」をクリック

Static App

HTML（Webページ） — 静的 HTML サイト（GitHub またはアップロード）

デプロイの流れ

git push → ビルド開始 → イメージ作成 → デプロイ → ヘルスチェック → 完了

GitHub に push すると、自動的にビルドが開始
セットアップコマンド、プリデプロイコマンドが順に実行
Docker イメージが作成され、Kubernetes にデプロイ
ヘルスチェックが成功すると、トラフィックが切り替わる

デプロイログを確認する

アプリ詳細画面を開く
「デプロイ履歴」タブをクリック
確認したいデプロイを選択
ビルドログ、デプロイログを確認

アプリケーションログを確認する

アプリ詳細画面を開く
「ログ」タブをクリック
リアルタイムまたは過去のログを確認

再デプロイする

GitHub に push せずに手動でデプロイし直す場合：

アプリ詳細画面を開く
「再デプロイ」ボタンをクリック
最新のコミットで再ビルド・デプロイが実行される

環境変数を設定する

アプリ詳細画面で「設定」タブをクリック
「環境変数」セクションで追加・編集
「保存」をクリック

注意: 環境変数を変更すると、アプリが再起動されます。

アプリケーションを編集する

アプリ詳細画面で「設定」タブをクリック
編集可能な項目：
アプリ名
スペック
レプリカ数
環境変数
データベース接続
「保存」をクリック

アプリケーションを削除する

アプリ詳細画面で「設定」タブをクリック
「アプリを削除」をクリック
確認ダイアログでアプリ名を入力
「削除」をクリック

警告: この操作は取り消せません。

CLI での操作

# アプリ一覧を表示
kamui apps list --project <project-name-or-id>

# アプリを作成（対話形式）
kamui apps create

# 特定のプロジェクトにアプリを作成
kamui apps create --project my-project

# アプリを削除
kamui apps delete <app-name-or-id>

# 確認をスキップして削除
kamui apps delete <app-name-or-id> --yes

次のステップ

データベースを接続する