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

## Переменные процесса

| Переменная       | Описание                                                    | Пример                   |
| ---------------- | ----------------------------------------------------------- | ------------------------ |
| `PORT`           | Порт, на котором должен слушать процесс                     | `3000`                   |
| `HOST`           | Хост для привязки                                           | `0.0.0.0`                |
| `KAZZLE_API_URL` | Базовый URL, используемый вспомогательными функциями Kazzle | `https://api.kazzle.app` |

`PORT`, `HOST` и `KAZZLE_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`), затем укажите компоненту эту коллекцию + окружение:

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

Используйте `KAZZLE_API_KEY` для вызовов к конечным точкам `/ai/*` Kazzle из сгенерированного приложения. Никогда не раскрывайте приватные ключи через `VITE_*`; эти значения встраиваются в код браузера.