Vai al contenuto principale

Ambiente

Kazzle inietta un piccolo set di variabili di piattaforma nei processi dell’app. Le tue credenziali provengono dal vault attraverso kazzle.config.ts.

Variabili di processo

VariabileDescrizioneEsempio
PORTLa porta su cui il tuo processo deve ascoltare3000
HOSTL’host a cui associarsi0.0.0.0
KAZZLE_API_URLURL di base utilizzato dai runtime helper di Kazzlehttps://api.kazzle.app
PORT, HOST e KAZZLE_API_URL sono impostati per i componenti di processo. Kazzle non crea chiavi API automaticamente per i processi dell’app; aggiungi credenziali esplicite solo quando la tua app ne ha effettivamente bisogno. Il tuo processo deve associarsi a HOST:PORT. Kazzle gestisce il routing dell’anteprima e i domini di produzione sopra questo.

URL dei componenti fratelli

Quando un’app ha più componenti, Kazzle può iniettare URL che permettono a un componente di raggiungere un altro:
VariabileDescrizione
KAZZLE_APP_COMPONENT_{NAME}_URLURL per un componente fratello a runtime
Il nome proviene dal campo name del componente: maiuscolo, i caratteri non alfanumerici diventano underscore. Un componente denominato API Server diventa KAZZLE_APP_COMPONENT_API_SERVER_URL. Questi URL puntano al componente fratello distribuito quando esiste. Altrimenti puntano all’indirizzo di sviluppo corrente per quel componente fratello.

Credenziali dell’app

Le credenziali dell’app raggiungono un componente attraverso una raccolta di segreti + ambiente. Archivia il segreto nel vault con il nome che desideri come chiave della variabile d’ambiente (ad esempio KAZZLE_API_KEY), quindi punta il componente a quella raccolta + ambiente:
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Usa KAZZLE_API_KEY per le chiamate agli endpoint /ai/* di Kazzle da un’app generata. Non esporre mai chiavi private attraverso VITE_*; questi valori sono raggruppati nel codice del browser.