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.
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
.envnum 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:
| Ambiente | Para onde vai |
|---|---|
| Produção e pré-visualizações | a aplicação em produção e todas as pré-visualizações de branches (a predefinição) |
| Só produção | apenas a aplicação em produção — por exemplo, uma chave de pagamentos real |
| Só pré-visualizações | apenas 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ável | Quando |
|---|---|
PORT | sempre — a porta em que a aplicação escuta |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | o projeto tem uma base de dados PostgreSQL ou MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | a base de dados é PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | o projeto tem Valkey |
RIVERVO_<NAME>_URL | para cada base de dados, Valkey e réplica de leitura do projeto, pelo nome do serviço |
RIVERVO_<NAME>_URL | para 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_SECRET | o projeto tem armazenamento de objetos |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | uma 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.