メインコンテンツへスキップ

環境

Kazzle はプラットフォーム変数の小さなセットをアプリプロセスに注入します。独自の認証情報は kazzle.config.ts を通じてVault から取得されます。

プロセス変数

変数説明
PORTプロセスがリッスンするポート3000
HOSTバインドするホスト0.0.0.0
KAZZLE_API_URLKazzle ランタイムヘルパーが使用するベース URLhttps://api.kazzle.app
PORTHOSTKAZZLE_API_URL はプロセスコンポーネント用に設定されます。Kazzle はアプリプロセス用に API キーを自動作成しません。アプリが実際に必要とする場合にのみ明示的な認証情報を追加してください。 プロセスは HOST:PORT にバインドする必要があります。Kazzle はその上でプレビュールーティングと本番ドメインを処理します。

サイブリングコンポーネント URL

アプリに複数のコンポーネントがある場合、Kazzle は 1 つのコンポーネントが別のコンポーネントに到達できるようにする URL を注入できます。
変数説明
KAZZLE_APP_COMPONENT_{NAME}_URLランタイムでのサイブリングコンポーネント用 URL
名前はコンポーネントの name フィールドから取得されます。大文字に変換され、英数字以外の文字はアンダースコアになります。API Server という名前のサイブリングは KAZZLE_APP_COMPONENT_API_SERVER_URL になります。 これらの URL は、デプロイされたサイブリングが存在する場合はそれを指します。それ以外の場合は、そのサイブリングコンポーネントの現在の開発アドレスを指します。

アプリ認証情報

アプリ認証情報はシークレットコレクション + 環境を通じてコンポーネントに到達します。環境変数キーとして使用する名前で Vault にシークレットを保存し(例: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_* を通じてプライベートキーを公開しないでください。これらの値はブラウザコードにバンドルされます。