Instantâneos
Um instantâneo é um subconjunto nomeado e imutável de um Configuração de Aplicativos valores-chave do repositório. Os valores-chave que compõem um instantâneo são escolhidos durante o tempo de criação por meio do uso de filtros de chave e rótulo. Depois que um instantâneo é criado, os valores-chave dentro 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ê.
Implantação segura com instantâneos
Os instantâneos foram projetados para implantar com segurança as alterações de configuração. Implantar alterações de configuração com falha 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 examinar as alterações de configuração antes de migrar para ambientes de produção. Se esse problema ocorrer, é importante reverter as alterações de configuração com falha para restaurar o serviço. Instantâneos são criados para gerenciar esses cenários.
As alterações de configuração devem ser implantadas de maneira controlada e consistente. Os desenvolvedores podem usar instantâneos para executar a distribuição controlada. A única alteração necessária em um aplicativo para iniciar uma distribuição controlada é atualizar o nome do instantâneo que o aplicativo está fazendo referência. À medida que o aplicativo passa para a produção, há uma garantia de que a configuração no instantâneo referenciado permaneça inalterada. Essa garantia contra qualquer alteração em um instantâneo protege contra configurações inesperadas que entram em produção. A imutabilidade e a facilidade de referência de instantâneos tornam simples garantir que o conjunto certo de alterações de configuração seja implementado com segurança.
Cenários para usar instantâneos
Distribuição controlada: os instantâneos são adequados para dar suporte à distribuição controlada devido à natureza imutável. Quando os desenvolvedores utilizam instantâneos para configuração, eles podem ter certeza de que a configuração permanece inalterada à medida que a versão progride em diferentes fases da distribuição.
Configuração de LKG (Last Known Good): os instantâneos podem ser usados para dar suporte a práticas de implantação seguras para Configuração. Com instantâneos, os desenvolvedores podem garantir que uma configuração LKG (Last Known Good) esteja disponível para reversão se houver algum problema durante a implantação.
Controle de versão de configuração: instantâneos podem ser usados para criar um histórico de versão das configurações a serem sincronizadas 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: instantâneos podem ser usados para fins de auditoria e conformidade. Os desenvolvedores podem manter um registro de alterações de configuração entre versões usando os instantâneos das versões.
Ambientes de teste e preparo: instantâneos podem ser usados para criar ambientes consistentes de teste e preparo. Os desenvolvedores podem garantir que a mesma configuração seja usada em ambientes diferentes usando o mesmo instantâneo, o que pode ajudar na depuração e teste.
Composição simplificada da Configuração do Cliente: geralmente, os clientes de Configuração de Aplicativos precisam de um subconjunto dos valores-chave da instância de Configuração de Aplicativos. Para obter o conjunto de valores-chave necessários, eles precisam ter a lógica de consulta escrita no código. Como os Instantâneos dão suporte ao fornecimento de filtros durante o tempo de criação, isso ajuda a simplificar a composição do cliente, pois os clientes agora podem se referir ao conjunto de valores-chave necessários pelo nome.
Operações de instantâneo
Como instantâneos são entidades imutáveis, os instantâneos só podem ser criados e arquivados. Nenhuma exclusão, limpeza ou edição é possível.
Criar instantâneo: 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 Aplicativos. Os valores-chave filtrados são armazenados como um instantâneo com o nome fornecido durante a criação.
Arquivar instantâneo: Arquivar um instantâneo o coloca em um estado arquivado. Enquanto um instantâneo é arquivado, ele ainda está 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 eliminar instantâneos que não estão mais em uso.
Recuperar instantâneo: recuperar 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.
Observação
O período de retenção só pode ser definido durante a criação de um instantâneo. O valor padrão para o período de retenção é 30 dias para repositórios Standard e 7 dias para repositórios gratuitos.
Requisitos para operações de instantâneo
As seções a seguir detalham as permissões necessárias para executar operações relacionadas a instantâneo com autenticação do Microsoft Entra ID e do HMAC.
Criar um instantâneo
Para criar um instantâneo em repositórios usando a autenticação do Microsoft Entra, as permissões a seguir são necessárias. A função proprietário de dados da Configuração de Aplicativos já tem essas permissões.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
Para criar um instantâneo usando a autenticação HMAC, uma chave de acesso de leitura/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 permissão a seguir é necessária. A função proprietário de dados 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/gravação deve ser usada.
Ler e listar instantâneos
Para listar todos os instantâneos ou obter todos os valores-chave em um instantâneo individual por nome, a permissão a seguir é 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 a autenticação HMAC, a operação "ler instantâneo" (para ler os valores-chave de um instantâneo) e a operação "listar instantâneos" podem ser executadas usando as chaves de acesso de leitura/gravação ou as chaves de acesso somente leitura.
Considerações e limites de cobrança
A Configuração de Aplicativos tem duas camadas, Gratuita e Standard. Verifique os detalhes a seguir para cotas de instantâneo em cada camada.
Camada gratuita: essa camada tem uma cota de armazenamento instantâneo de 10 MB. É possível criar o maior número possível de instantâneos, desde que o tamanho total de armazenamento de todos os instantâneos ativos e arquivados seja inferior a 10 MB.
Camada Standard: essa camada tem uma cota de armazenamento instantâneo de 1 GB. É possível criar o maior número possível de instantâneos, desde que o tamanho total de armazenamento de todos os instantâneos ativos e arquivados seja menor que 1 GB.
O tamanho máximo de um instantâneo é de 1 MB.