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 dekazzle.config.ts.
Variáveis de processo
| Variável | Descrição | Exemplo |
|---|---|---|
PORT | A porta que seu processo deve escutar | 3000 |
HOST | O host para vincular | 0.0.0.0 |
KAZZLE_API_URL | URL base usada pelos helpers de runtime do Kazzle | https://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ável | Descrição |
|---|---|
KAZZLE_APP_COMPONENT_{NAME}_URL | URL para um componente irmão em runtime |
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 exemploKAZZLE_API_KEY), depois aponte o componente para aquela coleção + ambiente:
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.