KamuiDash KamuiDash 文件
EN JA ZH

快速開始

本指南將帶你在 KamuiDash 上部署第一個應用程式。

事前準備

  • 一個 GitHub 帳號
  • 一個放著你程式碼的 GitHub 儲存庫

步驟 1：註冊帳號 / 登入

  1. 前往 KamuiDash
  2. 點選「Login with GitHub」
  3. 授權 GitHub 存取權限
  4. 完成註冊並驗證你的電子郵件地址

步驟 2：建立專案

專案是用來歸納應用程式與資料庫的容器。

使用 GUI

  1. 在儀表板點選「New Project」
  2. 輸入專案名稱
  3. 選擇方案（Free 或 Pro）
  4. 選擇區域（Tokyo）
  5. 點選「Create」

使用 CLI

kamui projects create

依照互動式提示輸入名稱、方案與區域。

步驟 3：安裝 GitHub App

要從 GitHub 儲存庫部署，必須先安裝 GitHub App。

  1. 建立應用程式時選擇「GitHub Repository」
  2. 點選「Install GitHub App」
  3. 選擇要安裝的 Organization 或帳號
  4. 選擇要授權存取的儲存庫

步驟 4：建立應用程式

Web Server

部署使用 Node.js、Go 或 Python 的伺服器端應用程式。

使用 GUI

  1. 開啟專案後點選「New App」→「Web Server」
  2. 設定以下項目：
    • 應用程式名稱
    • 語言（Node.js / Go / Python）
    • 選擇儲存庫與分支
    • Setup 指令（例如 npm install）
    • 啟動前指令（例如 npm run migrate）
    • 應用程式啟動指令（例如 npm start）
    • 健康檢查端點（例如 /health）
  3. 點選「Create」

使用 CLI

kamui apps create

依照互動式提示操作。

Web Page

部署只由 HTML、CSS、JavaScript 組成的靜態網站。

從 GitHub 儲存庫部署

  1. 選擇「New App」→「Web Page」→「GitHub」
  2. 選擇儲存庫與分支
  3. 指定公開目錄（例如 dist、build）
  4. 點選「Create」

步驟 5：確認部署結果

建立應用程式後，建置與部署流程會自動開始。

  1. 在應用程式詳細畫面確認狀態
  2. 顯示為「running」後，開啟提供的網址
  3. 確認你的應用程式正常運作

後續的部署

只要 push 到 GitHub 儲存庫，就會自動重新部署。

git add .
git commit -m "Update feature"
git push origin main

若要手動重新部署，可在儀表板的應用程式詳細畫面點選「Redeploy」按鈕。

下一步