Instantâneos
Um instantâneo é um subconjunto nomeado e imutável dos valores-chave de uma loja de Configuração de Aplicativos. Os valores-chave que compõem um instantâneo são escolhidos durante o tempo de criação através do uso de filtros de chave e rótulo. Depois que um snapshot é 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 razões pelas quais os instantâneos podem ser úteis para você.
Implante com segurança com snapshots
Os snapshots são projetados para implantar alterações de configuração com segurança. A implantação de alterações de configuração defeituosas em um ambiente em execução pode causar problemas como interrupção do serviço e perda de dados. Para evitar esses problemas, é importante ser capaz de examinar as alterações de configuração antes de passar para ambientes de produção. Se esse problema ocorrer, é importante ser capaz de reverter quaisquer alterações de configuração defeituosas 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 snapshots 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 ao qual o aplicativo está se referindo. À medida que o aplicativo entra em produção, há uma garantia de que a configuração no instantâneo referenciado permanece inalterada. Essa garantia contra qualquer alteração em um snapshot protege contra configurações inesperadas que entram em produção. A imutabilidade e a facilidade de referência dos snapshots simplificam a garantia de que o conjunto certo de alterações de configuração seja implementado com segurança.
Cenários para o uso de snapshots
Distribuição controlada: os snapshots são adequados para suportar a distribuição controlada devido à sua natureza imutável. Quando os desenvolvedores utilizam snapshots para configuração, eles podem ter certeza de que a configuração permanece inalterada à medida que a versão progride através de diferentes fases da implantação.
Configuração do Last Known Good (LKG): os snapshots podem ser usados para dar suporte a práticas de implantação seguras para Configuração. Com snapshots, os desenvolvedores podem garantir que uma configuração do Last known Good (LKG) 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ões de definições de configuração para sincronizar com as versões de lançamento. As configurações capturadas em cada instantâneo podem ser comparadas para identificar alterações entre versões.
Auditoria: os snapshots podem ser usados para fins de auditoria e conformidade. 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 preparação: os snapshots podem ser usados para criar ambientes de teste e preparo consistentes. 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 no teste.
Composição simplificada da Configuração do Cliente: Normalmente, os clientes da Configuração do Aplicativo precisam de um subconjunto dos valores-chave da instância de Configuração do Aplicativo. Para obter o conjunto de valores-chave necessários, eles precisam ter a lógica de consulta escrita em código. Como os Snapshots suportam o 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 que exigem por nome.
Operações de snapshot
Como os snapshots são entidades imutáveis, os snapshots só podem ser criados e arquivados. Nenhuma exclusão, limpeza ou edição é possível.
Criar instantâneo: os instantâneos podem ser criados definindo os filtros de chave e rótulo para capturar os valores-chave necessários da instância de Configuração do Aplicativo. 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. Embora um snapshot seja arquivado, ele ainda é totalmente funcional. Quando o snapshot é arquivado, um tempo de expiração é definido com base no período de retenção configurado durante a criação do snapshot. Se o snapshot 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 gradualmente instantâneos que não estão mais em uso.
Recuperar snapshot: a recuperação de um snapshot o coloca de volta em um estado ativo. Neste ponto, o snapshot não está mais sujeito à expiração com base em seu período de retenção configurado. A recuperação só é possível no período de retenção após o arquivamento.
Nota
O período de retenção só pode ser definido durante a criação de um snapshot. O valor padrão para o período de retenção é de 30 dias para lojas Standard e 7 dias para lojas Free.
Requisitos para operações de snapshot
As seções a seguir detalham as permissões necessárias para executar operações relacionadas a instantâneos com a ID do Microsoft Entra e a autenticação HMAC.
Criar um instantâneo
Para criar um instantâneo em lojas usando a autenticação do Microsoft Entra, as seguintes permissões são necessárias. A função Proprietário de Dados de Configuração do Aplicativo 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 snapshot
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 de Configuração do Aplicativo já tem essa permissão.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
Para arquivar e/ou recuperar um snapshot 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 pelo nome, a seguinte permissão é necessária para armazenamentos que utilizam a autenticação do Microsoft Entra. As funções internas de Proprietário de Dados e Leitor de Dados já têm essa permissão.
Microsoft.AppConfiguration/configurationStores/snapshots/read
Para armazenamentos que usam 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 faturamento
A Configuração do Aplicativo tem três níveis, Gratuito, Standard e Premium. Verifique os detalhes a seguir para cotas de instantâneo em cada camada.
Nível gratuito: esse nível tem uma cota de armazenamento de snapshot de 10 MB. Pode-se criar o maior número possível de snapshots, desde que o tamanho total de armazenamento de todos os snapshots ativos e arquivados seja inferior a 10 MB.
Nível padrão: esse nível tem uma cota de armazenamento de snapshot de 1 GB. Pode-se criar o maior número possível de snapshots, desde que o tamanho total de armazenamento de todos os snapshots ativos e arquivados seja inferior a 1 GB.
Nível Premium: esse nível tem uma cota de armazenamento de snapshot de 4 GB. Pode-se criar o maior número possível de snapshots, desde que o tamanho total de armazenamento de todos os snapshots ativos e arquivados seja inferior a 4 GB.
O tamanho máximo de um snapshot é de 1 MB.