Importar ou exportar dados de configuração

A Configuração de Aplicativos do Azure oferece suporte a operações de importação e exportação de dados. Use essas operações para trabalhar com dados de configuração em massa e trocar dados entre seu repositório de Configuração de Aplicativos do Azure e o projeto de código. Por exemplo, é possível configurar um repositório de Configuração de Aplicativos para teste e outro para produção. Você pode copiar as configurações do aplicativo entre eles para não precisar inserir dados duas vezes.

Esse artigo fornece um guia para importar e exportar dados usando o portal do Azure ou o CLI do Azure. Se você adotou a Configuração como Código e gerencia suas configurações no GitHub ou no Azure DevOps, você pode configurar a importação contínua do arquivo de configuração usando GitHub Actions ou usar a Tarefa de Importação do Pipeline do Azure.

Importar dados

A importação traz dados de configuração para um repositório de Configuração de Aplicativos do Azure a partir de uma fonte existente. Use a função de importação para migrar dados para um repositório de Configuração de Aplicativos do Azure ou agregar dados de várias fontes.

Esse guia mostra como importar dados de Configuração de Aplicativos do Azure:

• de um arquivo de configuração em JSON, YAML ou Propriedades
• de uma loja de Configuração de Aplicativos do Azure
• do Serviço de Aplicativo do Azure
• a partir do ConfigMaps do Serviço de Kubernetes do Azure

Importar dados de um arquivo de configuração

Siga as etapas abaixo para importar valores-chave de um arquivo.

Portal

No portal do Azure, siga essas etapas:

1. Navegue até o armazenamento de Configuração de Aplicativos do Azure e selecione Importar/exportar no menu Operações.

   

2. O botão de opção Importar é selecionado por padrão. Em Tipo de fonte, selecione Arquivo de Configuração.

3. Preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Tipo de arquivo	Selecione o tipo de arquivo para importação: YAML, Propriedades ou JSON.	JSON

4. Clique no botão Procurar e selecione o arquivo a ser importado.

5. Preencha a próxima parte do formulário:

   Parâmetro	Descrição	Exemplo
   Perfil de conteúdo do arquivo	Selecione um perfil de conteúdo: Padrão ou KVSet. O perfil de conteúdo de arquivo Padrão refere-se ao esquema de arquivo de configuração convencional amplamente adotado por estruturas ou sistemas de programação existentes, suportando formatos de arquivo JSON, YAML ou Propriedades. O perfil de conteúdo do arquivo KVSet refere-se a um esquema de arquivo que contém todas as propriedades de uma chave-valor de Configuração de Aplicativos do Azure, incluindo chave, valor, rótulo, tipo de conteúdo e marcas.	Default
   Modo de importação	O modo de importação é usado para determinar se pares chave-valor idênticos devem ser ignorados. Com a opção Ignorar correspondência, todos os pares chave-valor no repositório que são iguais aos do arquivo de configuração são ignorados. Com a opção Todos, todos os pares chave-valor no arquivo de configuração são atualizados.	Ignorar correspondência
   Excluir sinalizador de recurso	Se marcada, os sinalizadores de recursos não serão importados.	Desmarcado
   Rigoroso	Se a caixa estiver marcada, quaisquer valores-chave no repositório com o prefixo e rótulo especificados que não estejam incluídos no arquivo de configuração serão excluídos quando o perfil de conteúdo do arquivo for definido como Padrão. Quando o perfil de conteúdo de arquivo é definido como KVSet, todos os pares chave-valor no repositório que não estão incluídos no arquivo de configuração são excluídos. Se a caixa estiver desmarcada, nenhum valor-chave no armazenamento será excluído.	Desmarcado
   Separador	O separador é o delimitador usado para compactar arquivos JSON ou YAML em chave-valor. Ele será ignorado para arquivos de propriedade e sinalizadores de recursos. Os valores suportados incluem sem separador, ponto final (.), vírgula (,), ponto e vírgula (;), hífen (-), sublinhado (_), sublinhado duplo (__), barra (/) e dois pontos (:).	:
   Profundidade	Opcional. A profundidade para achatar arquivos JSON ou YAML em pares chave-valor. Por padrão, os arquivos serão nivelados no nível mais profundo se um separador for selecionado. Essa configuração não é aplicável a arquivos de propriedade ou sinalizadores de recursos.
   Adicionar prefixo	Opcional. Se especificado, um prefixo será adicionado aos nomes de chaves de todos os valores de chaves importados.	TestApp:
   Adicionar rótulo	Opcional. Se especificado, o rótulo fornecido será atribuído a todos os valores-chave importados.	prod
   Adicionar tipo de conteúdo	Opcional. Se especificado, o tipo de conteúdo fornecido será adicionado a todos os valores-chave importados.	JSON (aplicação/json)
   Adicionar tags	Opcional. Se especificado, as marcas fornecidas serão adicionadas a todos os valores-chave importados.	{tag: tag1}

6. Selecione Aplicar para prosseguir com a importação.

Você importou com sucesso valores-chave de um arquivo JSON. Os nomes de chave foram nivelados usando o separador : e tiveram o prefixo TestApp: adicionado. Todos os valores-chave importados são rotulados como prod, com um tipo de conteúdo de application/json e marcados comtag: tag1.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando importação az appconfig kv import e adicione os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Digite o nome do armazenamento de Configuração de Aplicativos do Azure para o qual você deseja importar dados.	my-app-config-store
   --source	Insira file para indicar que você está importando dados de configuração do aplicativo de um arquivo.	file
   --path	Digite o caminho local para o arquivo que contém os dados que você deseja importar.	C:/Users/john/Downloads/data.json
   --format	Digite yaml, properties ou json para indicar o formato do arquivo que você está importando.	json

2. Opcionalmente, adicione também os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --separator	Opcional. O separador é o delimitador para simplificar os valores-chave para JSON/YAML. É necessário para exportar a estrutura hierárquica e será ignorado para arquivos de propriedades e sinalizadores de recursos. Selecione uma das seguintes opções: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opcional. Um prefixo de chave é a parte inicial de uma chave. Prefixos podem ser usados ​​para gerenciar grupos de valores-chave em um armazenamento de configuração. Esse prefixo será anexado à frente da propriedade "chave" de cada valor-chave importado.	TestApp:
   --label	Opcional. Insira um rótulo que será atribuído aos seus valores-chave importados.	prod
   --content-type	Opcional. Insira appconfig/kvset ou application/json para indicar que o conteúdo importado consiste em uma referência do Key Vault ou um arquivo JSON.	application/json

   Exemplo: importe todos os valores-chave e sinalizadores de recursos de um arquivo JSON, aplique o rótulo "prod" e anexe o prefixo "TestApp". Adicione o tipo de conteúdo "application/json".

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. A linha de comando exibe uma lista das próximas alterações. Confirme a importação selecionando y.

   

Você importou valores-chave de um arquivo JSON e atribuiu a eles o rótulo "prod" e o prefixo "TestApp:". O separador ";" é usado e todos os valores-chave que você importou têm o tipo de conteúdo definido como "JSON".

Para mais parâmetros e exemplos opcionais, acesse az appconfig kv importação.

Importar dados de um armazenamento de Configuração de Aplicativos

É possível importar valores de um repositório de Configuração de Aplicativos para outro ou importar valores de um repositório de Configuração de Aplicativos para o mesmo repositório a fim de duplicar os valores e aplicar parâmetros diferentes, como um novo rótulo ou tipo de conteúdo.

Siga as etapas abaixo para importar chaves-valor e sinalizadores de recursos de um repositório de Configuração de Aplicativos do Azure.

Portal

No portal do Azure, siga essas etapas:

1. Navegue até o armazenamento de Configuração de Aplicativos do Azure e selecione Importar/exportar no menu Operações.

   

2. O botão de opção Importar é selecionado por padrão. Em Tipo de fonte, selecione Configuração do Aplicativos.

3. Selecione uma loja de Configuração de Aplicativos do Azure para importar dados e preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Subscrição	Sua assinatura atual é selecionada por padrão.	my-subscription
   Grupo de recursos	Selecione um grupo de recursos que contenha o repositório de Configuração de Aplicativos do Azure com a configuração a ser importada. Seu grupo de recursos atual é selecionado por padrão.	my-resource-group
   Recurso	Selecione o armazenamento de Configuração de Aplicativos do Azure que contém a configuração que você deseja importar.	my-other-app-config-store

4. Preencha a próxima parte do formulário:

   Parâmetro	Descrição	Exemplo
   Modo de seleção	Selecione se deseja importar de valores-chave regulares, que é a opção padrão, ou de um instantâneo.	Default
   Filtro de chave	Usado para filtrar pares chave-valor com base no nome da chave para importação. Se nenhuma chave for especificada, todas as chaves são qualificadas.	Começa com test
   Em um momento específico	Opcional. Preencha esse campo para importar valores-chave de um momento específico no armazenamento de configuração selecionado. Se deixado em branco, o padrão será o ponto atual no tempo dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione um ou mais rótulos para importar valores-chave associados a esses rótulos. Se nenhum rótulo for selecionado, todos os rótulos serão elegíveis.	prod
   Excluir sinalizador de recurso	Se marcada, os sinalizadores de recursos não serão importados.	Desmarcado
   Adicionar prefixo	Opcional. Se especificado, um prefixo será adicionado aos nomes de chaves de todos os valores de chaves importados.	TestApp:
   Substituir rótulos	Opcional. Por padrão, os rótulos originais dos pares chave-valor de origem são preservados. Para substituí-los, marque a caixa e insira um novo rótulo para os valores-chave importados.	novo
   Substituir tipos de conteúdo	Opcional. Por padrão, os tipos de conteúdo originais dos pares chave-valor de origem são preservados. Para substituí-los, marque a caixa e insira um novo tipo de conteúdo para os pares chave-valor importados. Observe que o tipo de conteúdo dos sinalizadores de recursos não pode ser substituído.	JSON (aplicação/json)

5. Selecione Aplicar para prosseguir com a importação.

Você importou valores-chave de um repositório de Configuração de Aplicativos do Azure em 28 de janeiro de 2021, às 12h, com nomes de chaves começando com test e o rótuloprod. Os nomes de chave receberam o prefixo TestApp:. Todos os valores-chave importados receberam o rótulo newe o tipo de conteúdo application/json.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando importação az appconfig kv import e informe os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Digite o nome do armazenamento de Configuração de Aplicativos do Azure para o qual deseja importar dados	my-app-config-store
   --source	Insira appconfig para indicar que você está importando os dados de um repositório de Configuração de Aplicativos.	appconfig
   --src-name	Digite o nome do armazenamento de Configuração de Aplicativos do Azure do qual você deseja importar dados.	my-source-app-config
   --src-label	Restrinja sua importação a valores-chave com um rótulo específico. Se você não usar esse parâmetro, somente valores-chave com rótulo nulo serão importados. Suporta sinal de estrela como filtro: insira * para todos os rótulos; abc* para todos os rótulos com abc como prefixo.	prod

2. Opcionalmente, adicione os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --label	Opcional. Insira um rótulo que será atribuído aos seus valores-chave importados.	new
   --content-type	Opcional. Insira appconfig/kvset ou application/json para indicar que o conteúdo importado consiste em uma referência do Key Vault ou um arquivo JSON. O tipo de conteúdo somente pode ser substituído por valores de chave importados. O tipo de conteúdo padrão para sinalizadores de recursos é "application/vnd.microsoft.appconfig.ff+json;charset=utf-8" por padrão e não é atualizado por esse parâmetro.	application/json

   Exemplo: importe valores-chave e sinalizadores de recursos com o rótulo "prod" de outra Configuração de Aplicativos do Azure e atribua a eles o rótulo "novo". Adicione o tipo de conteúdo "application/json".

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. A linha de comando exibe uma lista das próximas alterações. Confirme a importação selecionando y.

   

Você importou valores-chave com o rótulo "prod" de um repositório de Configuração de Aplicativos do Azure e atribuiu a eles o rótulo "novo". Todos os valores-chave que você importou têm o tipo de conteúdo definido como "JSON".

Para mais parâmetros e exemplos opcionais, acesse az appconfig kv importação.

Importar dados do Serviço de Aplicativo do Azure

Siga as etapas abaixo para importar valores-chave do Serviço de Aplicativo do Azure.

Observação

Atualmente, o Serviço de Aplicativo do Azure não oferece suporte a sinalizadores de recursos. Todos os sinalizadores de recursos importados para o Serviço de Aplicativo são convertidos automaticamente em valores de chave. Os recursos do Serviço de Aplicativo do Azure podem conter somente valores-chave.

Portal

No portal do Azure:

1. Navegue até o armazenamento de Configuração de Aplicativos do Azure e selecione Importar/exportar no menu Operações.

   

2. O botão de opção Importar é selecionado por padrão. Em Tipo de fonte, selecione Serviços de Aplicativos.

3. Selecione uma loja de Configuração de Aplicativos do Azure para importar dados e preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Subscrição	Sua assinatura atual é selecionada por padrão.	my-subscription
   Grupo de recursos	Selecione um grupo de recursos que contenha o Serviço de Aplicativo com configuração para importar.	my-resource-group
   Recurso	Selecione o Serviço de Aplicativo que contém a configuração que você deseja importar.	my-app-service

4. Preencha a próxima parte do formulário:

   Parâmetro	Descrição	Exemplo
   Atualizar configurações para referência	Se marcadas, as configurações do aplicativo no Serviço de Aplicativo serão atualizadas para referências da Configuração de Aplicativo para os pares chave-valor importados. Isso permite que você gerencie as configurações do aplicativo na Configuração de Aplicativos daqui para frente. O Serviço de Aplicativo extrairá automaticamente o valor atual da Configuração de Aplicativos. Para saber mais, veja Usar referências de configuração de aplicativo para o App Service e as Azure Functions.	Verificado
   Adicionar prefixo	Opcional. Se especificado, um prefixo será adicionado aos nomes de chaves de todos os valores de chaves importados.	TestApp:
   Adicionar rótulo	Opcional. Se especificado, o rótulo fornecido será atribuído a todos os valores-chave importados.	prod
   Adicionar tipo de conteúdo	Opcional. Se especificado, o tipo de conteúdo fornecido será adicionado a todos os valores-chave importados.	JSON (aplicação/json)

5. Selecione Aplicar para prosseguir com a importação.

Você importou todas as Configuração de Aplicativos do Azure de um Serviço de Aplicativo como valores-chave e atribuiu a elas o rótulo prod e o prefixo TestApp:. Todos os valores-chave que você importou têm o tipo de conteúdo definido como application/json.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando importação az appconfig kv import e adicione os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Digite o nome do armazenamento de Configuração de Aplicativos do Azure para o qual você deseja importar dados.	my-app-config-store
   --source	Insira appservice para indicar que você está importando os dados de configuração de aplicativo do Serviço de Aplicativo do Azure.	appservice
   --appservice-account	Insira o ID do ARM do Serviço de Aplicativo ou use o nome do Serviço de Aplicativo, se estiver na mesma assinatura e grupo de recursos que a Configuração de Aplicativos do Azure.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service ou my-app-service

2. Opcionalmente, adicione também os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --prefix	Opcional. Um prefixo de chave é a parte inicial da propriedade "chave" de um valor-chave. Prefixos podem ser usados ​​para gerenciar grupos de valores-chave em um armazenamento de configuração. Esse prefixo será anexado à frente da propriedade "chave" de cada valor-chave importado.	TestApp:
   --label	Opcional. Insira um rótulo que será atribuído aos seus valores-chave importados. Se você não especificar um rótulo, o rótulo nulo será atribuído aos seus valores-chave.	prod
   --content-type	Opcional. Digite appconfig/kvset ou application/json para declarar que o conteúdo importado consiste em uma referência do Key Vault ou um arquivo JSON.	application/json

   Para obter o valor para --appservice-account, use o comando az webapp show --resource-group <resource-group> --name <resource-name>.

   Exemplo: importar todas as configurações de aplicativo do Serviço de Aplicativo como os valores de chave com o rótulo "prod", para o repositório de Configuração de Aplicativos e adicionar um prefixo "TestApp:".

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. A linha de comando exibe uma lista das próximas alterações. Confirme a importação selecionando y.

   

Você importou todas as configurações do aplicativo do seu Serviço de Aplicativo do Azure como valores-chave, atribuiu a elas o rótulo "prod" e adicionou um prefixo "TestApp:". Todos os valores-chave que você importou têm o tipo de conteúdo definido como "JSON".

Para mais parâmetros e exemplos opcionais, acesse az appconfig kv importação.

Importar dados do ConfigMaps do Serviço de Kubernetes do Azure

Siga as etapas abaixo para importar valores-chave do ConfigMaps do Serviço de Kubernetes do Azure. O suporte do portal para esse recurso está em desenvolvimento, use a CLI do Azure para importar do AKS.

Portal

O suporte do portal do Azure para esse recurso está em desenvolvimento.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando importação az appconfig kv import e adicione os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Digite o nome do armazenamento de Configuração de Aplicativos do Azure para o qual você deseja importar dados.	my-app-config-store
   --source	Insira aks para indicar que você está importando dados de configuração de aplicativo do Serviço de Kubernetes do Azure.	aks
   --aks-cluster	Insira a ID do ARM do Serviço de Kubernetes do Azure ou use o nome do Serviço de Kubernetes do Azure, se ele estiver na mesma assinatura e grupo de recursos que a Configuração do Aplicativo.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster ou my-aks-cluster
   --configmap-namespace	Insira o namespace do ConfigMap que você deseja importar.	default
   --configmap-name	Insira o nome do ConfigMap que você deseja importar.	my-configmap

2. Opcionalmente, adicione também os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --prefix	Opcional. Um prefixo de chave é a parte inicial da propriedade "chave" de um valor-chave. Prefixos podem ser usados ​​para gerenciar grupos de valores-chave em um armazenamento de configuração. Esse prefixo será anexado à frente da propriedade "chave" de cada valor-chave importado.	TestApp:
   --label	Opcional. Insira um rótulo que será atribuído aos seus valores-chave importados. Se você não especificar um rótulo, o rótulo nulo será atribuído aos seus valores-chave.	test
   --content-type	Opcional. Digite appconfig/kvset ou application/json para declarar que o conteúdo importado consiste em uma referência do Key Vault ou um arquivo JSON.	application/json
   --format	Opcional. Insira yaml, propriedades ou json para indicar o formato de ConfigMap que você está importando.	json
   --separator	Opcional. O separador é o delimitador para nivelar os valores-chave. É necessário para exportar a estrutura hierárquica e será ignorado para arquivos de propriedades e sinalizadores de recursos. Selecione uma das seguintes opções: ., ,, :, ;, /, -, _, —.	;

   Para obter o valor para --aks-cluster, use o comando az aks show --resource-group <resource-group> --name <aks-cluster-name>.

   Exemplo: importe todas as configurações do seu Configmap do AKS como valores-chave com o rótulo "test", para o repositório de Configuração de Aplicativos e adicione um prefixo "TestApp:".

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

3. A linha de comando exibe uma lista das próximas alterações. Confirme a importação selecionando y.

   

Você importou todas as configurações de seu ConfigMap do AKS como valores-chave, atribuiu-lhes o rótulo "test" e adicionou um prefixo "TestApp:".

Para mais parâmetros e exemplos opcionais, acesse az appconfig kv importação.

Exportar dados

A exportação grava e configuração de dados armazenados na Configuração de Aplicativos do Azure para outro destino. Use a função de exportação, por exemplo, para salvar dados de um repositório de Configuração de Aplicativos do Azure em um arquivo que pode ser incorporado ao código do aplicativo durante a implantação.

Esse guia mostra como exportar dados de Configuração de Aplicativos do Azure:

• para um arquivo de configuração em JSON, YAML ou Propriedades
• para uma loja de Configuração de Aplicativos do Azure
• para um recurso do Serviço de Aplicativo do Azure

Exportar dados para um arquivo de configuração

Siga essas etapas para exportar dados de configuração de um repositório de Configuração de Aplicativos do Azure para um arquivo JSON, YAML ou Propriedades.

Portal

No portal do Azure, siga essas etapas:

1. Navegue até a loja de Configuração de Aplicativos do Azure e selecione Importar/exportar.

   

2. Selecione o botão de opção Exportar e em Tipo de destino, selecione Arquivo de configuração.

3. Preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Tipo de arquivo	Selecione o tipo de arquivo para exportação: YAML, Propriedades ou JSON.	JSON
   Perfil de conteúdo do arquivo	Selecione um perfil de conteúdo: Padrão ou KVSet. O perfil de conteúdo de arquivo Padrão refere-se ao esquema de arquivo de configuração convencional amplamente adotado por estruturas ou sistemas de programação existentes, suportando formatos de arquivo JSON, YAML ou Propriedades. O perfil de conteúdo do arquivo KVSet refere-se a um esquema de arquivo que contém todas as propriedades de uma chave-valor de Configuração de Aplicativos do Azure, incluindo chave, valor, rótulo, tipo de conteúdo e marcas.	Default
   Modo de seleção	Selecione se deseja exportar de pares chave-valor regulares, que é a opção padrão ou de um instantâneo.	Default
   Filtro de chave	Usado para filtrar pares chave-valor com base no nome da chave para exportação. Se nenhuma chave for especificada, todas as chaves são qualificadas.	Começa com TestApp:
   Em um momento específico	Opcional. Preencha esse campo para exportar valores-chave de um momento específico no armazenamento de configuração selecionado. Se deixado em branco, o padrão será o ponto atual no tempo dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione o rótulo para exportar os valores-chave associados a esses rótulos. Se nenhum rótulo for selecionado, todos os rótulos serão elegíveis. Observe que você só pode selecionar um rótulo ao exportar com o perfil de conteúdo do arquivo Default. Para exportar valores-chave com mais de um rótulo, use o perfil de conteúdo do arquivo KVSet.	prod
   Remover prefixo	Opcional. Se especificado, o prefixo será removido dos nomes de chaves de todos os valores de chaves exportados que o contêm.	TestApp:
   Separador	O separador é o delimitador usado para segmentar nomes de chaves e reconstruir configurações hierárquicas para arquivos JSON ou YAML a partir de valores de chaves. Ele será ignorado para arquivos de propriedade e sinalizadores de recursos. Os valores suportados incluem nenhum separador, ponto final (.), vírgula (,), ponto e vírgula (;), hífen (-), sublinhado (_), sublinhado duplo (__), barra (/) e dois pontos (:).	:

4. Selecione Exportar para finalizar a exportação.

Você exportou valores-chave de um repositório de Configuração de Aplicativos do Azure em 28 de julho de 2021, às 12, com nomes de chaves começando com TestApp: e o rótulo prod para um arquivo JSON. O prefixo TestApp: foi removido dos nomes das chaves, e o separador : foi usado para segmentar os nomes das chaves e reconstruir o formato hierárquico JSON.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando exportação az appconfig kv export e adicione os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Insira o nome do repositório de Configuração de Aplicativos do Azure que contém os valores-chave que você deseja exportar.	my-app-config-store
   --destination	Insira file para indicar que você está exportando dados para um arquivo.	file
   --path	Insira o caminho no qual você quer salvar o arquivo.	C:/Users/john/Downloads/data.json
   --format	Digite yaml, properties ou json para indicar o formato do arquivo que você deseja exportar.	json
   --label	Insira um rótulo para exportar valores-chave e sinalizadores de recursos com esse rótulo. Se você não especificar um rótulo, por padrão, você exportará apenas valores-chave e sinalizadores de recursos sem rótulo. Você pode inserir um rótulo, inserir vários rótulos separando-os com , ou usar * para levar todos os rótulos em consideração.	prod

   Importante

   Se você não selecionar um rótulo, somente os valores-chave sem rótulos serão exportados. Para exportar um valor-chave com um rótulo, você deve selecionar seu rótulo.

2. Opcionalmente, adicione também os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --separator	Opcional. O separador é o delimitador para simplificar os valores-chave para JSON/YAML. É necessário para exportar a estrutura hierárquica e será ignorado para arquivos de propriedades e sinalizadores de recursos. Selecione uma das seguintes opções: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opcional. Prefixo a ser cortado da propriedade "key" de cada chave-valor. Um prefixo de chave é a parte inicial de uma chave. Prefixos podem ser usados ​​para gerenciar grupos de valores-chave em um armazenamento de configuração. O prefixo será ignorado para sinalizadores de recursos.	TestApp:

   Exemplo: exporte todos os valores-chave e sinalizadores de recursos com o rótulo "prod" para um arquivo JSON.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. A linha de comando exibe uma lista de valores-chave que estão sendo exportados para o arquivo. Confirme a exportação selecionando y.

   

Os sinalizadores de recursos variantes são exportados para um arquivo usando o esquema do Microsoft Feature Management, enquanto outros sinalizadores de recursos são exportados usando o esquema do .NET Feature Management para compatibilidade. Para exportar sinalizadores de recursos exclusivamente usando o esquema do Microsoft Feature Management, defina a variável de ambiente AZURE_APPCONFIG_FM_COMPATIBLE como False.

Você exportou valores-chave e sinalizadores de recursos que têm o rótulo "prod" para um arquivo de configuração e cortou o prefixo "TestApp". Os valores são separados por ";" no arquivo.

Para mais parâmetros e exemplos opcionais, vá para az appconfig kv export.

Exportar dados para um repositório de Configuração de Aplicativos

Siga as etapas abaixo para exportar os valores de chave e sinalizadores de recursos para um repositório de Configuração de Aplicativos do Azure.

Você pode exportar valores de um armazenamento de configuração de aplicativo para outro armazenamento de configuração de aplicativo ou pode exportar valores de um armazenamento de Configuração de Aplicativos do Azure para o mesmo armazenamento de configuração de aplicativo para duplicar seus valores e aplicar parâmetros diferentes, como novo rótulo ou tipo de conteúdo.

Portal

No portal do Azure, siga essas etapas:

1. Navegue até o armazenamento de Configuração de Aplicativos do Azure que contém os dados que você deseja exportar e selecione Importar/exportar no menu Operações.

   

2. Selecione o botão de opção Exportar e em Tipo de destino, selecione Configuração de Aplicativos do Azure.

3. Preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Modo de seleção	Selecione se deseja exportar de pares chave-valor regulares, que é a opção padrão ou de um instantâneo.	Default
   Filtro de chave	Usado para filtrar pares chave-valor com base no nome da chave para exportação. Se nenhuma chave for especificada, todas as chaves são qualificadas.	Começa com TestApp:
   Em um momento específico	Opcional. Preencha esse campo para exportar valores-chave de um momento específico no armazenamento de configuração selecionado. Se deixado em branco, o padrão será o ponto atual no tempo dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione um ou mais rótulos para exportar os valores-chave associados a esses rótulos. Se nenhum rótulo for selecionado, todos os rótulos serão elegíveis.	prod
   Excluir sinalizador de recurso	Se marcada, os sinalizadores de recursos não serão exportados.	Desmarcado

4. Selecione a loja de destino, preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Subscrição	Sua assinatura atual é selecionada por padrão.	my-subscription
   Grupo de recursos	Selecione um grupo de recursos que contenha o repositório de Configuração de Aplicativos do Azure para onde você deseja exportar a configuração. Seu grupo de recursos atual é selecionado por padrão.	my-resource-group
   Recurso	Selecione a loja de Configuração de Aplicativos do Azure para onde você deseja exportar a configuração.	my-other-app-config-store

5. Preencha a próxima parte do formulário:

   Parâmetro	Descrição	Exemplo
   Remover prefixo	Opcional. Se especificado, o prefixo será removido dos nomes de chaves de todos os valores de chaves exportados que o contêm.	TestApp:
   Substituir rótulos	Opcional. Por padrão, os rótulos originais dos pares chave-valor de origem são preservados. Para substituí-los, marque a caixa e insira um novo rótulo para os valores-chave exportados.	novo
   Substituir tipos de conteúdo	Opcional. Por padrão, os tipos de conteúdo originais dos pares chave-valor de origem são preservados. Para substituí-los, marque a caixa e insira um novo tipo de conteúdo para pares chave-valor exportados. Observe que o tipo de conteúdo dos sinalizadores de recursos não pode ser substituído.	JSON (aplicação/json)

6. Selecione Aplicar para prosseguir com a exportação.

Você exportou valores-chave de um repositório de configuração de aplicativo em 28 de julho de 2022, às 12h, com nomes de chaves começando com TestApp: e o rótulo prod, para outro repositório de Configuração de Aplicativos do Azure. Todos os valores-chave exportados tiveram o prefixo da chave TestApp: removido e foram atribuídos o rótulo new e o tipo de conteúdo application/json.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando exportar az appconfig kv export e informe os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Insira o nome do repositório de Configuração de Aplicativos do Azure que contém os valores-chave que você deseja exportar.	my-app-config-store
   --destination	Insira appconfig para indicar que você está exportando os dados para um repositório de Configuração de Aplicativos.	appconfig
   --dest-name	Digite o nome do armazenamento de Configuração de Aplicativos do Azure para o qual você deseja exportar dados.	my-other-app-config-store
   --label	Insira um rótulo para exportar valores-chave e sinalizadores de recursos com esse rótulo. Se você não especificar um rótulo, por padrão, você exportará apenas valores-chave e sinalizadores de recursos sem rótulo. Você pode inserir um rótulo, inserir vários rótulos separando-os com , ou usar * para levar todos os rótulos em consideração.	prod

   Importante

   Se os valores-chave que você deseja exportar tiverem rótulos, você deverá usar o comando --label e inserir os rótulos correspondentes. Se você não selecionar um rótulo, somente os valores-chave sem rótulos serão exportados. Use um sinal de vírgula (,) para selecionar vários rótulos ou use * para incluir todos os rótulos, incluindo o rótulo nulo (sem rótulo).

2. Opcionalmente, adicione também o seguinte parâmetro:

   Parâmetro	Descrição	Exemplo
   --dest-label	Opcional. Insira um rótulo de destino para atribuir esse rótulo aos valores-chave exportados.	new

   Exemplo: exporte valores-chave e sinalizadores de recursos com o rótulo "prod" para outro armazenamento de Configuração de Aplicativos do Azure e adicione o rótulo de destino "novo".

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. A linha de comando exibe uma lista de valores-chave que estão sendo exportados para os arquivos. Confirme a exportação selecionando y.

   

Você exportou valores-chave e sinalizadores de recursos que têm o rótulo "prod" de um repositório de Configuração de Aplicativos do Azure e atribuiu a eles o rótulo "novo".

Para mais parâmetros e exemplos opcionais, acesse az appconfig kv importação.

Exportar dados para o Serviço de Aplicativo do Azure

Siga as etapas abaixo para exportar valores-chave para o Serviço de Aplicativo do Azure.

Observação

Não há suporte para exportar sinalizadores de recursos para o Serviço de Aplicativo do Azure.

Portal

No portal do Azure, siga essas etapas:

1. Navegue até o armazenamento de Configuração de Aplicativos do Azure e selecione Importar/exportar no menu Operações.

   

2. Selecione o botão de opção Exportar e em Tipo de destino, selecione Serviços de Aplicativos.

3. A opção Exportar como referência está marcada por padrão. Quando a caixa for marcada, as configurações do aplicativo no Serviço de Aplicativo serão adicionadas como referências da Configuração de Aplicativos para os pares chave-valor exportados. Isso permite que você gerencie suas configurações na Configuração de Aplicativos, com o Serviço de Aplicativo extraindo automaticamente os valores atuais da Configuração de Aplicativos. Para saber mais, veja Usar referências de configuração de aplicativo para o App Service e as Azure Functions. Se a caixa estiver desmarcada, a chave e o valor serão exportados diretamente para o Serviço de Aplicativo. Lembre-se de exportar seus dados novamente sempre que fizer alterações na Configuração de Aplicativos do Azure para garantir que seu aplicativo receba as atualizações.

4. Preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Modo de seleção	Selecione se deseja exportar de pares chave-valor regulares, que é a opção padrão ou de um instantâneo.	Default
   Filtro de chave	Usado para filtrar pares chave-valor com base no nome da chave para exportação. Se nenhuma chave for especificada, todas as chaves são qualificadas.	Começa com TestApp:
   Em um momento específico	Opcional. Preencha esse campo para exportar valores-chave de um momento específico no armazenamento de configuração selecionado. Se deixado em branco, o padrão será o ponto atual no tempo dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione um rótulo para exportar os valores-chave associados a esse rótulo.	prod

5. Selecione uma loja de destino e preencha o formulário com os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   Subscrição	Sua assinatura atual é selecionada por padrão.	my-subscription
   Grupo de recursos	Selecione um grupo de recursos que contenha o Serviço de Aplicativo para o qual você deseja exportar a configuração.	my-resource-group
   Recurso	Selecione o Serviço de Aplicativo para o qual você deseja exportar a configuração.	my-app-service

6. Opcionalmente, preencha a próxima parte do formulário:

   Parâmetro	Descrição	Exemplo
   Remover prefixo	Opcional. Se especificado, o prefixo será removido dos nomes de chaves de todos os valores de chaves exportados que o contêm.	TestApp:

7. Selecione Aplicar para prosseguir com a exportação.

Você exportou valores-chave de um repositório de configuração de aplicativo em 28 de julho de 2022, às 12h, com nomes de chaves começando com TestApp: e o rótulo prod, para as Configuração de Aplicativos do Azure de um recurso do Serviço de Aplicativo. O prefixo TestApp: foi removido dos nomes de chaves exportados.

Se você marcou a caixa para exportar valores-chave como referências, os valores-chave exportados serão indicados como referências de Configuração de Aplicativos do Azure na coluna "Origem" das suas configurações de recursos do Serviço de Aplicativo.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver o CLI do Azure instalado localmente, você pode usar opcionalmente Azure Cloud Shell.

1. Digite o comando exportar az appconfig kv export e informe os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Insira o nome do repositório de Configuração de Aplicativos do Azure que contém os valores-chave que você deseja exportar.	my-app-config-store
   --destination	Insira appservice para indicar que você está exportando dados para o Serviço de Aplicativo.	appservice
   --appservice-account	Insira o ID do ARM do Serviço de Aplicativo ou use o nome do Serviço de Aplicativo, se estiver na mesma assinatura e grupo de recursos que a Configuração de Aplicativos do Azure.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service ou my-app-service
   --label	Opcional. Insira um rótulo para exportar valores-chave e sinalizadores de recursos com esse rótulo. Se você não especificar um rótulo, por padrão, você exportará apenas valores-chave e sinalizadores de recursos sem rótulo.	prod

   Para obter o valor para --appservice-account, use o comando az webapp show --resource-group <resource-group> --name <resource-name>.

2. Opcionalmente, adicione também um prefixo:

   Parâmetro	Descrição	Exemplo
   --prefix	Opcional. Prefixo a ser cortado da propriedade "key" de um valor-chave exportado. Um prefixo de chave é a parte inicial de uma chave. Prefixos podem ser usados ​​para gerenciar grupos de valores-chave em um armazenamento de configuração.	TestApp:

   Exemplo: exporte todos os valores-chave com o rótulo "prod" para um aplicativo do Serviço de Aplicativo e corte o prefixo "TestApp".

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   A linha de comando exibe uma lista de valores-chave que estão sendo exportados para um recurso do Serviço de Aplicativo. Confirme a exportação selecionando y.

   

   Você exportou todos os valores-chave com o rótulo "prod" para um recurso do Serviço de Aplicativo do Azure e cortou o prefixo "TestApp:".

3. Opcionalmente, especifique um sinalizador para exportar como uma Referência de Configuração de Aplicativos do Azure.

   Parâmetro	Descrição
   --export-as-reference -r	Opcional. Especifique se os valores-chave são exportados para o Serviço de Aplicativo como referências de Configuração de Aplicativos. Saiba mais.

   Exemplo: exporte todos os valores-chave com o rótulo "prod" como referências de configuração de aplicativo para um aplicativo do Serviço de Aplicativo.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   A linha de comando exibe uma lista de valores-chave sendo exportados como referências de configuração de aplicativo para um recurso do Serviço de Aplicativo do Azure. Confirme a exportação selecionando y.

   

   Você exportou todos os valores-chave com o rótulo "prod" como referências de Configuração de Aplicativos do Azure para um recurso do Serviço de Aplicativo do Azure. No seu recurso do Serviço de Aplicativo do Azure, os valores-chave importados serão indicados como referências de Configuração de Aplicativos do Azure na coluna "Origem".

   

Para mais parâmetros e exemplos opcionais, vá para az appconfig kv export.

Mensagens de erro

Você pode encontrar as seguintes mensagens de erro ao importar ou exportar valores-chave da Configuração de Aplicativos do Azure:

• O acesso público está desabilitado para sua loja ou você está acessando de um ponto de extremidade privado que não está nas configurações de ponto de extremidade privado da loja. Se o seu repositório de Configuração de Aplicativos do Azure tiver ponto de extremidade privados habilitados, você só poderá acessá-lo de dentro da rede virtual configurada por padrão. Verifique se o computador que executa o portal do Azure ou a CLI do Azure está associado à mesma rede virtual que o ponto de extremidade privado. Se você acabou de habilitar o acesso da rede pública ao seu repositório de Configuração de Aplicativos do Azure, aguarde pelo menos 5 minutos antes de tentar novamente para permitir que o cache seja atualizado.

Próximas etapas

Integrar um pipeline de CI/CD