Instantâneos

Um instantâneo é um subconjunto nomeado e imutável dos pares chave-valor de um repositório de Configuração de Aplicativos. Os pares chave-valor que compõem um instantâneo são escolhidos no momento da criação por meio do uso de filtros de chave e rótulo. Depois que um instantâneo é criado, os pares chave-valor nele contidos têm a garantia de permanecer inalterados.

Uma breve visão geral está disponível neste vídeo, destacando três motivos pelos quais os instantâneos podem ser úteis para você.

Implantar com segurança usando instantâneos

Os instantâneos são projetados para implantar alterações de configuração com segurança. Implantar alterações de configuração com falhas em um ambiente em execução pode causar problemas, como interrupção do serviço e perda de dados. Para evitar esses problemas, é importante poder verificar as alterações de configuração antes de passar para ambientes de produção. Se ocorrer um problema, é importante poder reverter quaisquer alterações de configuração com falha para restaurar o serviço. Os instantâneos são criados para gerenciar esses cenários.

As alterações de configuração devem ser implantadas de forma controlada e consistente. Os desenvolvedores podem usar instantâneos para realizar uma distribuição controlada. A única alteração necessária em um aplicativo para iniciar uma distribuição controlada é atualizar o nome do instantâneo ao qual o aplicativo está se referindo. Conforme o aplicativo entra em produção, há uma garantia de que a configuração no instantâneo referenciado permanecerá inalterada. Essa garantia contra qualquer alteração em um instantâneo protege contra a introdução de configurações inesperadas na produção. A imutabilidade e a facilidade de referência dos instantâneos tornam simples garantir que o conjunto correto de alterações de configuração seja distribuído com segurança.

Cenários para uso de instantâneos

• Distribuição controlada: os instantâneos são adequados para dar suporte à distribuição controlada devido à sua natureza imutável. Quando os desenvolvedores usam instantâneos para configuração, eles podem ter certeza de que a configuração permanecerá inalterada à medida que a versão avança por diferentes fases da distribuição.

• Última Configuração Válida (LKG): instantâneos podem ser usados para dar suporte a práticas de implantação seguras de configuração. Com instantâneos, os desenvolvedores podem garantir que uma configuração LKG (Última Configuração Conhecida) esteja disponível para reversão se houver algum problema durante a implantação.

• Controle de versão de configuração: os instantâneos podem ser usados para criar um histórico de versão das configurações para sincronizar com versões de lançamento. As configurações capturadas em cada instantâneo podem ser comparadas para identificar alterações entre versões.

• Auditoria: Imagens instantâneas podem ser usadas para fins de auditoria e regulamentação. Os desenvolvedores podem manter um registro das alterações de configuração entre as versões usando os instantâneos das versões.

• Ambientes de teste e de preparo: instantâneos podem ser usados para criar ambientes de teste e de preparo consistentes. Os desenvolvedores podem garantir que a mesma configuração seja usada em diferentes ambientes, usando o mesmo instantâneo, o que pode ajudar na depuração e nos testes.

• Composição simplificada da Configuração do Cliente: geralmente, os clientes da Configuração de Aplicativos precisam de um subconjunto dos valores-chave da instância de Configuração de Aplicativo. Para obter o conjunto de pares chave-valor necessários, eles precisam ter a lógica de consulta escrita no código. Como os instantâneos dão suporte a filtros no momento da criação, eles ajudam a simplificar a composição do cliente, pois os clientes agora podem se referir ao conjunto de pares chave-valor necessários pelo nome.

Operações de instantâneo

Como os instantâneos são entidades imutáveis, eles só podem ser criados e arquivados. Não é possível excluir, limpar ou editar.

• Criar instantâneo: os instantâneos podem ser criados definindo os filtros de chave e rótulo para capturar os valores de chave necessários da instância de Configuração de Aplicativo. Os pares chave-valor filtrados são armazenados como um instantâneo com o nome fornecido durante a criação.

• Instantâneo de arquivo morto: arquivar um instantâneo o coloca em um estado arquivado. Enquanto um instantâneo estiver arquivado, ele continuará totalmente funcional. Quando o instantâneo é arquivado, um tempo de expiração é definido com base no período de retenção configurado durante a criação do instantâneo. Se o instantâneo permanecer no estado arquivado até o tempo de expiração, ele desaparecerá automaticamente do sistema quando o tempo de expiração passar. O arquivamento é usado para desativar instantâneos que não estão mais em uso.

• Recuperar instantâneo: a recuperação de um instantâneo o coloca de volta em um estado ativo. Nesse ponto, o instantâneo não está mais sujeito à expiração com base no período de retenção configurado. A recuperação só é possível no período de retenção após o arquivamento.

Requisitos para operações de instantâneo

As seções a seguir detalham as permissões necessárias para realizar operações relacionadas a instantâneos com autenticação do Microsoft Entra ID e HMAC.

Criar um instantâneo

Para criar um instantâneo em repositórios usando a autenticação do Microsoft Entra, são necessárias as seguintes permissões. A função Proprietário de Dados da Configuração de Aplicativos já tem essas permissões.

• Microsoft.AppConfiguration/configurationStores/keyvalues/read
• Microsoft.AppConfiguration/configurationStores/snapshots/write

Para criar um instantâneo usando a autenticação HMAC, uma chave de acesso de leitura e gravação deve ser usada.

Arquivar e recuperar um instantâneo

Para arquivar e/ou recuperar um instantâneo usando a autenticação do Microsoft Entra, a seguinte permissão é necessária. A função Proprietário de Dados da Configuração de Aplicativos já tem essa permissão.

• Microsoft.AppConfiguration/configurationStores/snapshots/archive/action

Para arquivar e/ou recuperar um instantâneo usando a autenticação HMAC, uma chave de acesso de leitura e gravação deve ser usada.

Ler e listar instantâneos

Para listar todos os instantâneos ou obter todos os pares chave-valor em um instantâneo individual pelo nome, a seguinte permissão é necessária para repositórios que utilizam a autenticação do Microsoft Entra. As funções internas Proprietário de Dados e Leitor de Dados já têm essa permissão.

• Microsoft.AppConfiguration/configurationStores/snapshots/read

Para repositórios que usam autenticação HMAC, tanto a operação "ler instantâneo" (para ler os pares chave-valor de um instantâneo) quanto a operação "listar instantâneos" podem ser realizadas usando as chaves de acesso de leitura e gravação ou as chaves de acesso somente leitura.

Considerações sobre cobrança e limites

A Configuração de Aplicativos tem quatro camadas: Gratuita, Desenvolvedor, Standard e Premium. A tabela a seguir faz um resumo das cotas de armazenamento de instantâneos para cada camada.

Você pode criar quantos instantâneos forem necessários, desde que o tamanho total do armazenamento de todos os instantâneos ativos e arquivados não exceda a cota da sua camada. O tamanho máximo para um instantâneo individual é de 1 MB.

Próximas etapas