Aller au contenu principal

Connexions de services

Les connexions de services relient un conteneur ou un job à un service managé, comme PostgreSQL, MariaDB, Valkey, NATS ou l'Object Storage. SailOps génère les credentials, les injecte sous forme de variables d'environnement et redéploie la charge de travail pour qu'elle les prenne en compte.

Fonctionnement​

Une connexion associe une source à une cible :

  • La source est un conteneur ou un job.
  • La cible est un service managé du projet.
  • Un alias définit le préfixe des variables injectées.
  • Un niveau d'accès définit les permissions.
Configuration automatique

Vous n'avez pas à copier manuellement les hostnames, ports ou mots de passe. La connexion gère l'injection des valeurs attendues par l'application.

Services pris en charge​

Service cibleVariable URLVariables détaillées
PostgreSQLDATABASE_URLPGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD, PGXPOOL_MAX_CONNS (lorsque le connection pooling est activé)
MariaDBDATABASE_URLMYSQL_HOST, MYSQL_PORT, MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD
ValkeyREDIS_URL, CACHE_URLREDIS_HOST, REDIS_PORT, REDIS_PASSWORD
NATSNATS_URLNATS_HOST, NATS_PORT, NATS_USER, NATS_PASSWORD
Object Storage—ACCESS_KEY_ID, SECRET_ACCESS_KEY, ENDPOINT_URL, ENDPOINT_URL_S3, REGION, DEFAULT_REGION, BUCKET_NAME, S3_FORCE_PATH_STYLE

Alias​

L'alias sert de préfixe aux variables injectées. Il doit contenir des lettres majuscules, chiffres et underscores, et commencer par une lettre.

Exemple avec l'alias ANALYTICS pour PostgreSQL :

ANALYTICS=postgresql://user:pass@host:5432/mydb?application_name=my-container
ANALYTICS_PGHOST=my-pg.my-project
ANALYTICS_PGPORT=5432
ANALYTICS_PGDATABASE=mydb
ANALYTICS_PGUSER=user
ANALYTICS_PGPASSWORD=s3cret
Détails du DSN PostgreSQL

La variable DATABASE_URL inclut un paramètre application_name correspondant au nom du conteneur ou du job source. Cela permet d'identifier les connexions dans les outils de monitoring PostgreSQL (pg_stat_activity). Lorsque le connection pooling est activé sur le cluster PostgreSQL cible, SailOps injecte également PGXPOOL_MAX_CONNS avec la taille de pool par défaut configurée.

Exemple avec l'alias AWS pour un bucket Object Storage media :

AWS_ACCESS_KEY_ID=<access-key>
AWS_SECRET_ACCESS_KEY=<secret-key>
AWS_ENDPOINT_URL=https://s3.example.com
AWS_ENDPOINT_URL_S3=https://s3.example.com
AWS_REGION=us-east-1
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET_NAME=media
AWS_S3_FORCE_PATH_STYLE=true
Alias Object Storage

Utilisez AWS comme alias pour les connexions Object Storage. La plupart des SDK AWS lisent automatiquement AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_ENDPOINT_URL_S3, AWS_DEFAULT_REGION et les autres variables préfixées AWS_ sans code supplémentaire.

Choisissez un alias qui décrit l'usage, par exemple SESSION_CACHE, ANALYTICS_DB ou EVENT_BUS.

Niveaux d'accès​

NiveauDescription
fullLecture, écriture et administration (par défaut pour les bases de données)
readwriteLecture et écriture standard sans privilèges d'administration (par défaut pour l'Object Storage)
readonlyLecture seule, utile pour le reporting ou les workloads qui ne modifient pas les données

Pour l'Object Storage, les niveaux d'accès contrôlent des actions S3 spécifiques sur le bucket connecté :

NiveauPermissions
readonlyLecture des objets, des versions précédentes et des listings
readwriteLecture, chargement et suppression d'objets
fullLecture, écriture et suppression définitive de versions individuelles
attention

Le niveau full autorise la suppression définitive de versions, qui est irréversible. Les paramètres du bucket, les politiques et l'administration des utilisateurs ne sont jamais accordés via les connexions.

Créer une connexion​

  1. Ouvrez le conteneur.
  2. Allez dans l'onglet Connections.
  3. Cliquez sur New Connection.
  4. Sélectionnez la source et le service cible.
  5. Saisissez un alias.
  6. Choisissez le niveau d'accès (full, readwrite ou readonly).
  7. Activez Dedicated database si vous voulez une base isolée sur PostgreSQL ou MariaDB.
  8. Cliquez sur Create.
Redéploiement automatique

La création d'une connexion redéploie généralement la source pour charger les nouvelles variables. Désactivez cette option seulement si vous préférez redéployer manuellement.

Connexions Object Storage

Les connexions Object Storage ciblent un bucket existant — le bucket doit être créé au préalable. L'option New Connection with Service n'est pas disponible pour l'Object Storage.

Créer une connexion avec un nouveau service​

L'option New Connection with Service provisionne un nouveau service managé et le connecte dans la même opération. Utilisez-la pour créer une base ou un cache dédié à une application.

Connexions pour les jobs​

Les jobs et CronJobs disposent de leur propre onglet Connections.

  • CronJobs : gestion complète des connexions — ajoutez, modifiez et supprimez à tout moment. Les modifications prennent effet à la prochaine exécution planifiée.
  • Jobs ponctuels : les connexions sont affichées en lecture seule, car le pod template d'un Job est immuable après sa création. Les connexions doivent être déclarées à la création du job.

Gérer les connexions​

Depuis l'onglet Connections de votre conteneur ou job, vous pouvez consulter la cible, l'alias, le niveau d'accès et les variables injectées. Les valeurs sensibles sont masquées dans l'interface.

Supprimer une connexion retire les variables associées du workload source. Vérifiez que l'application peut démarrer sans ces variables avant de supprimer une connexion active.

Bonnes pratiques​

  • Utilisez des alias explicites par usage.
  • Préférez readonly lorsque le workload ne fait que lire les données.
  • Créez une connexion par usage pour faciliter l'audit et l'isolation.
  • Laissez le redéploiement automatique activé pour éviter les credentials obsolètes.

Sujets liés​