Conexões

As conexões são a forma como os aplicativos e os bancos de dados podem se comunicar. Há duas maneiras principais de fazer isso:

• Uma conexão externa faz uma viagem de ida e volta pela Internet, portanto, é muito mais lenta do que a comunicação interna. Recomendamos conexões externas se você estiver hospedando somente o seu banco de dados conosco, mas não o seu frontend. Para aplicativos, as conexões externas podem ser feitas por meio do servidor da web, como você esperaria.
• Uma conexão interna permanece em nossa rede, sendo assim, mais rápida e segura. Este método é recomendado se você hospedar tanto o frontend quanto o banco de dados conosco, utilizando a Hospedagem de Aplicativos e a Hospedagem de Banco de Dados.

Adicione uma conexão interna

Você pode adicionar conexões internas na página Configurações de um aplicativo ou na página Visão geral de um banco de dados. Não importa onde você inicia o processo; o resultado será o mesmo.

Para adicionar uma conexão de um aplicativo a um banco de dados, vá para Aplicativos > nome do aplicativo > Configurações > na seção Conexões internas, clique em Adicionar conexão e selecione o banco de dados ao qual você deseja criar a conexão interna.

Variáveis de ambiente

Podemos preencher automaticamente as variáveis de ambiente de um aplicativo a partir dos detalhes da conexão com o banco de dados. Você não deve copiar e colar os detalhes da conexão interna nas variáveis de ambiente. Clique em Adicionar conexão ou Adicionar aplicativo e marque a caixa de seleção Adicionar variáveis de ambiente…. Isso preencherá automaticamente as variáveis de ambiente do banco de dados ao qual você está se conectando.

Alguns aplicativos podem esperar variáveis de ambiente (chaves) com nomes diferentes. Você pode editar os nomes na lista antes de adicionar a conexão ou editá-los posteriormente na página Configurações do aplicativo.

Conexões internas e o processo de build

As conexões internas só estão disponíveis durante o tempo de execução; elas não estão disponíveis durante o processo de build.

Se o seu aplicativo tentar se conectar a um banco de dados usando uma conexão interna durante o processo de build, isso causará um erro que diz que o banco de dados não está em execução, o que faz com que a build falhe. Isso é esperado porque a conexão interna não está ativa durante a build; ela só pode ser usada durante o tempo de execução.

Há algumas maneiras de contornar esse problema.

Opção 1: Mova a lógica que se conecta ao banco de dados do comando build do aplicativo para o comando start. Por exemplo: se você tiver um comando como prisma migrate no processo de build e mover esse comando para o comando start, seu aplicativo só acessará o banco de dados durante o tempo de execução e a build será bem-sucedida.

Opção 2: Adicione variáveis de ambiente separadas conforme necessário para a conexão com o banco de dados, uma disponível para o processo de build e a outra somente para o tempo de execução. As chaves podem ser as mesmas (por exemplo, DB_CONNECTION_URL), desde que uma esteja disponível somente durante o processo de build e a outra somente durante o tempo de execução. Use os detalhes da conexão externa do banco de dados (Bancos de dados > dbname > Visão geral > Conexões externas) para os valores de quaisquer variáveis a serem usadas no processo de build.

Portas

A porta designada para conexões internas com um aplicativo é a 8080, enquanto para conexões internas com um banco de dados é a 3306. As portas destinadas a essas conexões internas são fixas e não podem ser modificadas.

Para aplicativos, a Kinsta define automaticamente a variável de ambiente PORT. Você não precisa defini-la ou codificá-la no aplicativo. Quando um aplicativo é implantado, ele pode ser acessado na Internet pelas portas 80 e 443, e nós roteamos essas portas para o contêiner na porta 8080.

Remova uma conexão interna

Se você precisar remover uma conexão, vá para a página Configuraçõesdo aplicativo e, em Conexões internas, clique no ícone de exclusão (lixeira).

Na janela modal/pop-up Remover conexão, clique em Remover conexão para confirmar e remover a conexão entre o aplicativo e o banco de dados.