Começar

Variáveis de ambiente.

As suas próprias variáveis e as que a Rivervo define por si, produção e pré-visualizações, substituir um valor automático e quando as alterações entram em vigor.

3 MIN DE LEITURA

As chaves, palavras-passe e definições da sua aplicação ficam no separador Variáveis. São guardadas encriptadas e chegam à aplicação como variáveis de ambiente normais.

Adicionar as suas

Variáveis → Adicionar uma variável, introduza um NOME e um valor e depois clique em Guardar.

  • Um nome tem letras latinas, algarismos e _, e não começa por um algarismo. Cada nome tem de ser único.
  • Dica: cole o conteúdo de um ficheiro .env num campo de nome — todas as linhas são adicionadas de uma vez.

As variáveis chegam à aplicação quando ela está em execução — não à fase de compilação. As alterações chegam à aplicação na publicação seguinte. Depois de guardar, o painel propõe Publicar agora, que volta a publicar a versão em execução com as novas variáveis, sem nova compilação.

Produção e pré-visualizações

Cada variável tem um Ambiente:

AmbientePara onde vai
Produção e pré-visualizaçõesa aplicação em produção e todas as pré-visualizações de branches (a predefinição)
Só produçãoapenas a aplicação em produção — por exemplo, uma chave de pagamentos real
Só pré-visualizaçõesapenas as pré-visualizações de branches — por exemplo, uma chave de pagamentos de teste

As pré-visualizações recebem apenas as variáveis definidas para elas. Cada pré-visualização tem também o seu próprio separador Variáveis: aí vê o que recebe Da aplicação, e um valor seu com o mesmo nome substitui-o apenas nessa pré-visualização.

Definidas automaticamente

A lista Definidas automaticamente mostra o que a Rivervo fornece à sua aplicação e mantém atualizado. Não precisa de as adicionar:

VariávelQuando
PORTsempre — a porta em que a aplicação escuta
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORDo projeto tem uma base de dados PostgreSQL ou MySQL
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORDa base de dados é PostgreSQL
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENTo projeto tem Valkey
RIVERVO_<NAME>_URLpara cada base de dados, Valkey e réplica de leitura do projeto, pelo nome do serviço
RIVERVO_<NAME>_URLpara cada um dos outros serviços web da aplicação — o respetivo endereço interno, por exemplo RIVERVO_API_URL=http://api:8080 (consulte Comunicação entre serviços)
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRETo projeto tem armazenamento de objetos
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STOREuma aplicação Laravel (consulte Laravel)

A primeira base de dados de um projeto recebe os nomes habituais (DATABASE_URL, DB_*). Uma segunda apenas acrescenta o seu próprio RIVERVO_<NAME>_URL, por isso nada muda sozinho — consulte Bases de dados.

Substituir um valor automático

Uma variável sua com o mesmo nome substitui a automática; o painel assinala-a com É usado o seu valor. Use isto para apontar a aplicação para outro sítio, por exemplo DATABASE_URL para outra base de dados do projeto.

A única exceção é PORT: é sempre gerida pela Rivervo.

Serviços de um projeto

Cada serviço de um projeto — workers, tarefas agendadas, outros serviços web — recebe as variáveis do projeto, incluindo a base de dados. Um serviço pode também ter variáveis próprias, que prevalecem sobre as do projeto. Um serviço web recebe sempre o seu próprio APP_URL. Cada serviço de código recebe também o endereço interno de cada um dos outros serviços web como RIVERVO_<NAME>_URL; depois de adicionar um serviço web ou mudar o nome de um, volte a publicar os outros serviços para que o recebam. Consulte Serviços de um projeto.

Quem pode ver os valores

Os valores são visíveis para o titular da conta e para as pessoas com a função Programador ou Administrador na aplicação. A função Leitor não os vê. Consulte Acesso a uma aplicação.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte