Ambiente

O painel Ambiente define variáveis de ambiente simples exportadas para todas as shells da VM da máquina (uma máquina é um espaço de trabalho, no editor de definições). Servem para definições não secretas — níveis de registo, sinalizadores de funcionalidades, interruptores de compilação — que quer no ambiente do agente sem qualquer tratamento de credenciais.

A legenda diz o que o painel faz e para o que não serve: «Pares KEY=VALUE simples exportados para todas as shells da VM através de proxy.env (carregado a partir de .bashrc). Sem substituição pelo proxy — os valores chegam à VM tal e qual, pelo que não ponha segredos aqui. Bom para níveis de registo, sinalizadores de funcionalidades, interruptores de compilação.» Sem nada configurado, lê-se Nenhuma variável de ambiente configurada.

Como as variáveis são exportadas

Cada variável é escrita em proxy.env, que o .bashrc gerido da máquina carrega para todas as shells. O valor está presente em todos os terminais, em todos os comandos que o agente corre, e em todas as shells de início de sessão e não-início de sessão, exatamente como o escreveu. Não há substituto nem troca no fio.

Para um token ou uma palavra-passe, use em vez disso o painel Credenciais: aí a VM recebe apenas um substituto, e o valor real é colocado no fio. Um segredo escrito neste painel chega ao interior da VM em texto simples.

Acrescentar e editar variáveis

Adicionar variável acrescenta uma linha com um campo de nome e um campo de valor; o botão de menos remove-a. O nome tem de ser um identificador de shell válido — uma letra ou sublinhado, depois letras, dígitos e sublinhados. Um nome que não corresponda mostra um aviso laranja e não é exportado. O valor é usado como escrito.

Alterações numa máquina em execução

Gravar aplica sem reinício: proxy.env é reescrito, e as shells abertas depois de gravar vêem os novos valores. Um agente que já esteja a correr mantém o ambiente com que arrancou; um novo separador ou uma nova sessão apanha a alteração.

Os valores são guardados no secrets.enc cifrado da máquina, como os outros dados do painel, e não em profile.json.

Referência de definições

Capítulos relacionados

• Credenciais — onde os segredos pertencem.
• MCP — servidores MCP, alguns dos quais leem variáveis de ambiente.
• Referência de Definições — todos os painéis num relance.