Zum Hauptinhalt springen

Umgebung

Kazzle injiziert eine kleine Menge von Plattformvariablen in App-Prozesse. Deine eigenen Anmeldedaten kommen aus dem Vault über kazzle.config.ts.

Prozessvariablen

VariableBeschreibungBeispiel
PORTDer Port, auf dem dein Prozess lauschen soll3000
HOSTDer Host zum Binden0.0.0.0
KAZZLE_API_URLBasis-URL für Kazzle-Runtime-Helferhttps://api.kazzle.app
PORT, HOST und KAZZLE_API_URL werden für Prozesskomponenten gesetzt. Kazzle erstellt nicht automatisch API-Schlüssel für App-Prozesse; füge explizite Anmeldedaten nur hinzu, wenn deine App sie wirklich benötigt. Dein Prozess sollte sich an HOST:PORT binden. Kazzle verwaltet Preview-Routing und Produktionsdomänen darüber hinaus.

Sibling-Komponenten-URLs

Wenn eine App mehrere Komponenten hat, kann Kazzle URLs injizieren, die es einer Komponente ermöglichen, eine andere zu erreichen:
VariableBeschreibung
KAZZLE_APP_COMPONENT_{NAME}_URLURL für eine Sibling-Komponente zur Laufzeit
Der Name kommt aus dem name-Feld der Komponente: in Großbuchstaben, nicht-alphanumerische Zeichen werden zu Unterstrichen. Eine Komponente namens API Server wird zu KAZZLE_APP_COMPONENT_API_SERVER_URL. Diese URLs verweisen auf die bereitgestellte Sibling-Komponente, falls vorhanden. Andernfalls verweisen sie auf die aktuelle Entwicklungsadresse für diese Sibling-Komponente.

App-Anmeldedaten

App-Anmeldedaten erreichen eine Komponente über eine Secret-Collection + Umgebung. Speichere das Secret im Vault mit dem Namen, den du als Umgebungsvariablenschlüssel möchtest (z. B. KAZZLE_API_KEY), und verweise dann die Komponente auf diese Collection + Umgebung:
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Verwende KAZZLE_API_KEY für Aufrufe an Kazzles /ai/*-Endpunkte aus einer generierten App. Gib private Schlüssel niemals über VITE_* preis; diese Werte werden in Browser-Code gebündelt.