> ## 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.

# 環境

> アプリに注入されるプラットフォーム変数とサイブリング URL。

# 環境

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`）、そのコレクション + 環境をコンポーネントに指定します。

```typescript theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
```

生成されたアプリから Kazzle の `/ai/*` エンドポイントへの呼び出しには `KAZZLE_API_KEY` を使用してください。`VITE_*` を通じてプライベートキーを公開しないでください。これらの値はブラウザコードにバンドルされます。