Aller au contenu

Paramètres cluster

Onglet Paramètres → Paramètres cluster.

Les paramètres cluster sont des réglages textuels typés qui pilotent le comportement de la plateforme. Chaque paramètre a :

  • un type (réglage cluster, licence Digdash, jeton d'API…) ;
  • un nom (sa clé) et une valeur ;
  • une portée : globale (namespace vide — s'applique partout, gestion réservée aux administrateurs de plateforme) ou scopée à un namespace (gérée par les admins de ce namespace, prioritaire sur la valeur globale).

Exemples de réglages reconnus

Nom Effet
USE_DIGDASH_BETA true pour proposer les versions BETA de Digdash dans le choix de version
DIGDASH_QA_DATABASE_TYPES true pour afficher les moteurs de base réservés à la QA interne (MariaDB, PostgreSQL side-car) dans le formulaire Digdash BI
DIGDASH_FILEBROWSER Valeur par défaut de l'option File Browser des déploiements Digdash
DEFAULT_DIGDASH_RAM Mémoire par défaut proposée pour un déploiement Digdash BI
CPU_REQUEST_RATIO_<APPLICATION> Part de la limite CPU réservée (requests), en pourcentage — ex. 20 : un Hop Web limité à 2 cœurs n'en réserve que 0,4. Un paramètre par type d'application : POSTGRES, DIGDASH_BI, HOP_WEB (ou APACHE_HOP_WEB), HOP_SERVER, FORGEJO, NGINX, ICEBERG. Appliqué au déploiement (ensuite, la réservation se règle directement dans Configurer → ressources du conteneur) ; 100 (défaut) = réservation égale à la limite.
GRAFANA_URL, PROMETHEUS_PUBLIC_URL, ALERTMANAGER_URL URL publiques des outils de supervision (liens de la page Cluster, de la barre latérale et des cartes) — par défaut https://grafana|prometheus|alertmanager.<domaine>
PROMETHEUS_URL Adresse du Prometheus interne interrogé pour la consommation des volumes et les alertes (par défaut le service du namespace monitoring)
SPARK_JOB_GIT_IMAGE, SPARK_JOB_S3_IMAGE Images des initContainers qui récupèrent la source d'un job Spark (dépôt Git / objet S3) — à surcharger sur un cluster sans accès à Docker Hub
POSTGIS_DEFAULT_IMAGE Image PostgreSQL embarquant PostGIS, utilisée quand l'option PostGIS est cochée (doit correspondre à la version majeure de l'opérateur CNPG)
CUSTOM_PORT_AUTO_RANGE Plage (début-fin) dans laquelle un port est attribué automatiquement, notamment pour l'accès externe d'une base PostgreSQL — par défaut 30000-35000
CUSTOM_PORT_RESERVED_PORTS Ports refusés d'office à une exposition TCP, en plus des ports réellement portés par les Gateways — par défaut 80,443,222
POSTGRES_PUBLIC_TLS_SECRET Secret (namespace/nom) du certificat wildcard Let's Encrypt servi par les bases PostgreSQL exposées, par exemple default/pg-wildcard-tls : le client vérifie alors le serveur sans fichier de CA. Recopié dans chaque base exposée et resynchronisé chaque nuit. Vide ou none : certificat CNPG et fichier de CA à télécharger
POSTGRES_PUBLIC_DOMAIN Domaine couvert par ce wildcard (*.<domaine>) : les bases exposées s'appellent <nom-app>-<namespace>.<domaine> — par défaut pg.<domaine de la plateforme>

Valeurs sensibles

La valeur d'un paramètre est affichée en clair à quiconque a accès à son périmètre. N'y placez un secret que si le périmètre est approprié.

Utilisation

La liste se filtre par namespace et par type ; création, édition et suppression se font directement dans le tableau. Un paramètre créé en doublon (même namespace, type et nom) est refusé.