Importar ou exportar dados de configuração

A Configuração de Aplicativo do Azure dá 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 sua loja de configuração de aplicativos e o projeto de código. Por exemplo, você pode configurar uma loja de Configuração de Aplicativo para teste e outra para produção. Você pode copiar as configurações do aplicativo entre elas para não precisar inserir dados duas vezes.

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

Importar dados

A importação traz dados de configuração para uma loja de configuração de aplicativos de uma fonte existente. Use a função de importação para migrar dados para uma loja de configuração de aplicativos ou agregar dados de várias fontes.

Este guia mostra como importar dados de Configuração do Aplicativo:

• de um arquivo de configuração em Json, Yaml ou Propriedades
• a partir de uma loja de configuração de aplicações
• do Serviço de Aplicativo 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 estas etapas:

1. Navegue até a sua loja de configuração de aplicativos e selecione Importar/exportar no menu Operações .

   

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

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

   Parâmetro	Description	Exemplo
   Tipo de ficheiro	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 parte seguinte do formulário:

   Parâmetro	Description	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, suporta 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 um valor-chave de Configuração do Aplicativo, incluindo chave, valor, rótulo, tipo de conteúdo e tags.	Predefinição
   Modo de importação	O modo de importação é usado para determinar se os valores de chave idênticos devem ser ignorados. Com a opção Ignorar correspondência , todos os valores-chave no repositório que são os mesmos que os do arquivo de configuração são ignorados. Com a opção Todos , todos os valores-chave no arquivo de configuração são atualizados.	Ignorar correspondência
   Sinalizador de recurso de exclusão	Se estiver marcada, os sinalizadores de recursos não serão importados.	Desselecionado
   Estrito	Se a caixa estiver marcada, todos os valores-chave no repositório com o prefixo e o rótulo especificados que não estão incluídos no arquivo de configuração serão excluídos quando o perfil de conteúdo do arquivo estiver definido como Padrão. Quando o perfil de conteúdo do arquivo é definido como KVSet, todos os valores-chave 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 na loja será excluído.	Desselecionado
   Separador	O separador é o delimitador usado para nivelar 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 (.), vírgula (,), ponto-e-vírgula (;), hífen (-), sublinhado (_), sublinhado duplo (__), barra (/) e dois pontos (:).	:
   Profundidade	Opcional. A profundidade para nivelar arquivos JSON ou YAML em pares chave-valor. Por padrão, os arquivos são nivelados para o 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 chave de todos os valores-chave 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 (aplicativo/json)
   Adicionar etiquetas	Opcional. Se especificado, as tags fornecidas serão adicionadas a todos os valores-chave importados.	{tag: tag1}

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

Você importou com êxito valores-chave de um arquivo JSON. Os nomes das chaves foram nivelados usando o : separador e prefixados com TestApp:. Todos os valores-chave importados são rotulados como prod, com um tipo de conteúdo de , e marcados application/jsoncom tag: tag1.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver a CLI do Azure instalada localmente, poderá usar opcionalmente o Azure Cloud Shell.

1. Insira o comando az appconfig kv import import e adicione os seguintes parâmetros:

   Parâmetro	Description	Exemplo
   --name	Introduza o nome da loja de Configuração da Aplicação para a qual pretende importar dados.	my-app-config-store
   --source	Enter file para indicar que você está importando dados de configuração do aplicativo de um arquivo.	file
   --path	Insira o caminho local para o arquivo que contém os dados que você deseja importar.	C:/Users/john/Downloads/data.json
   --format	Insira 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	Description	Exemplo
   --separator	Opcional. O separador é o delimitador para nivelar os valores-chave para Json/Yaml. É necessário para exportar a estrutura hierárquica e será ignorado para arquivos de propriedade e sinalizadores de recursos. Selecione uma das seguintes opções: , , , , , /-, _, —. ;:,.	;
   --prefix	Opcional. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser usados para gerenciar grupos de valores-chave em um repositório de configuração. Esse prefixo será anexado à frente da propriedade "key" 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 indique que o conteúdo importado consiste em uma referência do Cofre da Chave 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 acrescente 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-lhes o rótulo "prod" e o prefixo "TestApp:". O separador ";" é usado e todos os valores-chave importados têm o tipo de conteúdo definido como "JSON".

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

Importar dados de uma loja de configuração de aplicativos

Você pode importar valores de uma App Configuration Store para outra App Configuration Store ou pode importar valores de uma App Configuration Store para a mesma App Configuration Store para duplicar seus valores e aplicar parâmetros diferentes, como novo rótulo ou tipo de conteúdo.

Siga as etapas abaixo para importar valores-chave e sinalizadores de recursos de uma loja de Configuração de Aplicativo do Azure.

Portal

No portal do Azure, siga estas etapas:

1. Navegue até a sua loja de configuração de aplicativos e selecione Importar/exportar no menu Operações .

   

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

3. Selecione uma App Configuration Store da qual importar dados e preencha o formulário com os seguintes parâmetros:

   Parâmetro	Description	Exemplo
   Subscrição	A sua subscrição atual está selecionada por predefinição.	A minha subscrição
   Grupo de recursos	Selecione um grupo de recursos que contenha a App Configuration store com configuração para importar. Seu grupo de recursos atual é selecionado por padrão.	meu-recurso-grupo
   Recurso	Selecione a App Configuration store que contém a configuração que pretende importar.	my-other-app-config-store

4. Preencha a parte seguinte do formulário:

   Parâmetro	Description	Exemplo
   Modo de seleção	Selecione se deseja importar de valores de chave regulares, que é a opção padrão, ou de um instantâneo.	Predefinição
   Filtro de chave	Usado para filtrar valores-chave com base no nome da chave para importação. Se nenhuma chave for especificada, todas as chaves serão elegíveis.	Começa com o teste
   Num momento específico	Opcional. Preencha este campo para importar valores-chave de um point-in-time específico no repositório de configuração selecionado. Se deixado vazio, o padrão será o ponto no tempo atual dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione uma ou mais etiquetas para importar valores-chave associados a essas etiquetas. Se nenhum rótulo for selecionado, todos os rótulos serão elegíveis.	PROD
   Sinalizador de recurso de exclusão	Se estiver marcada, os sinalizadores de recursos não serão importados.	Desselecionado
   Adicionar prefixo	Opcional. Se especificado, um prefixo será adicionado aos nomes de chave de todos os valores-chave importados.	TestApp:
   Substituir rótulos	Opcional. Por padrão, os rótulos originais dos valores-chave de origem são preservados. Para substituí-los, marque a caixa e insira um novo rótulo para valores-chave importados.	Novo
   Substituir tipos de conteúdo	Opcional. Por padrão, os tipos de conteúdo originais dos valores-chave de origem são preservados. Para substituí-los, marque a caixa e insira um novo tipo de conteúdo para valores-chave importados. Observe que o tipo de conteúdo dos sinalizadores de recurso não pode ser substituído.	JSON (aplicativo/json)

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

Você importou valores-chave de uma loja de Configuração de Aplicativo a partir de 28 de janeiro de 2021, às 12h, com nomes de chave começando com test e o rótulo prod. Os principais nomes foram prefixados com TestApp:. Todos os valores-chave importados receberam o rótulo new e o tipo application/jsonde conteúdo.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver a CLI do Azure instalada localmente, poderá usar opcionalmente o Azure Cloud Shell.

1. Digite o comando az appconfig kv import import e insira os seguintes parâmetros:

   Parâmetro	Description	Exemplo
   --name	Introduza o nome da loja de Configuração de Aplicações para a qual pretende importar dados	my-app-config-store
   --source	Enter appconfig para indicar que está a importar dados de uma loja de Configuração de Aplicações.	appconfig
   --src-name	Introduza o nome da loja de Configuração da Aplicação a partir da qual pretende 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 um 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	Description	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 indique que o conteúdo importado consiste em uma referência do Cofre da Chave ou um arquivo JSON. O tipo de conteúdo só pode ser substituído por valores-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 Aplicativo e atribua-lhes 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 uma loja de configuração de aplicativos e atribuiu-lhes o rótulo "novo". Todos os valores-chave importados têm o tipo de conteúdo definido como "JSON".

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

Importar dados do Serviço de Aplicativo do Azure

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

Nota

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

Portal

No portal do Azure:

1. Navegue até a sua loja de configuração de aplicativos e selecione Importar/exportar no menu Operações .

   

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

3. Selecione uma App Configuration Store da qual importar dados e preencha o formulário com os seguintes parâmetros:

   Parâmetro	Description	Exemplo
   Subscrição	A sua subscrição atual está selecionada por predefinição.	A minha subscrição
   Grupo de recursos	Selecione um grupo de recursos que contenha o Serviço de Aplicativo com configuração a ser importada.	meu-recurso-grupo
   Recurso	Selecione o Serviço de Aplicativo que contém a configuração que você deseja importar.	my-app-service

4. Preencha a parte seguinte do formulário:

   Parâmetro	Description	Exemplo
   Atualizar configurações para referência	Se estiver marcada, as configurações do aplicativo no Serviço de Aplicativo serão atualizadas para as referências de Configuração do Aplicativo para os valores-chave importados. Isso permite que você gerencie as configurações do seu aplicativo na Configuração do aplicativo no futuro. Seu Serviço de Aplicativo extrairá automaticamente o valor atual da Configuração do Aplicativo. Para saber mais, consulte Usar referências de configuração de aplicativo para o Serviço de Aplicativo e o Azure Functions.	Verificada
   Adicionar prefixo	Opcional. Se especificado, um prefixo será adicionado aos nomes de chave de todos os valores-chave 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 (aplicativo/json)

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

Você importou todas as configurações do aplicativo de um Serviço de Aplicativo como valores-chave e atribuiu-lhes o rótulo prod e o prefixo TestApp:. Todos os valores-chave importados 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 a CLI do Azure instalada localmente, poderá usar opcionalmente o Azure Cloud Shell.

1. Insira o comando az appconfig kv import import e adicione os seguintes parâmetros:

   Parâmetro	Description	Exemplo
   --name	Introduza o nome da loja de Configuração da Aplicação para a qual pretende importar dados.	my-app-config-store
   --source	Enter appservice para indicar que você está importando dados de configuração do aplicativo do Serviço de Aplicativo do Azure.	appservice
   --appservice-account	Insira a ID ARM do Serviço de Aplicativo ou use o nome do Serviço de Aplicativo, se ele estiver no mesmo grupo de assinatura e recursos que a Configuração do Aplicativo.	/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	Description	Exemplo
   --prefix	Opcional. Um prefixo de chave é a parte inicial da propriedade "key" de um valor-chave. Os prefixos podem ser usados para gerenciar grupos de valores-chave em um repositório de configuração. Esse prefixo será anexado à frente da propriedade "key" 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 indicar que o conteúdo importado consiste em uma referência do Cofre da Chave ou um arquivo JSON.	application/json

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

   Exemplo: importe todas as configurações do aplicativo do seu Serviço de Aplicativo como valores-chave com o rótulo "prod" para sua loja de Configuração de Aplicativo e adicione 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 Serviço de Aplicativo como valores-chave, atribuiu-lhes 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 obter mais parâmetros opcionais e exemplos, vá para az appconfig kv import.

Exportar Dados

Exportar grava dados de configuração armazenados na Configuração do Aplicativo para outro destino. Use a função de exportação, por exemplo, para salvar dados de uma loja de configuração de aplicativos em um arquivo que possa ser incorporado no código do aplicativo durante a implantação.

Este guia mostra como exportar dados de Configuração do Aplicativo:

• para um arquivo de configuração em Json, Yaml ou Propriedades
• para uma loja de configuração de aplicativos
• para um recurso do Serviço de Aplicativo do Azure

Exportar dados para um arquivo de configuração

Siga estas etapas para exportar dados de configuração de um repositório de configurações de aplicativos para um arquivo JSON, YAML ou Propriedades.

Portal

No portal do Azure, siga estas etapas:

1. Navegue até a sua loja de configuração de aplicativos 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	Description	Exemplo
   Tipo de ficheiro	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, suporta 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 um valor-chave de Configuração do Aplicativo, incluindo chave, valor, rótulo, tipo de conteúdo e tags.	Predefinição
   Modo de seleção	Selecione se deseja exportar a partir de valores de chave regulares, que é a opção padrão, ou de um instantâneo.	Predefinição
   Filtro de chave	Usado para filtrar valores-chave com base no nome da chave para exportação. Se nenhuma chave for especificada, todas as chaves serão elegíveis.	Começa com TestApp:
   Num momento específico	Opcional. Preencha este campo para exportar valores-chave de um point-in-time específico no armazenamento de configuração selecionado. Se deixado vazio, o padrão será o ponto no tempo atual dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione o rótulo para exportar 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 Default arquivo. Para exportar valores-chave com mais de um rótulo, use o perfil de conteúdo do KVSet arquivo.	PROD
   Remover prefixo	Opcional. Se especificado, o prefixo será removido dos nomes de chave de todos os valores-chave 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-chave. Ele será ignorado para arquivos de propriedade e sinalizadores de recursos. Os valores suportados incluem nenhum separador, ponto (.), vírgula (,), ponto-e-vírgula (;), hífen (-), sublinhado (_), sublinhado duplo (__), barra (/) e dois pontos (:).	:

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

Você exportou valores-chave de uma loja de Configuração de Aplicativo a partir de 28 de julho de 2021, às 12h, com nomes de chave começando com TestApp: e o rótulo prod, para um arquivo JSON. O prefixo TestApp: foi cortado dos nomes das chaves, e o separador : foi usado para segmentar os nomes das chaves e reconstruir o formato JSON hierárquico.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver a CLI do Azure instalada localmente, poderá usar opcionalmente o Azure Cloud Shell.

1. Insira o comando az appconfig kv export export e adicione os seguintes parâmetros:

   Parâmetro	Description	Exemplo
   --name	Introduza o nome da loja de Configuração da Aplicação que contém os valores-chave que pretende exportar.	my-app-config-store
   --destination	Enter file para indicar que está a exportar dados para um ficheiro.	file
   --path	Introduza o caminho onde pretende guardar o ficheiro.	C:/Users/john/Downloads/data.json
   --format	Introduza yaml, properties ou json para indicar o formato do ficheiro que pretende 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, 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	Description	Exemplo
   --separator	Opcional. O separador é o delimitador para nivelar os valores-chave para Json/Yaml. É necessário para exportar a estrutura hierárquica e será ignorado para arquivos de propriedade e sinalizadores de recursos. Selecione uma das seguintes opções: , , , , , /-, _, —. ;:,.	;
   --prefix	Opcional. Prefixo a ser cortado da propriedade "key" de cada valor-chave. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser usados para gerenciar grupos de valores-chave em um repositório 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.

   

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 obter mais parâmetros opcionais e exemplos, vá para az appconfig kv export.

Exportar dados para uma loja de configuração de aplicativos

Siga as etapas abaixo para exportar valores-chave e sinalizadores de recursos para uma loja de Configuração de Aplicativo do Azure.

Você pode exportar valores de uma loja de Configuração de Aplicativo para outra loja de Configuração de Aplicativo ou pode exportar valores de uma loja de Configuração de Aplicativo para a mesma Loja 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 estas etapas:

1. Navegue até a loja de configuração de aplicativos 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 do aplicativo.

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

   Parâmetro	Description	Exemplo
   Modo de seleção	Selecione se deseja exportar a partir de valores de chave regulares, que é a opção padrão, ou de um instantâneo.	Predefinição
   Filtro de chave	Usado para filtrar valores-chave com base no nome da chave para exportação. Se nenhuma chave for especificada, todas as chaves serão elegíveis.	Começa com TestApp:
   Num momento específico	Opcional. Preencha este campo para exportar valores-chave de um point-in-time específico no armazenamento de configuração selecionado. Se deixado vazio, o padrão será o ponto no tempo atual dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione uma ou mais etiquetas para exportar valores-chave associados a essas etiquetas. Se nenhum rótulo for selecionado, todos os rótulos serão elegíveis.	PROD
   Sinalizador de recurso de exclusão	Se estiver marcada, os sinalizadores de recursos não serão exportados.	Desselecionado

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

   Parâmetro	Description	Exemplo
   Subscrição	A sua subscrição atual está selecionada por predefinição.	A minha subscrição
   Grupo de recursos	Selecione um grupo de recursos que contenha a loja de Configuração de Aplicações para a qual pretende exportar a configuração. Seu grupo de recursos atual é selecionado por padrão.	meu-recurso-grupo
   Recurso	Selecione a App Configuration store para onde pretende exportar a configuração.	my-other-app-config-store

5. Preencha a parte seguinte do formulário:

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

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

Você exportou valores-chave de uma loja de configuração de aplicativo a partir de 28 de julho de 2022, às 12h, com nomes de chave começando com TestApp: e o rótulo prod, para outra loja de configuração de aplicativo. Todos os valores-chave exportados foram cortados o prefixo TestApp:da chave e atribuídos o rótulo new e o tipo application/jsonde conteúdo.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver a CLI do Azure instalada localmente, poderá usar opcionalmente o Azure Cloud Shell.

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

   Parâmetro	Description	Exemplo
   --name	Introduza o nome da loja de Configuração da Aplicação que contém os valores-chave que pretende exportar.	my-app-config-store
   --destination	Enter appconfig para indicar que está a exportar dados para uma loja de Configuração de Aplicações.	appconfig
   --dest-name	Introduza o nome da loja de Configuração da Aplicação para a qual pretende 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, exportará apenas valores-chave e sinalizadores de recursos sem rótulo. Pode introduzir uma etiqueta, várias etiquetas separando-as com ,, ou utilizar * para ter todas as etiquetas em conta.	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	Description	Exemplo
   --dest-label	Opcional. Insira um rótulo de destino para atribuir esse rótulo a valores-chave exportados.	new

   Exemplo: exporte valores-chave e sinalizadores de recursos com o rótulo "prod" para outra loja de configuração de aplicativos 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 uma loja de configuração de aplicativo e atribuiu-lhes o rótulo "novo".

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

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.

Nota

Não há suporte para a exportação de sinalizadores de recursos para o Serviço de Aplicativo.

Portal

No portal do Azure, siga estas etapas:

1. Navegue até a sua loja de configuração de aplicativos 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 Aplicativo.

3. A opção Exportar como referência está marcada por padrão. Quando a caixa estiver marcada, as configurações do aplicativo no Serviço de Aplicativo serão adicionadas como referências de Configuração do Aplicativo para os valores de chave exportados. Isso permite que você gerencie suas configurações na Configuração do Aplicativo, com o Serviço de Aplicativo extraindo automaticamente os valores atuais da Configuração do Aplicativo. Para saber mais, consulte Usar referências de configuração de aplicativo para o Serviço de Aplicativo e o 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 do aplicativo para garantir que seu aplicativo receba as atualizações.

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

   Parâmetro	Description	Exemplo
   Modo de seleção	Selecione se deseja exportar a partir de valores de chave regulares, que é a opção padrão, ou de um instantâneo.	Predefinição
   Filtro de chave	Usado para filtrar valores-chave com base no nome da chave para exportação. Se nenhuma chave for especificada, todas as chaves serão elegíveis.	Começa com TestApp:
   Num momento específico	Opcional. Preencha este campo para exportar valores-chave de um point-in-time específico no armazenamento de configuração selecionado. Se deixado vazio, o padrão será o ponto no tempo atual dos valores-chave.	28/07/2022 12:00:00
   Do rótulo	Selecione um rótulo para exportar 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	Description	Exemplo
   Subscrição	A sua subscrição atual está selecionada por predefinição.	A minha subscrição
   Grupo de recursos	Selecione um grupo de recursos que contenha o Serviço de Aplicativo para o qual você deseja exportar a configuração.	meu-recurso-grupo
   Recurso	Selecione o Serviço de Aplicativo para onde deseja exportar a configuração.	my-app-service

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

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

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

Você exportou valores-chave de uma loja de Configuração de Aplicativo a partir de 28 de julho de 2022, às 12h, com nomes de chave começando com TestApp: e o rótulo prod, para as configurações de aplicativo de um recurso do Serviço de Aplicativo. O prefixo TestApp: foi cortado 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 do Aplicativo na coluna "Origem" das definições de configuração de recursos do Serviço de Aplicativo.

CLI do Azure

Na CLI do Azure, siga as etapas abaixo. Se você não tiver a CLI do Azure instalada localmente, poderá usar opcionalmente o Azure Cloud Shell.

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

   Parâmetro	Description	Exemplo
   --name	Introduza o nome da loja de Configuração da Aplicação que contém os valores-chave que pretende exportar.	my-app-config-store
   --destination	Enter appservice para indicar que você está exportando dados para o Serviço de Aplicativo.	appservice
   --appservice-account	Insira a ID ARM do Serviço de Aplicativo ou use o nome do Serviço de Aplicativo, se ele estiver no mesmo grupo de assinatura e recursos que a Configuração do Aplicativo.	/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, exportará apenas valores-chave e sinalizadores de recursos sem rótulo.	prod

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

2. Opcionalmente, adicione também um prefixo:

   Parâmetro	Description	Exemplo
   --prefix	Opcional. Prefixo a ser cortado da propriedade "key" de um valor de chave exportado. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser usados para gerenciar grupos de valores-chave em um repositório 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 do Aplicativo.

   Parâmetro	Description
   --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 do Aplicativo. Mais informações.

   Exemplo: exporte todos os valores-chave com o rótulo "prod" como referências de configuração do 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 que estão sendo exportados como referências de configuração de aplicativo 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" como referências de configuração do aplicativo para um recurso do Serviço de Aplicativo do Azure. No recurso do Serviço de Aplicativo, os valores-chave importados serão indicados como referências de Configuração do Aplicativo na coluna "Origem".

   

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

Mensagens de erro

Você pode encontrar as seguintes mensagens de erro ao importar ou exportar valores de chave de configuração do aplicativo:

• O acesso público está desativado para sua loja ou você está acessando a partir de um ponto de extremidade privado que não está nas configurações de ponto de extremidade privado da loja. Se a sua loja de Configuração de Aplicações tiver pontos de extremidade privados ativados, só poderá acedê-la a partir da rede virtual configurada por predefinição. Verifique se a máquina que executa o portal do Azure ou a CLI está associada à mesma rede virtual que o ponto de extremidade privado. Se você acabou de habilitar o acesso à rede pública em sua loja de configuração de aplicativos, aguarde pelo menos 5 minutos antes de tentar novamente permitir que o cache seja atualizado.

Próximos passos

Integrar num pipeline CI/CD