Перейти к основному содержанию

Окружение

Kazzle внедряет набор переменных платформы в процессы приложения. Ваши учетные данные поступают из хранилища через kazzle.config.ts.

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

ПеременнаяОписаниеПример
PORTПорт, на котором должен слушать процесс3000
HOSTХост для привязки0.0.0.0
KAZZLE_API_URLБазовый URL, используемый вспомогательными функциями Kazzlehttps://api.kazzle.app
PORT, HOST и KAZZLE_API_URL устанавливаются для компонентов процесса. Kazzle не создает ключи API автоматически для процессов приложения; добавляйте явные учетные данные только когда они действительно нужны приложению. Процесс должен привязаться к HOST:PORT. Kazzle обрабатывает маршрутизацию предпросмотра и производственные домены поверх этого.

URL компонентов-соседей

Когда приложение имеет несколько компонентов, Kazzle может внедрять URL-адреса, позволяющие одному компоненту обращаться к другому:
ПеременнаяОписание
KAZZLE_APP_COMPONENT_{NAME}_URLURL компонента-соседа во время выполнения
Имя берется из поля 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_API_KEY для вызовов к конечным точкам /ai/* Kazzle из сгенерированного приложения. Никогда не раскрывайте приватные ключи через VITE_*; эти значения встраиваются в код браузера.