應用程式

應用程式是在 KamuiDash 上執行的部署單位。

應用程式類型

Web Server

伺服器端應用程式。

Web Page

只由靜態檔案（HTML、CSS、JavaScript）組成的網站。

• SPA（單頁應用程式）
• 靜態網站產生器的輸出（Hugo、Gatsby、Astro 等）
• 簡單的 HTML 網站

建立應用程式

Web Server

1. 在專案詳細畫面點選「New App」→「Web Server」
2. 輸入基本設定：

1. 選擇部署來源：

從 GitHub 儲存庫

1. 建置設定 — 各語言的具體設定值請見對應頁面：
   • Node.js
   • Python
   • Go

1. 執行環境設定：

注意：例行的基礎架構維護可能會導致伺服器重新啟動。副本數為 1 時，重新啟動期間可能會出現短暫的服務中斷。若需要高可用性，請將副本數設為 2 以上。

1. 選填設定：
2. 環境變數

3. 資料庫連接

4. 點選「Create」

Web Page

• HTML（網頁） — 從 GitHub 部署靜態 HTML 網站

部署流程

git push → 開始建置 → 產生映像檔 → 部署 → 健康檢查 → 完成

1. push 到 GitHub 後會自動開始建置
2. 依序執行 Setup 指令與啟動前指令
3. 產生 Docker 映像檔並部署到 Kubernetes
4. 健康檢查成功後切換流量

檢視部署記錄

1. 開啟應用程式詳細畫面
2. 點選「Deploy History」分頁
3. 選擇要檢查的部署
4. 檢視建置記錄與部署記錄

檢視應用程式記錄

1. 開啟應用程式詳細畫面
2. 點選「Logs」分頁
3. 檢視即時或過往的記錄

重新部署

若不想 push 到 GitHub 而要手動重新部署：

1. 開啟應用程式詳細畫面
2. 點選「Redeploy」按鈕
3. 以最新的 commit 重新建置並部署

設定環境變數

1. 在應用程式詳細畫面點選「Settings」分頁
2. 在「Environment Variables」區塊新增或編輯
3. 點選「Save」

注意：變更環境變數會讓應用程式重新啟動。

編輯應用程式

1. 在應用程式詳細畫面點選「Settings」分頁
2. 可編輯的欄位：
3. 應用程式名稱
4. 規格
5. 副本數
6. 環境變數
7. 資料庫連接
8. 點選「Save」

刪除應用程式

1. 在應用程式詳細畫面點選「Settings」分頁
2. 點選「Delete App」
3. 在確認對話框中輸入應用程式名稱
4. 點選「Delete」

警告：此操作無法復原。

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

下一步

• 連接資料庫