Saltar para o conteúdo principal

Ambiente

Kazzle injeta um pequeno conjunto de variáveis de plataforma em processos de app. Suas próprias credenciais vêm do vault através de kazzle.config.ts.

Variáveis de processo

VariávelDescriçãoExemplo
PORTA porta que seu processo deve escutar3000
HOSTO host para vincular0.0.0.0
KAZZLE_API_URLURL base usada pelos helpers de runtime do Kazzlehttps://api.kazzle.app
PORT, HOST e KAZZLE_API_URL são definidas para componentes de processo. Kazzle não cria chaves de API automaticamente para processos de app; adicione credenciais explícitas apenas quando seu app realmente precisar delas. Seu processo deve vincular a HOST:PORT. Kazzle gerencia roteamento de preview e domínios de produção acima disso.

URLs de componentes irmãos

Quando um app tem múltiplos componentes, Kazzle pode injetar URLs que permitem um componente alcançar outro:
VariávelDescrição
KAZZLE_APP_COMPONENT_{NAME}_URLURL para um componente irmão em runtime
O nome vem do campo name do componente: em maiúsculas, caracteres não-alfanuméricos se tornam underscores. Um componente nomeado API Server se torna KAZZLE_APP_COMPONENT_API_SERVER_URL. Essas URLs apontam para o componente irmão implantado quando um existe. Caso contrário, apontam para o endereço de desenvolvimento atual daquele componente irmão.

Credenciais de app

Credenciais de app alcançam um componente através de uma coleção de segredos + ambiente. Armazene o segredo no vault com o nome que você quer como chave de variável de ambiente (por exemplo KAZZLE_API_KEY), depois aponte o componente para aquela coleção + ambiente:
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
Use KAZZLE_API_KEY para chamadas aos endpoints /ai/* do Kazzle a partir de um app gerado. Nunca exponha chaves privadas através de VITE_*; esses valores são agrupados em código de navegador.