# Vínculos entre recursos

> Ligue a instalação a um banco ou a um bucket por um apelido e deixe a plataforma injetar a conexão nas variáveis de ambiente.

_Fonte: https://w8hub.com.br/docs/instalacao-vinculos_

Dá para conectar uma aplicação ao banco copiando a string de conexão para uma [variável de ambiente](https://w8hub.com.br/docs/instalacao-configuracoes#variaveis-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](https://w8hub.com.br/docs/bancos-de-dados).
- Um **bucket** do [armazenamento S3](https://w8hub.com.br/docs/armazenamento-s3).
- Um [banco externo](https://w8hub.com.br/docs/bancos-externos) 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.

> [!WARNING]
> Trocar o alvo muda **para onde a aplicação escreve**. Confira o apelido antes de confirmar: um `principal` trocado por engano manda a produção para o banco errado.

## 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](https://w8hub.com.br/docs/instalacao-configuracoes#variaveis-de-ambiente) como as variáveis chegam na aplicação.