Vínculos entre recursos

Dá para conectar uma aplicação ao banco copiando a string de conexão para uma variável de ambiente na mão. Funciona — e quebra no dia em que a senha muda, ou quando alguém cola a string de produção no ambiente de teste.

O vínculo resolve isso: você liga a instalação ao recurso por um apelido, e a plataforma injeta os dados de conexão nas variáveis. Se a senha mudar, o vínculo continua valendo.

O que dá para vincular

• Uma conta de acesso de um banco gerenciado.
• Um bucket do armazenamento S3.
• Um banco externo que você registrou.

Apelido e variáveis

Cada vínculo tem um apelido — principal, cache, uploads — e um mapa de variáveis, que decide com que nome cada dado de conexão chega na aplicação.

É o mapa que deixa o vínculo se encaixar no que a sua aplicação já espera: se ela lê DATABASE_URL, aponte a string de conexão para DATABASE_URL e nada no código muda.

Vincular ou criar na hora

Ao criar um vínculo você escolhe entre duas coisas:

• Vincular a um recurso que já existe.
• Criar o recurso junto com o vínculo, já conectado.

O segundo caminho é o mais rápido para subir uma aplicação nova: em vez de criar o banco, criar a conta, copiar a string e colar na variável, você faz tudo de uma vez.

Trocar o alvo

Esta é a parte que compensa o conceito: o apelido pode passar a apontar para outro recurso, com a opção de já reiniciar a instalação.

Serve para promover um banco de teste a produção, voltar para o banco anterior depois de uma migração que deu errado, ou trocar um banco gerenciado por um externo. A aplicação continua lendo a mesma variável, com o mesmo nome — quem muda é o que está do outro lado.

Remover

Remover o vínculo desfaz a ligação e tira as variáveis que ele injetava. O recurso do outro lado — banco ou bucket — não é apagado.

Próximo passo

Com o vínculo no lugar, veja em Configurações da instalação como as variáveis chegam na aplicação.