Variáveis de ambiente

Nenhum arquivo .env é lido automaticamente. Não há dotenv, de propósito: a precedência de CFOUR_KEY sobre o arquivo de credenciais é explícita, e um carregamento automático a tornaria surpreendente.

Para usar um arquivo:

set -a; . .env; set +a

Em CI, exporte direto no ambiente do job.

Publicar

Variável	Obrigatória	Padrão	Finalidade
CFOUR_KEY	não	—	a chave de publicação. Vence o arquivo de credenciais — é a forma certa em CI, onde não há ninguém para rodar cfour login. Ausente nos dois lugares, push e status saem com código 1 e pedem login
CFOUR_ENDPOINT	não	https://api.cfourdev.com.br	outra instalação da plataforma. http: é recusado: a chave viaja em cabeçalho de autorização
CFOUR_CONFIG_HOME	não	$XDG_CONFIG_HOME, ou ~/.config	onde gravar a chave. O arquivo é escrito com modo 0600 dentro de uma pasta 0700

Escolher a modelagem

Valem para cfour check, cfour serve e todos os comandos de modelo.

Variável	Obrigatória	Padrão	Finalidade
C4_MODELAGEM	não	a marcada como active no cfour.yaml	abre outra modelagem do registro sem editar o registro. Perde para --modelagem <id>
C4_ROOT	não	—	uma árvore avulsa, que não está em registro nenhum. Vence tudo, inclusive um cfour.yaml ao lado. Aponta para a pasta model/, e não para a raiz da modelagem

A ordem de precedência

Qual modelagem abrir:

C4_ROOT               vence tudo — nem consulta o registro
--modelagem <id>      na linha de comando
C4_MODELAGEM          no ambiente
active:               no cfour.yaml
a única registrada

Qual chave usar:

--profile <nome>      na linha de comando
CFOUR_KEY             no ambiente — vence o arquivo
o vínculo deste repositório (o `id:` do cfour.yaml)
a chave default da máquina
a única guardada

O que não é configurável por variável

A plataforma hospedada não expõe configuração por variável de ambiente para quem a usa: organização, repositório e papéis são configurados pela tela, e a chave de publicação carrega a organização e o repositório dentro dela.

As variáveis da API e da infraestrutura da plataforma são internas ao serviço, e não fazem parte da superfície de quem usa o produto.