> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 部署

> 將應用部署到生產環境和本地設備。

# 部署

Kazzle 應用可以部署到 Kazzle 的託管服務或安裝在設備電腦上。

## 遠端部署

部署是非同步的：從應用頁面、AI 或檢出版本中執行 `kazzle deploy` 都會將伺服器端部署工作加入佇列。`kazzle deploy` 會上傳您的檢出版本；部署執行器會構建並發佈它。

對於每個元件：

1. **UI 元件**會構建成 Docker 映像，在設定時執行 `runtime.prod.build`，否則執行 `bun run build`
2. **Process 元件**從 `kazzle.config.ts` 執行其 `runtime.prod.command` 命令 - 如果缺少該命令，部署會失敗
3. 每個元件都有自己的映像和部署
4. 會指派一個生產 URL

從應用頁面或透過 AI 觸發部署：

```
Deploy my app
```

## 生產 URL

已部署的應用會獲得類似 `https://kazzle-{appId}.kazzle.app` 的 URL。具有多個 process 元件的應用每個元件都會獲得一個 URL。公開應用可供任何擁有該 URL 的人存取。私人應用需要 Kazzle 身份驗證。

## 生產環境中的執行時命令

| 階段                     | 命令                             | 時機                   |
| ---------------------- | ------------------------------ | -------------------- |
| `runtime.prod.build`   | 生產構建命令，或在省略時使用 `bun run build` | 在部署 UI 元件期間          |
| `runtime.prod.command` | `kazzle.config.ts` 中的生產啟動命令    | 在生產環境中，啟動 process 元件 |

生產命令必須是裸命令（例如 `bun server/index.ts`）- 已部署的執行時會直接注入 `PORT`、`HOST` 和機密。請參閱 [Kazzle CLI](/apps/cli) 頁面以了解開發/生產分割。

## 本地安裝

應用也可以透過 Kazzle 守護程式在設備電腦（您的本地機器）上執行。`runtime.dev.command` 命令以開發模式啟動應用。