Connexions

Les connexions permettent aux applications et aux bases de données de communiquer. Il y a deux façons principales d’y parvenir :

• Une connexion externe fait un aller-retour sur l’internet, elle est donc beaucoup plus lente qu’une communication interne. Nous recommandons les connexions externes si vous n’hébergez chez nous que votre base de données et non votre front-end. Pour les bases de données, nous fournissons les détails de la connexion externe à la base de données.
  Remarque : à l’avenir, les connexions externes seront désactivées par défaut pour les bases de données, et nous vous recommandons de les désactiver lorsqu’elles ne sont pas utilisées, pour des raisons de sécurité.
• Une connexion interne reste dans notre réseau et est donc beaucoup plus rapide et plus sûre. Nous recommandons cette méthode si vous hébergez votre frontend et votre base de données avec l’hébergement d’applications et l’hébergement de bases de données.

Ajouter une connexion interne

Vous pouvez ajouter des connexions internes à partir de la page Réglages d’une application ou de la page Info d’une base de données. Peu importe où vous commencez le processus, le résultat sera le même.

Pour ajouter une connexion d’une base de données à une application, allez dans Bases de données > Nom de la base de données > Vue globale > dans la section Connexions internes, cliquez sur Ajouter une application, et sélectionnez l’application avec laquelle vous souhaitez créer la connexion interne.

Variables d’environnement

Nous pouvons automatiquement remplir les variables d’environnement d’une application à partir des détails de la connexion à la base de données. Ne copiez pas et ne collez pas les détails de la connexion interne dans les variables d’environnement. Cliquez sur Ajouter une connexion ou Ajouter une application et cochez la case Ajouter des variables d’environnement. Les variables d’environnement de la base de données à laquelle vous vous connectez seront automatiquement renseignées.

Certaines applications peuvent exiger des variables d’environnement (clés) avec des noms différents. Vous pouvez modifier les noms dans la liste avant d’ajouter la connexion ou les modifier ultérieurement sur la page Réglages de l’application.

Connexions internes et processus de construction

Les connexions internes ne sont disponibles que pendant l’exécution ; elles ne sont pas disponibles pendant le processus de construction.

Si votre application tente de se connecter à une base de données à l’aide d’une connexion interne pendant le processus de construction, une erreur se produit, indiquant que la base de données n’est pas en cours d’exécution, ce qui entraîne l’échec de la construction. C’est normal, car la connexion interne n’est pas active pendant la construction ; elle ne peut être utilisée que pendant l’exécution.

Il existe plusieurs façons de contourner ce problème.

Option 1 : Déplacez la logique de connexion à la base de données de la commande de construction de l’application vers la commande de démarrage. Par exemple : si vous avez une commande comme prisma migrate dans le processus de construction et que vous déplacez cette commande vers la commande de démarrage, votre application n’accèdera à la base de données que pendant l’exécution, et la construction sera réussie.

Option 2 : ajoutez des variables d’environnement distinctes pour la connexion à la base de données, l’une étant disponible pour le processus de construction et l’autre uniquement pour l’exécution. Les clés peuvent être les mêmes (par exemple DB_CONNECTION_URL) tant que l’une n’est disponible que pendant le processus de construction et l’autre que pendant l’exécution. Utilisez les détails de la connexion externe de la base de données (Bases de données > Nom de la base > Vue globales > Connexions externes) pour les valeurs des variables à utiliser dans le processus de construction.

Ports

Le port pour les connexions internes à une application est 8080, et le port pour les connexions internes à une base de données est 3306. Les ports de ces connexions internes ne peuvent pas être modifiés.

Pour les applications, Kinsta définit automatiquement la variable d’environnement PORT. Vous n’avez pas besoin de la définir vous-même ou de la coder en dur dans l’application. Lorsqu’une application est déployée, elle est accessible sur internet sur les ports 80 et 443, et nous routons ces ports vers le conteneur sur le port 8080.

Supprimer une connexion interne

Si vous devez supprimer une connexion, allez sur la page Vue globale de la base de données et, sous Connexions internes, cliquez sur l’icône de suppression (corbeille).

Dans la fenêtre modale ou contextuelle Supprimer laconnexion, cliquez sur Supprimer la connexion pour confirmer et supprimer la connexion entre l’application et la base de données.

Connexions externes

Vous pouvez trouver les détails des connexions externes dans Bases de données > Nom de la base de données > Vue globale > Connexions externes. Vous pouvez utiliser ces détails pour vous connecter à votre base de données via la ligne de commande (CLI) ou avec un outil de base de données.

Modifier le mot de passe de la base de données

Vous pouvez modifier le mot de passe de la base de données pour vos connexions internes et externes. Sur la page Vue globale de la base de données, dans connexion interne ou connexion externe, cliquez sur Modifier le mot de passe et saisissez un nouveau mot de passe. Vous pouvez également cliquer sur Générer un nouveau mot de passe pour créer automatiquement un nouveau mot de passe.

Les mots de passe doivent comporter au moins 8 caractères et inclure au moins une lettre minuscule, une lettre majuscule, un chiffre et l’un des caractères spéciaux suivants : , & * [ ] : ’ $ ` ”

Lorsque vous modifiez le mot de passe, Kinsta lance automatiquement un nouveau déploiement pour les applications disposant d’une connexion interne à la base de données, en utilisant les valeurs des variables d’environnement correspondant à l’ancien mot de passe. Vous devez modifier manuellement le mot de passe dans chaque client que vous utilisez pour vous connecter à la base de données et mettre à jour toutes les autres variables d’environnement pertinentes.