Tous les produits
Search
Centre de documentation

Microservices Engine:Create a configuration

Dernière mise à jour :Aug 11, 2026

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 :

Créer une configuration dans la console

  1. Connectez-vous à la console MSE et sélectionnez une région dans la barre de navigation supérieure.

  2. Dans le volet de navigation de gauche, sélectionnez Microservices Registry > Instances.

  3. Sur la page Instances, cliquez sur le nom de l'instance.

  4. Dans le volet de navigation de gauche, sélectionnez Configuration Management > Configurations.

  5. 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.

  6. 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 exemple com.foo.bar.log.level.
    Group Yes Regroupement logique des configurations associées. Utilisez un nom de produit ou de module, tel que order-service ou payment-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=5 et logLevel=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.

Important

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.