Versão: v0.2.2

Variáveis de ambiente

As quatro primeiras variáveis são obrigatórias para colibri.InitializeApp(). As demais ativam ou configuram módulos específicos.

Aplicação

Variável	Obrigatória	Padrão	Valores ou formato
`ENVIRONMENT`	Sim	—	`development`, `test`, `sandbox`, `production`
`APP_NAME`	Sim	—	Texto não vazio
`APP_TYPE`	Sim	—	`service`, `serverless`, `cli`
`CLOUD`	Sim	—	`none`, `aws`, `gcp`, `firebase`
`PORT`	Não	`8080`	Inteiro
`LOG_LEVEL`	Não	`info`	`debug`, `info`, `warn`, `warning`, `error`
`WAIT_GROUP_TIMEOUT_SECONDS`	Não	`90`	Inteiro em segundos

Variável	Obrigatória	Padrão	Uso
`OTEL_EXPORTER_OTLP_ENDPOINT`	Não	vazio	Ativa exportação OTLP HTTP; use a URL base, como `http://localhost:4318`.
`OTEL_EXPORTER_OTLP_HEADERS`	Não	vazio	Cabeçalhos `chave=valor` separados por vírgula.
`OTEL_EXPORTER_OTLP_METRICS_ENDPOINT`	Não	endpoint principal	Sobrescreve o endpoint apenas para métricas.
`OTEL_SERVICE_NAME`	Não	`APP_NAME`	Nome reportado pelo recurso OpenTelemetry.

Variável	Obrigatória ao usar cache	Padrão
`CACHE_URI`	Sim	vazio
`CACHE_PASSWORD`	Não	vazio

Variável	Uso
`CLOUD_HOST`	Endpoint customizado ou emulador.
`CLOUD_REGION`	Região AWS.
`CLOUD_SECRET`	Credencial usada pelas integrações configuradas.
`CLOUD_TOKEN`	Token usado pelas integrações configuradas.
`CLOUD_DISABLE_SSL`	Desativa SSL; padrão `true`.
`CLOUD_AWS_ROLE_ARN`	ARN de role assumida na AWS.

Use um gerenciador de segredos fora do ambiente local. Não armazene credenciais reais no .env versionado.

Variável	Padrão	Valores
`COLIBRI_MESSAGING`	`CLOUD_DEFAULT`	`CLOUD_DEFAULT`, `RABBITMQ`
`RABBITMQ_URL`	vazio	URL AMQP

Variável	Padrão
`CORS_ALLOW_ORIGINS`	`*`
`CORS_ALLOW_METHODS`	`OPTIONS, GET, POST, PUT, PATCH, DELETE`
`CORS_ALLOW_HEADERS`	`Origin, Content-Type, Authorization, X-User-Id, X-Tenant-Id`
`CORS_EXPOSE_HEADERS`	vazio
`CORS_ALLOW_CREDENTIALS`	`false`
`CORS_MAX_AGE`	`0`