Você pode adicionar conexões internas a partir da página de configurações de um aplicativo ou da página de informações de um banco de dados. Não importa onde você inicia o processo; o resultado será o mesmo.
- Se você gostaria de adicionar uma conexão de um Aplicativo use o botão Adicionar conexão na seção Conexões internas da página Configurações.
- Se você gostaria de adicionar uma conexão de um Banco de Dados, use o botão Adicionar aplicativo na seção Conexões Internas da página de Informações.
Em ambos os casos, você verá a mesma interface permitindo que você selecione o banco de dados ou aplicativo ao qual você gostaria de criar a conexão interna.
Variáveis de ambiente
Podemos preencher automaticamente as variáveis de ambiente de um aplicativo com os detalhes de conexão do banco de dados. Não copie e cole os detalhes internos de conexão nas variáveis de ambiente. Clique em Adicionar conexão ou Adicionar aplicativo e selecione a opção Adicionar variáveis de ambiente…. Isso preencherá automaticamente as variáveis de ambiente com os detalhes 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 de Configurações do aplicativo.
Nós podemos preencher automaticamente as variáveis de ambiente no aplicativo a partir dos detalhes de conexão do banco de dados. Se você quiser que isso aconteça, selecione a caixa de seleção Adicionar variáveis de ambiente no aplicativo . As aplicações podem esperar variáveis de ambiente com nomes diferentes, então você pode editá-las na lista antes de adicionar a conexão. O PORT para o aplicativo está em Configurações e o PORT padrão para conexões internas é 8080. Para visualizar a PORT do banco de dados, na página de Informações, clique em Detalhes de conexão.
Conexões internas e processo de build
Conexões internas estão disponíveis apenas durante a 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 dizendo que o banco de dados não está em execução, o que fará 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 a execução.
Existem algumas maneiras de contornar isso.
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ê tem um comando como prisma migrate no processo de build, mova esse comando para o comando start. Assim, o seu aplicativo só acessará o banco de dados durante a execução, e a build será bem-sucedida.
Opção 2: Adicione variáveis de ambiente separadas conforme necessário para a conexão do banco de dados, uma disponível para o processo de build e outra apenas para a execução. As chaves podem ser as mesmas (por exemplo, DB_CONNECTION_URL), desde que uma esteja disponível apenas durante o processo de build e a outra esteja disponível apenas durante a execução. Use os detalhes de conexão externa do banco de dados (Bancos de dados > nomedobanco > Informações > Conexões externas) para os valores de quaisquer variáveis a serem usadas no processo de build.
Portas
A porta para conexões internas de um aplicativo é 8080, e a porta para conexões internas de um banco de dados é 3306. As portas dessas conexões internas não podem ser alteradas.
Para aplicativos, a Kinsta configura automaticamente a variável de ambiente PORT. Você não precisa defini-la manualmente ou codificá-la no aplicativo. Quando um aplicativo é implantado, ele pode ser acessado na internet nas portas 80 e 443, e nós direcionamos essas portas para o contêiner na porta 8080.