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

OpenTelemetry

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.
OTEL_TRACES_ENABLED	Não	true	Desliga os traces. Com true, os traces ainda exigem OTEL_EXPORTER_OTLP_ENDPOINT.
OTEL_METRICS_ENABLED	Não	true	Desliga as métricas em /metrics e na exportação OTLP.
OTEL_METRICS_PROMETHEUS_ENABLED	Não	true	Expõe as métricas em /metrics pelo registry padrão do Prometheus.

As variáveis OTEL_*_ENABLED aceitam os valores booleanos do Go, como true, false, 1 e 0. Um valor inválido impede a inicialização. As combinações entre elas estão em Observabilidade.

PostgreSQL

Variável	Obrigatória ao usar SQL	Padrão
SQL_DB_HOST	Sim	vazio
SQL_DB_PORT	Sim	vazio
SQL_DB_NAME	Sim	vazio
SQL_DB_USER	Sim	vazio
SQL_DB_PASSWORD	Sim	vazio
SQL_DB_SSL_MODE	Sim	vazio
SQL_DB_MAX_OPEN_CONNS	Não	10
SQL_DB_MAX_IDLE_CONNS	Não	3
SQL_DB_MIGRATION	Não	false
MIGRATION_SOURCE_URL	Não	./migrations

Redis

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

Cloud e storage

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	Obsoleta e sem efeito desde a v0.2.4. O esquema vem do próprio CLOUD_HOST, como http://localhost:4566.
CLOUD_AWS_ROLE_ARN	ARN de role assumida na AWS.

Em sandbox e production, as integrações AWS usam a cadeia padrão de credenciais do AWS SDK for Go v2. Em development e test, usam CLOUD_HOST, CLOUD_REGION, CLOUD_SECRET e CLOUD_TOKEN para apontar para um emulador, como o LocalStack.

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

Mensageria

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

CORS

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