Aller au contenu
KendorDocs

Comment ajouter une base de données PostgreSQL, MySQL, MongoDB ou Redis à un exercice de code

Pour les auteurs d’exercices ·

Déclarez PostgreSQL 18, MySQL 8.4, MongoDB 8.0 ou Valkey 9 sous databases dans kendor.yaml. Elles s’exécutent dans le bac à sable, et le code s’y connecte avec DATABASE_URL, MONGODB_URI ou REDIS_URL.

Pour donner une base de données à un exercice, déclarez-la sous databases dans kendor.yaml. Kendor exécute PostgreSQL 18, MySQL 8.4, MongoDB 8.0 et Valkey 9 (compatible Redis) dans le bac à sable du candidat, sur 127.0.0.1, les démarre avant toute commande d’installation et définit des variables de connexion comme DATABASE_URL, MONGODB_URI et REDIS_URL pour chaque processus : le code se connecte donc sans aucune configuration de la part du candidat.

Déclarer une base de données

kendor.yaml
version: 1
runtime:
  type: node
  version: "22"
databases:
  - type: postgres
    version: "18"
    init: db/seed.sql
  - type: valkey
    version: "9"
services:
  app:
    install:
      commands:
        - npm ci
    dev:
      command: node --watch src/server.js
      port: 3000
    test:
      command: node --test
Clé Obligatoire Description
type Oui postgres, mysql, mongodb ou valkey. Chacun au plus une fois, et un seul parmi postgres et mysql, puisque les deux définissent DATABASE_URL.
version Oui "18" pour PostgreSQL, "8.4" pour MySQL, "8.0" pour MongoDB, "9" pour Valkey, sous forme de chaîne entre guillemets.
name Non PostgreSQL, MySQL et MongoDB. La base à créer. app par défaut. Lettres minuscules, chiffres, tirets bas et traits d’union, en commençant par une lettre ou un tiret bas, et pas un nom réservé par le moteur (postgres, template0, template1, admin, local, config, mysql, information_schema, performance_schema, sys).
user Non PostgreSQL, MySQL et MongoDB. L’utilisateur avec lequel l’application se connecte. kendor par défaut.
password Non PostgreSQL, MySQL et MongoDB. Le mot de passe de cet utilisateur. Aucun par défaut, sauf pour MongoDB, où c’est kendor.
init Non PostgreSQL, MySQL et MongoDB. Un fichier de seed, ou un dossier de fichiers de seed, relatif à la racine de l’espace de travail : .sql pour PostgreSQL et MySQL, .js pour MongoDB.

Vous pouvez aussi ajouter des bases de données dans la boîte de dialogue Configuration d’exécution, sous Bases de données, avec un Fichier de seed facultatif. Le projet Express + PostgreSQL + Valkey pour Node.js est un exemple complet et fonctionnel.

Charger des données avec init

init s’exécute une seule fois, juste après la création de la base, avec l’utilisateur propre à l’application :

  • Un fichier s’exécute seul. Un dossier exécute tous les fichiers de seed qu’il contient, dans l’ordre alphabétique des noms ; préfixez donc les fichiers par des numéros : 01_schema.sql, 02_data.sql.
  • PostgreSQL exécute tout dans une seule transaction. Si une instruction échoue, rien n’est appliqué.
  • MySQL exécute chaque fichier .sql tour à tour et s’arrête à la première erreur. MySQL ne peut pas annuler les modifications de schéma : un seed qui échoue peut donc laisser certaines tables.
  • MongoDB exécute les fichiers .js avec mongosh, connecté à la base de l’application. Aucune transaction ne les entoure : un seed qui échoue peut donc laisser certaines écritures.
  • Si le seed échoue pendant que le bac à sable tourne, la base de données continue de fonctionner et l’erreur s’affiche dans son processus. Corrigez le fichier, puis redémarrez le processus Base de données depuis la vue Processus pour le relancer.

Les migrations lancées par votre framework (prisma migrate deploy, php artisan migrate) vont plutôt dans les commandes migrate du service. Elles s’exécutent à chaque démarrage du service, après son installation et avant sa commande dev : les nouveaux fichiers de migration sont donc appliqués lors d’un redémarrage. Quand vous importez un dépôt, Kendor les renseigne à partir de l’outil de migration qu’il utilise déjà.

Détails de connexion

Chaque serveur écoute uniquement sur 127.0.0.1. PostgreSQL et MySQL se connectent avec l’utilisateur kendor, sans mot de passe. MongoDB n’a pas de connexion sans mot de passe : son utilisateur kendor a donc le mot de passe kendor. L’utilisateur de l’application peut gérer sa propre base mais n’est pas superutilisateur.

PostgreSQL

Variable Valeur
DATABASE_URL postgresql://kendor@127.0.0.1:5432/app (avec votre name à la place de app)
PGHOST, PGPORT, PGUSER, PGDATABASE 127.0.0.1, 5432, kendor, le nom de la base
DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD Les mêmes valeurs, pour Laravel. DB_PASSWORD est vide.
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD jdbc:postgresql://127.0.0.1:5432/app, kendor et vide, pour Spring Boot.

Quand vous définissez un password, PGPASSWORD est aussi défini.

Comme ce sont de véritables variables d’environnement, elles l’emportent sur un fichier .env Laravel ou un application.properties Spring.

MySQL

Variable Valeur
DATABASE_URL mysql://kendor@127.0.0.1:3306/app (avec votre name à la place de app)
MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE 127.0.0.1, 3306, kendor, vide, le nom de la base
DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD mysql et les mêmes valeurs, pour Laravel.
SPRING_DATASOURCE_URL, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD jdbc:mysql://127.0.0.1:3306/app, kendor et vide, pour Spring Boot.

Quand vous définissez un password, MYSQL_PWD est aussi défini. Le serveur accepte également les connexions mysql_native_password, pour les anciens pilotes qui ne gèrent pas la méthode par défaut plus récente de MySQL.

MongoDB

Variable Valeur
MONGODB_URI, MONGODB_URL, MONGO_URI, MONGO_URL mongodb://kendor:kendor@127.0.0.1:27017/app?directConnection=true (avec votre name à la place de app)
SPRING_DATA_MONGODB_URI La même, pour Spring Boot.
DATABASE_URL La même, pour Prisma. Non définie quand PostgreSQL ou MySQL est aussi déclaré ; la base SQL la conserve.

MongoDB s’exécute en replica set à un seul nœud : les transactions et les change streams fonctionnent. L’utilisateur existe dans la base de l’application et dans admin : une URL avec authSource=admin fonctionne donc aussi.

Valkey

Variable Valeur
REDIS_URL, VALKEY_URL redis://127.0.0.1:6379
REDIS_HOST, REDIS_PORT 127.0.0.1, 6379
SPRING_DATA_REDIS_HOST, SPRING_DATA_REDIS_PORT Les mêmes, pour Spring Boot.

Valkey parle le protocole Redis : n’importe quel client Redis fonctionne.

Si votre code lit une variable portant un autre nom, associez-la dans dev.env.vars du service avec databases.<type>.url, par exemple databases.postgres.url ou databases.mongodb.url :

kendor.yaml
version: 1
runtime:
  type: python
  version: "3.12"
databases:
  - type: postgres
    version: "18"
    name: inventory
services:
  app:
    install:
      commands:
        - pip install --user -r requirements.txt
    dev:
      command: uvicorn main:app --host $HOST --port $PORT --reload
      port: 8000
      env:
        vars:
          SQLALCHEMY_DATABASE_URI: databases.postgres.url

Les candidats voient les mêmes informations dans l’éditeur : la vue Processus contient une section Bases de données avec chaque URL de connexion, toutes les variables définies pour elle et une commande pour ouvrir un client dans le terminal :

Base de données Commande dans le terminal
PostgreSQL psql
MySQL mysql -h 127.0.0.1 -u $MYSQL_USER $MYSQL_DATABASE
MongoDB mongosh $MONGODB_URI
Valkey redis-cli

Se connecter depuis le code

Lisez l’URL depuis l’environnement. Ajoutez la bibliothèque cliente aux dépendances de votre projet (pg et redis pour Node.js, psycopg et redis pour Python) afin que la commande d’installation la récupère.

src/db.js
import pg from 'pg';
import { createClient } from 'redis';

export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });

export const cache = createClient({ url: process.env.REDIS_URL });
await cache.connect();

const { rows } = await pool.query('SELECT id, title FROM todos ORDER BY id');
await cache.set('todos', JSON.stringify(rows));

Ce qu’il advient des données

Pendant une session, les données persistent. Les lignes sont stockées dans le dossier de cache propre au bac à sable : elles survivent au redémarrage du processus de base de données ou de tout le bac à sable, et le seed init ne s’exécute pas une seconde fois.

L’onglet Tests s’exécute sur cette même base de données active. Écrivez des tests qui créent les lignes dont ils ont besoin et nettoient après eux, ou enveloppez chaque test dans une transaction, afin que les essais d’un candidat dans le terminal ne puissent pas modifier le résultat.

Limites

Limite
Connexions PostgreSQL 20
Fichiers temporaires PostgreSQL 1 Go par connexion
Connexions MySQL 20
Cache MongoDB 256 Mo
Mémoire Valkey 64 Mo
Données sur disque 1 Go ; au-delà, les serveurs de bases de données s’arrêtent, et le processus Base de données indique comment repartir d’une base vide

Les ports des bases de données, 5432, 3306, 27017 et 6379, ne sont jamais exposés via l’aperçu, même si un serveur y écoute.

MySQL ne peut ni lire ni écrire de fichiers sur le disque du bac à sable (LOAD DATA INFILE, SELECT ... INTO OUTFILE), et MongoDB a le JavaScript côté serveur désactivé ($where, $function, mapReduce).

Cet article vous a-t-il aidé ?