Todos os produtos
Search
Central de documentação

Serverless App Engine:Gerenciar configurações distribuídas (ACM)

Última atualização: Jul 20, 2026

O Serverless App Engine (SAE) integra-se ao Application Configuration Management (ACM), permitindo que suas aplicações busquem configurações dinamicamente de uma source central. O ACM oferece suporte a atualizações dinâmicas, separação de ambientes, controle de versão, criptografia de dados e controle granular de permissões.

O service ACM independente não está mais disponível, mas o service ACM integrado ao SAE continua funcional. Para garantir maior segurança e estabilidade, recomendamos que você migrate from ACM to MSE Nacos e, em seguida, use the MSE Nacos registry.

Este tópico não aborda os itens de configuração do ambiente de execução do contêiner. Para essas informações, consulte Manage and use configuration items (K8s ConfigMap).

Criar uma configuração

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados. Em seguida, clique em Configuration List e Create Configuration. Para garantir que sua aplicação possa buscar a configuração, você também deve integrate Application Configuration Management (ACM) into your application.

Parâmetros

Parâmetro

Descrição

Data ID

ID da configuração. Utilize uma convenção de nomenclatura semelhante a package.class (por exemplo, com.taobao.tc.refund.log.level) para garantir unicidade global. Defina a parte class com base na finalidade do negócio.

Group

Grupo da configuração. Use o nome do product ou módulo. O nome do grupo deve ser globalmente único.

Data Encryption

Define se os dados da configuração serão criptografados. Ative este recurso caso sua configuração contenha dados sensíveis, reduzindo assim o risco de vazamento de informações.

Importante

O recurso de criptografia de dados no ACM depende do Key Management Service (KMS). Antes de utilizar esse recurso, ative o KMS e conceda permissão ao ACM para usá-lo nas operações de criptografia e descriptografia. O Data ID de uma configuração criptografada deve começar com cipher-. Para mais informações, consulte Create an encrypted configuration.

Configuration Format

Selecione um formato de configuração. O SAE valida os dados conforme sua escolha. O formato padrão é TEXT.

Configuration Content

Insira o conteúdo da configuração. Recomenda-se um tamanho de até 10 KB, sendo o limite máximo de 100 KB.

Description

Descrição da configuração.

More Configurations

applications,

Aplicação à qual a configuração pertence.

Tag

Tags da configuração. Utilize tags para organizar as configurações por dimensão. É possível adicionar até cinco tags, cada uma com no máximo 64 caracteres.

Integrar o ACM à sua aplicação

No console do SAE Application Configuration Management (ACM), selecione uma região e um namespace. Clique em Configuration List e, em seguida, clique em um Data ID para abrir a página de detalhes da configuração.Clique na aba Sample Code e selecione sua stack tecnológica.

Consulte o código de exemplo para integrar o ACM à sua aplicação. Para mais informações, veja a documentação do SDK do ACM.

Visualizar o conteúdo da configuração

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Clique em Configuration List e, em seguida, clique em um Data ID para acessar a página de detalhes da configuração.Clique na aba Configuration Content.

Exportar configurações

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Na página Configuration List, selecione uma ou mais configurações e clique em Export na parte inferior da página. Na caixa de diálogo exibida, clique em Export. As configurações são exportadas como um pacote ZIP.

Importar uma configuração

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Na página Configuration List, clique em Import Configuration e, em seguida, clique em Upload File. O arquivo importado deve ser um pacote ZIP.

Visualizar e reverter versões históricas

É possível visualizar versões históricas de uma configuração e reverter para uma versão anterior caso uma atualização cause erros.

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Clique em Configuration List e, em seguida, clique em um Data ID para acessar a página de detalhes da configuração.Clique na aba Historical Versions. Na coluna Actions, clique em View ou Rollback para uma versão específica.

Consultar o status de push

Verifique se uma configuração foi enviada para as aplicações que a escutam.

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Clique em Configuration List e, em seguida, clique em um Data ID para acessar a página de detalhes da configuração.Clique na aba Listener Query para filtrar e consultar o push status.

Consultar o rastreamento de push

Consulte o rastreamento de push de uma configuração para solucionar problemas, como falhas no envio.

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Clique em Configuration List e, em seguida, clique em um Data ID para acessar a página de detalhes da configuração.Clique na aba Push Track para filtrar e consultar o push track.

Criar uma configuração criptografada

Configurações criptografadas protegem informações sensíveis, como sources de dados, tokens, nomes de usuário e senhas, reduzindo o risco de vazamento de dados.

Pré-requisitos

  1. Purchase a dedicated KMS instance.

  2. Conceda permissão ao ACM para usar o Key Management Service (KMS).

  3. Grant permissions to a RAM user: AliyunACMFullAccess e AliyunKMSCryptoAdminAccess.

  4. Create an AccessKey for a RAM user e, em seguida, realize as operações como o usuário RAM. Apenas AccessKeys de usuários RAM são suportados. AccessKeys específicos do ACM não são suportados.

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior e clique em Configuration List. Clique em Create Configuration. Ative a opção Data Encryption e selecione um método de criptografia.

Parâmetros

Parâmetro

Descrição

Método de criptografia

  • KMS AES-128 (Recomendado): Utiliza criptografia de envelope do KMS. O tamanho máximo dos dados é de 100 KB. Os dados em texto simples não são transmitidos ao sistema KMS, oferecendo maior segurança.

  • KMS: Chama diretamente o KMS para criptografar a configuração. Recomenda-se um tamanho de dados de até 4 KB, com limite máximo de 6 KB. Este método pode falhar ao descriptografar caracteres especiais como &, portanto não é recomendado.

Integrar uma configuração criptografada

No console do SAE Application Configuration Management (ACM), selecione a região e o namespace desejados na barra de navegação superior. Clique em Configuration List e, em seguida, clique em um Data ID para acessar a página de detalhes da configuração.Clique na aba Sample Code e selecione sua stack tecnológica.

Configure o AccessKey/SecretKey de um usuário RAM na sua aplicação para descriptografar os dados. Os SDKs Java e Python já integram o SDK do KMS, permitindo adicionar um filtro de descriptografia para decodificação automática. Para descriptografia em outras linguagens, consulte Decrypt.