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 apenas o seu banco de dados conosco, mas não o seu frontend. Para bancos de dados, fornecemos detalhes de conexão de banco de dados externo.
  Observação: no futuro, as conexões externas serão desativadas por padrão para bancos de dados, e recomendamos que você as mantenha desativadas quando não estiverem em uso por motivos de segurança.
• Uma conexão interna permanece em nossa rede e, portanto, é muito mais rápida e segura. Recomendamos esse método se você hospedar o frontend e o banco de dados com a Hospedagem de Aplicativos e a Hospedagem de Banco de Dados.

Adicionando uma conexão interna

Você pode adicionar conexões internas na página Configurações de um aplicativo ou na página Informações 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 banco de dados a um aplicativo, vá para Bancos de dados > nome do banco de dados > Visão geral > na seção Conexões internas, clique em Adicionar aplicativo e selecione o aplicativo 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 de 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 > nome do banco de dados > Visão geral > Conexões externas) para os valores de quaisquer variáveis a serem usadas no processo de build.

Portas

A porta para conexões internas a um aplicativo é 8080, e a porta para conexões internas a um banco de dados é 3306. As portas para essas conexões internas não podem ser alteradas.

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.

Removendo uma conexão interna

Se você precisar remover uma conexão, vá para a página Visão geral do banco de dados 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.

Conexões externas

Você pode encontrar os detalhes da conexão para conexões externas em Bancos de dados > nome do banco de dados > Visão geral > Conexões externas. Você pode usar esses detalhes para se conectar ao seu banco de dados por meio da linha de comando (CLI) ou com uma ferramenta do banco de dados.

Alterando a senha do banco de dados

Você pode alterar a senha do banco de dados para suas conexões internas e externas. Na página Visão geral do banco de dados, na Conexão interna ou na Conexão externa, clique em Alterar senha e digite uma nova senha. Como alternativa, clique em Gerar uma nova senha para criar uma nova senha automaticamente.

As senhas devem ter pelo menos 8 caracteres e incluir pelo menos uma letra minúscula, uma letra maiúscula, um número e um dos seguintes caracteres especiais: , & * [ ] : ’ $ ` ”

Quando você altera a senha, a Kinsta inicia automaticamente uma nova implantação para aplicativos com uma conexão interna ao banco de dados, usando valores de variáveis de ambiente correspondentes à senha antiga. Você deve alterar manualmente a senha em cada cliente que usar para se conectar ao banco de dados e atualizar quaisquer outras variáveis de ambiente relevantes.