Saltar al contenido principal

Entorno

Kazzle inyecta un conjunto pequeño de variables de plataforma en los procesos de la app. Tus propias credenciales provienen del vault a través de kazzle.config.ts.

Variables de proceso

VariableDescripciónEjemplo
PORTEl puerto en el que debe escuchar tu proceso3000
HOSTEl host al que vincularse0.0.0.0
KAZZLE_API_URLURL base utilizada por los helpers de runtime de Kazzlehttps://api.kazzle.app
PORT, HOST y KAZZLE_API_URL se establecen para componentes de proceso. Kazzle no crea claves API automáticamente para procesos de app; añade credenciales explícitas solo cuando tu app realmente las necesite. Tu proceso debe vincularse a HOST:PORT. Kazzle maneja el enrutamiento de vista previa y dominios de producción sobre eso.

URLs de componentes hermanos

Cuando una app tiene múltiples componentes, Kazzle puede inyectar URLs que permiten que un componente alcance otro:
VariableDescripción
KAZZLE_APP_COMPONENT_{NAME}_URLURL para un componente hermano en runtime
El nombre proviene del campo name del componente: en mayúsculas, los caracteres no alfanuméricos se convierten en guiones bajos. Un componente llamado API Server se convierte en KAZZLE_APP_COMPONENT_API_SERVER_URL. Estas URLs apuntan al componente hermano desplegado cuando existe uno. De lo contrario, apuntan a la dirección de desarrollo actual para ese componente hermano.

Credenciales de app

Las credenciales de app llegan a un componente a través de una colección de secretos + entorno. Almacena el secreto en el vault con el nombre que desees como clave de variable de entorno (por ejemplo KAZZLE_API_KEY), luego apunta el componente a esa colección + entorno:
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Usa KAZZLE_API_KEY para llamadas a los endpoints /ai/* de Kazzle desde una app generada. Nunca expongas claves privadas a través de VITE_*; esos valores se incluyen en el código del navegador.