Las configuraciones de Nacos permiten externalizar los ajustes de la aplicación, como indicadores de funciones, pools de conexiones y niveles de registro, para que sea posible actualizarlos en tiempo de ejecución sin volver a desplegar el código. Cada configuración se identifica mediante una combinación única de Data ID, Group y Namespace.
Requisitos previos
Antes de empezar, asegúrese de contar con lo siguiente:
Una suscripción de MSE activada (activar MSE)
Una instancia de MSE Nacos que ejecute Nacos 1.2.1 o posterior (Create a Nacos engine)
Cree una configuración en la consola
Inicie sesión en la consola de MSE y seleccione una región en la barra de navegación superior.
En el panel de navegación izquierdo, elija Microservices Registry > Instances.
En la página Instances, haga clic en el nombre de la instancia.
En el panel de navegación izquierdo, elija Configuration Management > Configurations.
En la página Configurations, seleccione un namespace en la lista desplegable Namespace de la esquina superior izquierda y luego haga clic en Add Configuration.
-
En el panel Add Configuration, establezca los siguientes parámetros y haga clic en Release.
Parámetro
Obligatorio
Descripción
Region
--
Se completa automáticamente a partir de la instancia actual de Nacos. No se puede modificar.
Namespace
--
Se completa automáticamente a partir del namespace seleccionado en el paso 5. No se puede modificar.
Data ID
Sí
Identificador único de la configuración dentro de su grupo. Utilice la convención de nomenclatura
package.class, por ejemplo,com.foo.bar.log.level.Group
Sí
Agrupación lógica para configuraciones relacionadas. Utilice el nombre de un producto o módulo, como
order-serviceopayment-module. Debe ser único.Data Encryption
No
Cifra el contenido de la configuración para proteger valores sensibles, como las credenciales de bases de datos. Cuando está habilitado, se añade automáticamente el prefijo
cipher-al Data ID. Para obtener más información, consulte Configure encryption.Configuration Format
Sí
Formato de los datos: Properties, JSON, YAML, XML o texto sin formato.
Description
No
Nota breve que describe la finalidad de esta configuración.
More Settings > Application
No
Aplicación que utiliza esta configuración.
More Settings > Configuration Tag
No
Etiquetas para filtrar y organizar configuraciones. Escriba una palabra clave y selecciónela en la lista desplegable.
Configuration Content
Sí
Datos de la configuración, introducidos en el panel derecho. Por ejemplo:
threadPoolSize=5ylogLevel=WARN.
Después de hacer clic en Release, la configuración aparece en la página Configurations.
Ejemplos de contenido de configuración
Ajustes de la aplicación (formato 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
Indicadores de funciones (formato JSON)
{
"features": {
"new_checkout_flow": {
"enabled": true,
"rollout_percentage": 25
},
"dark_mode": {
"enabled": false
}
}
}
Configuración de endpoints de servicio (formato 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
Límites
|
Tipo de configuración |
Tamaño máximo |
|
Sin cifrado |
100 KB |
|
Cifrada |
50 KB |
Si una configuración supera estos límites, divídala en varias configuraciones más pequeñas. Para solicitar una cuota mayor, vaya al Centro de cuotas.
Modificar el límite de tamaño del contenido puede afectar la estabilidad de Nacos. Evalúe el impacto antes de solicitar un ajuste de cuota.