Connexion à la base de données

Il existe trois façons de se connecter à la base de données de chaque environnement : vous pouvez utiliser PhpMyAdmin ou un explorateur de bases de données configuré avec la connexion à distance, ou vous pouvez également utiliser la ligne de commande mysql tout en étant connecté avec SSH à votre environnement.

PhpMyAdmin

La connexion à PhpMyAdmin est très facile. Sur la page Credentials de chaque environnement, faites défiler jusqu'à la section Database. Il y a un bouton qui vous amènera directement à l'interface PhpMyAdmin. Assurez-vous de copier le nom d'utilisateur et le mot de passe dans le presse-papiers car on vous demandera d'entrer ces détails.

Connexion à distance

Quand PhpMyAdmin ne suffit pas, il est toujours possible de connecter votre propre explorateur de bases de données à votre base de données alimentée par PS Platform. Il existe de nombreux outils disponibles de nos jours, parmi lesquels MySQL Workbench, Navicat, Datagrip, ... Nous utiliserons DataGrip pour documenter comment configurer votre connexion, mais le principe sera le même dans tous les outils de base de données.

Vous vous connecterez avec l'utilisateur de base de données "admin" qui a un accès complet à cette base de données. Faites attention lorsque vous exécutez des instructions de suppression ou de mise à jour lorsque vous n'êtes pas connecté en mode lecture seule.

Tunnel SSH

Pour des raisons de sécurité, le port de la base de données ne sera pas rendu public. Cette configuration est donc un peu plus complexe. Tout d'abord, assurez-vous que la clé SSH a été ajoutée à votre compte et que le SFTP est activé (indépendamment du mode Git/SFTP général). Maintenant que les clés SSH ont été ajoutées et que le port SFTP est ouvert, un tunnel vers le port MySQL peut être configuré.

Ligne de commande

Pour créer un tunnel SSH vers le port MySQL, copiez cette commande dans le presse-papiers et exécutez-la dans votre shell local. La commande aura le format suivant :

ssh -L 13306:127.0.0.1:3306 -N [SFTP_USERNAME]@[SFTP_HOSTNAME] -p [SFTP_PORT]

Vous pouvez maintenant vous connecter à votre instance MySQL sur le port 13306 et l'hôte 127.0.0.1.

Explorateur de bases de données

Lors de l'ajout d'une nouvelle source de données dans notre outil, DataGrip, accédez au deuxième onglet appelé SSH/Tunnel. Les champs à saisir ici se trouvent dans l'onglet Credentials sous SFTP. Vous y trouverez les champs Host, Port et Username. L'authentification se fera toujours avec votre clé privée.

Maintenant que tous les paramètres sont disponibles, saisissez-les dans la configuration de votre source de données.

Maintenant que le tunnel est configuré, connectez-vous à votre base de données comme vous le feriez avec une base de données sur votre machine locale. Assurez-vous d'utiliser 127.0.0.1 pour votre hôte et PAS localhost ! La redirection de port ne sera pas disponible sur localhost. Le nom d'utilisateur et le mot de passe de la base de données se trouvent sous la section Database de vos identifiants, tout comme ceux utilisés pour PhpMyAdmin.

Lorsqu'un tunnel a été établi en utilisant la méthode de la ligne de commande, assurez-vous de vous connecter au port local configuré. (`13306`dans ce cas)

MySQL en Ligne de Commande

Enfin, vous pouvez accéder à votre base de données avec la ligne de commande mysql tout en étant connecté avec SSH à votre environnement.

Tout d'abord, vous devrez accéder à l'onglet Credentials de PS Platform pour obtenir l'utilisateur et le mot de passe nécessaires.

Ensuite, vous pouvez vous connecter avec la commande suivante :

mysql -u <USER> -p<PASSWORD> <DB_NAME>

Note : pas besoin d'indiquer l'hôte, localhost sera utilisé par défaut.