Les configurations Nacos vous permettent d'externaliser les paramètres de l'application, tels que les indicateurs de fonctionnalités, les pools de connexions et les niveaux de journalisation. Vous pouvez ainsi les mettre à jour lors de l'exécution sans redéployer le code. Chaque configuration est identifiée par une combinaison unique de Data ID, de Group et de Namespace.
Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
Un abonnement MSE activé (activate MSE)
Une instance MSE Nacos exécutant la version 1.2.1 ou ultérieure de Nacos (Create a Nacos engine)
Créer une configuration dans la console
Connectez-vous à la console MSE et sélectionnez une région dans la barre de navigation supérieure.
Dans le volet de navigation de gauche, sélectionnez Microservices Registry > Instances.
Sur la page Instances, cliquez sur le nom de l'instance.
Dans le volet de navigation de gauche, sélectionnez Configuration Management > Configurations.
Sur la page Configurations, sélectionnez un namespace dans la liste déroulante Namespace située dans le coin supérieur gauche, puis cliquez sur Add Configuration.
-
Dans le panneau Add Configuration, définissez les paramètres suivants, puis cliquez sur Release.
Parameter Required Description Region -- Rempli automatiquement à partir de l'instance Nacos actuelle. Ce paramètre ne peut pas être modifié. Namespace -- Rempli automatiquement à partir du namespace sélectionné à l'étape 5. Ce paramètre ne peut pas être modifié. Data ID Yes Identifiant unique de la configuration au sein de son groupe. Utilisez la convention de dénomination package.class, par exemplecom.foo.bar.log.level.Group Yes Regroupement logique des configurations associées. Utilisez un nom de produit ou de module, tel que order-serviceoupayment-module. Doit être unique.Data Encryption No Chiffre le contenu de la configuration afin de protéger les valeurs sensibles, telles que les identifiants de base de données. Lorsque cette option est activée, l'identifiant Data ID reçoit automatiquement le préfixe cipher-. Pour plus d'informations, consultez la rubrique Configure encryption.Configuration Format Yes Format des données : Properties, JSON, YAML, XML ou texte brut. Description No Brève note décrivant l'objet de cette configuration. More Settings > Application No Application utilisant cette configuration. More Settings > Configuration Tag No Tags permettant de filtrer et d'organiser les configurations. Saisissez un mot-clé et sélectionnez-le dans la liste déroulante. Configuration Content Yes Données de configuration, saisies dans le panneau de droite. Par exemple : threadPoolSize=5etlogLevel=WARN.
Après avoir cliqué sur Release, la configuration s'affiche sur la page Configurations.
Exemples de contenu de configuration
Paramètres d'application (format Properties)
# Database connection pool
db.pool.maxActive=20
db.pool.minIdle=5
db.pool.maxWait=60000
# Logging
log.level=WARN
log.path=/var/log/app
Indicateurs de fonctionnalités (format JSON)
{
"features": {
"new_checkout_flow": {
"enabled": true,
"rollout_percentage": 25
},
"dark_mode": {
"enabled": false
}
}
}
Configuration des endpoints de service (format YAML)
upstream:
payment-service:
url: https://pay.example.com/api/v2
timeout: 3000
retries: 3
inventory-service:
url: https://inv.example.com/api/v1
timeout: 5000
retries: 2
Limites
| Configuration type | Maximum size |
|---|---|
| Non-encrypted | 100 KB |
| Encrypted | 50 KB |
Si une configuration dépasse ces limites, divisez-la en plusieurs configurations plus petites. Pour demander un quota plus élevé, accédez au Quota Center.
La modification de la limite de taille du contenu peut affecter la stabilité de Nacos. Évaluez l'impact avant de demander un ajustement du quota.