As configurações do Nacos permitem externalizar definições da aplicação — como feature flags, pools de conexão e níveis de log — para atualização em tempo de execução sem reimplantação de código. Cada configuração é identificada por uma combinação única de Data ID, Group e Namespace.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma assinatura do MSE ativada (ativar o MSE)
Uma instância do MSE Nacos com a versão 1.2.1 ou posterior (Crie um mecanismo Nacos)
Crie uma configuração no console
Faça login no console do MSE e selecione uma região na barra de navegação superior.
No painel de navegação à esquerda, escolha Microservices Registry > Instances.
Na página Instances, clique em nome da instância.
No painel de navegação à esquerda, escolha Configuration Management > Configurations.
Na página Configurations, selecione um namespace na lista suspensa Namespace no canto superior esquerdo e clique em Add Configuration.
-
No painel Add Configuration, defina os parâmetros a seguir e clique em Release.
Parâmetro
Obrigatório
Descrição
Region
--
Preenchido automaticamente com base na instância atual do Nacos. Não pode ser alterado.
Namespace
--
Preenchido automaticamente com base no namespace selecionado na etapa 5. Não pode ser alterado.
Data ID
Sim
Identificador exclusivo da configuração dentro do grupo. Use a convenção de nomenclatura
package.class, comocom.foo.bar.log.level.Group
Sim
Agrupamento lógico para configurações relacionadas. Use o nome de um produto ou módulo, como
order-serviceoupayment-module. Deve ser exclusivo.Data Encryption
Não
Criptografa o conteúdo da configuração para proteger valores sensíveis, como credenciais de banco de dados. Quando ativado, o Data ID recebe automaticamente o prefixo
cipher-. Para mais informações, consulte Configure criptografia.Configuration Format
Sim
Formato dos dados: Properties, JSON, YAML, XML ou texto simples.
Description
Não
Breve observação sobre a finalidade desta configuração.
More Settings > Application
Não
Aplicação que usa esta configuração.
More Settings > Configuration Tag
Não
Tags para filtrar e organizar configurações. Digite uma palavra-chave e selecione-a na lista suspensa.
Configuration Content
Sim
Dados da configuração inseridos no painel à direita. Exemplo:
threadPoolSize=5elogLevel=WARN.
Após clicar em Release, a configuração aparecerá na página Configurations.
Exemplos de conteúdo de configuração
Definições da aplicação (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
Feature flags (formato JSON)
{
"features": {
"new_checkout_flow": {
"enabled": true,
"rollout_percentage": 25
},
"dark_mode": {
"enabled": false
}
}
}
Configuração de endpoint de serviço (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
Limites
|
Tipo de configuração |
Tamanho máximo |
|
Não criptografada |
100 KB |
|
Criptografada |
50 KB |
Se uma configuração exceder esses limites, divida-a em várias configurações menores. Para solicitar uma cota maior, acesse o Quota Center.
Alterar o limite de tamanho do conteúdo pode afetar a estabilidade do Nacos. Avalie o impacto antes de solicitar um ajuste de cota.