Kamui Platform Kamui Platform ドキュメント
EN JA

アプリケーション

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

アプリケーションの種類

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

  1. プロジェクト詳細画面で「新規アプリ」→「Dynamic App」をクリック
  2. 基本設定を入力：
項目 説明 例
アプリ名 アプリケーションの名前 api-server
言語 使用するプログラミング言語 Node.js / Go / Python
  1. デプロイソースを選択：

GitHub リポジトリから

項目 説明 例
リポジトリ デプロイ元のリポジトリ myorg/my-api
ブランチ デプロイするブランチ main
ディレクトリ モノレポの場合のサブディレクトリ apps/api（空欄でルート）
  1. ビルド設定：
項目 説明 例
スタートコマンド アプリ起動コマンド npm start
セットアップコマンド 依存関係のインストール npm install
プリデプロイコマンド ビルドコマンド npm run build
  1. 実行設定：
項目 説明 デフォルト
ヘルスチェックエンドポイント ヘルスチェック用のパス /health
レプリカ数 実行するインスタンス数 1
  1. オプション設定：
  2. 環境変数

  3. データベース接続

  4. 「作成」をクリック

Static App（GitHub）

  1. 「新規アプリ」→「Static App」→「GitHub」をクリック
  2. 設定を入力：
項目 説明 例
アプリ名 アプリケーションの名前 my-website
リポジトリ デプロイ元のリポジトリ myorg/website
ブランチ デプロイするブランチ main
ディレクトリ 公開ディレクトリ dist、build
スペック リソースサイズ Nano / Small / Medium / Large
レプリカ数 インスタンス数 1
  1. 「作成」をクリック

Static App（アップロード）

ローカルのファイルを直接アップロードしてデプロイします。

  1. 「新規アプリ」→「Static App」→「アップロード」をクリック
  2. ディレクトリまたは ZIP ファイルを選択
  3. 「作成」をクリック

注意: ルートに index.html が必要です。

デプロイの流れ

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

デプロイログを確認する

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

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

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

再デプロイする

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

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

環境変数を設定する

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

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

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

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

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

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

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

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

次のステップ