Todos os produtos
Search
Central de documentação

Microservices Engine:Criar uma configuração

Última atualização: Jun 28, 2026

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:

Crie uma configuração no console

  1. Faça login no console do MSE e selecione uma região na barra de navegação superior.

  2. No painel de navegação à esquerda, escolha Microservices Registry > Instances.

  3. Na página Instances, clique em nome da instância.

  4. No painel de navegação à esquerda, escolha Configuration Management > Configurations.

  5. Na página Configurations, selecione um namespace na lista suspensa Namespace no canto superior esquerdo e clique em Add Configuration.

  6. 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, como com.foo.bar.log.level.

    Group

    Sim

    Agrupamento lógico para configurações relacionadas. Use o nome de um produto ou módulo, como order-service ou payment-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=5 e logLevel=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.

Importante

Alterar o limite de tamanho do conteúdo pode afetar a estabilidade do Nacos. Avalie o impacto antes de solicitar um ajuste de cota.