跳轉到主要內容

環境

Kazzle 會將一小組平台變數注入到應用程式流程中。您自己的認證來自透過 kazzle.config.ts 的保管庫。

流程變數

變數說明範例
PORT您的流程應監聽的連接埠3000
HOST要繫結的主機0.0.0.0
KAZZLE_API_URLKazzle 執行時協助程式使用的基礎 URLhttps://api.kazzle.app
PORTHOSTKAZZLE_API_URL 是為流程元件設定的。Kazzle 不會自動為應用程式流程建立 API 金鑰;只在應用程式實際需要時才新增明確認證。 您的流程應繫結到 HOST:PORT。Kazzle 會在此基礎上處理預覽路由和生產網域。

同層元件 URL

當應用程式有多個元件時,Kazzle 可以注入 URL,讓一個元件能夠到達另一個元件:
變數說明
KAZZLE_APP_COMPONENT_{NAME}_URL執行時同層元件的 URL
名稱來自元件的 name 欄位:大寫,非英數字元變成底線。名為 API Server 的同層元件會變成 KAZZLE_APP_COMPONENT_API_SERVER_URL 這些 URL 在存在已部署同層時指向該同層,否則指向該同層元件的目前開發位址。

應用程式認證

應用程式認證透過祕密集合 + 環境到達元件。在保管庫中儲存祕密,名稱為您想要的環境變數金鑰(例如 KAZZLE_API_KEY),然後將元件指向該集合 + 環境:
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
從產生的應用程式呼叫 Kazzle 的 /ai/* 端點時使用 KAZZLE_API_KEY。絕不要透過 VITE_* 公開私密金鑰;這些值會被組合到瀏覽器程式碼中。