環境
Kazzle はプラットフォーム変数の小さなセットをアプリプロセスに注入します。独自の認証情報はkazzle.config.ts を通じてVault から取得されます。
プロセス変数
| 変数 | 説明 | 例 |
|---|---|---|
PORT | プロセスがリッスンするポート | 3000 |
HOST | バインドするホスト | 0.0.0.0 |
KAZZLE_API_URL | Kazzle ランタイムヘルパーが使用するベース URL | https://api.kazzle.app |
PORT、HOST、KAZZLE_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)、そのコレクション + 環境をコンポーネントに指定します。
/ai/* エンドポイントへの呼び出しには KAZZLE_API_KEY を使用してください。VITE_* を通じてプライベートキーを公開しないでください。これらの値はブラウザコードにバンドルされます。