Passer au contenu principal

Environnement

Kazzle injecte un petit ensemble de variables de plateforme dans les processus d’app. Vos propres identifiants proviennent du vault via kazzle.config.ts.

Variables de processus

VariableDescriptionExemple
PORTLe port sur lequel votre processus doit écouter3000
HOSTL’hôte auquel se lier0.0.0.0
KAZZLE_API_URLURL de base utilisée par les helpers runtime Kazzlehttps://api.kazzle.app
PORT, HOST et KAZZLE_API_URL sont définis pour les composants de processus. Kazzle ne crée pas automatiquement de clés API pour les processus d’app ; ajoutez des identifiants explicites uniquement si votre app en a réellement besoin. Votre processus doit se lier à HOST:PORT. Kazzle gère le routage de prévisualisation et les domaines de production au-dessus de cela.

URLs des composants frères

Quand une app a plusieurs composants, Kazzle peut injecter des URLs permettant à un composant d’en atteindre un autre :
VariableDescription
KAZZLE_APP_COMPONENT_{NAME}_URLURL d’un composant frère au runtime
Le nom provient du champ name du composant : en majuscules, les caractères non alphanumériques deviennent des tirets bas. Un composant nommé API Server devient KAZZLE_APP_COMPONENT_API_SERVER_URL. Ces URLs pointent vers le composant frère déployé s’il existe. Sinon, elles pointent vers l’adresse de développement actuelle de ce composant frère.

Identifiants d’app

Les identifiants d’app atteignent un composant via une collection de secrets + environnement. Stockez le secret dans le vault avec le nom que vous voulez comme clé de variable d’environnement (par exemple KAZZLE_API_KEY), puis pointez le composant vers cette collection + environnement :
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Utilisez KAZZLE_API_KEY pour les appels aux endpoints /ai/* de Kazzle depuis une app générée. N’exposez jamais les clés privées via VITE_* ; ces valeurs sont intégrées au code du navigateur.