Importar ou exportar dados de configuração

Azure App Configuration suporta operações de importação e exportação de dados. Utilize estas operações para trabalhar com dados de configuração em volume e trocar dados entre o seu arquivo de App Configuration e o projeto de código. Por exemplo, pode configurar um arquivo de App Configuration para teste e outro para produção. Pode copiar as definições da aplicação entre as mesmas para que não tenha de introduzir dados duas vezes.

Este artigo fornece um guia para importar e exportar dados com App Configuration. Se quiser configurar uma sincronização contínua com o seu repositório do GitHub, veja GitHub Actions e tarefas do Azure Pipelines.

Pode importar ou exportar dados com o portal do Azure ou a CLI do Azure.

Importar dados

A importação traz dados de configuração para um arquivo de App Configuration a partir de uma origem existente. Utilize a função de importação para migrar dados para um arquivo de App Configuration ou agregar dados de várias origens.

Este guia mostra como importar App Configuration dados:

• a partir de um ficheiro de configuração em Json, Yaml ou Propriedades
• a partir de um arquivo de App Configuration
• de Serviço de Aplicações do Azure

Importar dados de um ficheiro de configuração

Siga os passos abaixo para importar valores-chave de um ficheiro.

Nota

A importação de sinalizadores de funcionalidades de um ficheiro não é suportada. Se um ficheiro de configuração contiver sinalizadores de funcionalidades, estes serão importados automaticamente como valores-chave normais.

Portal

Na portal do Azure, siga estes passos:

1. Navegue até ao seu arquivo de App Configuration e selecione Importar/exportar no menu Operações.

   

2. No separador Importar , selecione Ficheiro de configuração em Serviço de origem.

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

   Parâmetro	Descrição	Exemplo
   Para idioma	Escolha o idioma do ficheiro que está a importar entre .NET, Java (Spring) e Outro.	.NET
   Tipo de ficheiro	Selecione o tipo de ficheiro que está a importar entre Yaml, Properties e Json.	Json

4. Selecione o ícone Pasta e navegue para o ficheiro a importar.

   Nota

   É apresentada uma mensagem no ecrã a indicar que o ficheiro foi obtido com êxito.

5. Preencha a parte seguinte do formulário:

   Parâmetro	Descrição	Exemplo
   Separador	O separador é o caráter analisado no ficheiro de configuração importado para separar valores-chave que serão adicionados ao seu arquivo de configuração. Selecione uma das seguintes opções: ., ,, :, ;, /, -, _, —.	;
   Prefixo	Opcional. Um prefixo de chave é a parte inicial da propriedade "chave" de um valor-chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração. O prefixo introduzido será anexado à parte frontal da propriedade "key" de cada chave-valor que importar a partir deste ficheiro.	TestApp:
   Etiqueta	Opcional. Selecione uma etiqueta existente ou introduza uma nova etiqueta que será atribuída aos valores de chave importados.	prod
   Tipo do conteúdo	Opcional. Indique se está a importar um ficheiro JSON ou Key Vault referências. Para obter mais informações sobre referências Key Vault, aceda a Utilizar referências de Key Vault numa aplicação ASP.NET Core.	JSON (application/json)

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

Importou valores-chave de um ficheiro JSON, atribuiu-lhes a etiqueta "prod" e o prefixo "TestApp". O separador ":" é utilizado e todos os valores-chave que importou têm o tipo de conteúdo definido como "JSON".

CLI do Azure

Na CLI do Azure, siga os passos abaixo. Se não tiver a CLI do Azure instalada localmente, pode utilizar o Azure Cloud Shell.

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

   Parâmetro	Descrição	Exemplo
   --name	Introduza o nome do arquivo de App Configuration para o qual pretende importar dados.	my-app-config-store
   --source	Introduza file para indicar que está a importar dados de configuração de aplicações de um ficheiro.	file
   --path	Introduza o caminho local para o ficheiro que contém os dados que pretende importar.	C:/Users/john/Downloads/data.json
   --format	Introduza yaml, propriedades ou json para indicar o formato do ficheiro que está a importar.	json

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

   Parâmetro	Descrição	Exemplo
   --separator	Opcional. O separador é o delimitador para aplanar os valores-chave para Json/Yaml. É necessário para exportar a estrutura hierárquica e será ignorado para ficheiros de propriedades e sinalizadores de funcionalidades. Selecione uma das seguintes opções: ., , ,, :, ;/, -, , . —_	;
   --prefix	Opcional. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração. Este prefixo será anexado à parte frontal da propriedade "chave" de cada chave-valor importado.	TestApp:
   --label	Opcional. Introduza uma etiqueta que será atribuída aos valores de chave importados.	prod
   --content-type	Opcional. Introduza appconfig/kvset ou application/json para indicar que o conteúdo importado consiste numa referência de Key Vault ou num ficheiro JSON.	application/json

   Exemplo: importe todos os valores de chave e sinalizadores de funcionalidade de um ficheiro JSON, aplique a etiqueta "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 comandos apresenta uma lista das próximas alterações. Confirme a importação ao selecionar y.

   

Importou valores-chave de um ficheiro JSON, atribuiu-lhes a etiqueta "prod" e o prefixo "TestApp:". O separador ";" é utilizado e todos os valores-chave que importou têm o tipo de conteúdo definido como "JSON".

Para obter mais parâmetros e exemplos opcionais, aceda a az appconfig kv import.

Importar dados de um arquivo de App Configuration

Pode importar valores de um arquivo de App Configuration para outro arquivo de App Configuration ou pode importar valores de um arquivo de App Configuration para o mesmo arquivo de App Configuration para duplicar os respetivos valores e aplicar parâmetros diferentes, como uma nova etiqueta ou tipo de conteúdo.

Siga os passos abaixo para importar os valores-chave e os sinalizadores de funcionalidades de um arquivo de Azure App Configuration.

Portal

Na portal do Azure, siga estes passos:

1. Navegue até ao seu arquivo de App Configuration e selecione Importar/exportar no menu Operações.

   

2. No separador Importar, selecione App Configuration em Serviço de origem.

3. Selecione Selecionar recurso, preencha o formulário com os seguintes parâmetros e selecione Aplicar:

   Parâmetro	Descrição	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 arquivo de App Configuration com a configuração a importar. O grupo de recursos atual está selecionado por predefinição.	my-resource-group
   Recurso	Selecione o arquivo de App Configuration que contém a configuração que pretende importar.	my-other-app-config-store

   Nota

   A mensagem "Chaves de acesso obtidas com êxito" indica que a ligação ao arquivo App Configuration foi bem-sucedida.".

4. Preencha a parte seguinte do formulário:

   Parâmetro	Descrição	Exemplo
   A partir da etiqueta	Selecione pelo menos uma etiqueta para importar valores com as etiquetas correspondentes. Selecione todos importarão valores-chave com qualquer etiqueta e (Nenhuma etiqueta) irá restringir a importação para valores-chave sem etiqueta.	prod
   Num momento específico	Opcional. Preencha para importar valores-chave de um ponto específico no tempo. Este é o ponto anterior no tempo dos valores-chave no arquivo de configuração selecionado. Formato: "YYYY-MM-DDThh:mm:ssZ". Este campo é predefinido para o ponto atual no tempo dos valores-chave quando deixado vazio.	07/28/2022 00:00
   Substituir etiquetas chave-valor predefinidas	Opcional. Por predefinição, os itens importados utilizam a etiqueta atual. Selecione a caixa e introduza uma etiqueta para substituir estas predefinições com uma etiqueta personalizada.	novo
   Substituir o tipo de conteúdo chave-valor predefinido	Opcional. Por predefinição, os itens importados utilizam o tipo de conteúdo atual. Selecione a caixa e selecione Key Vault Referência ou JSON (aplicação/json) em Tipo de conteúdo para indicar que o conteúdo importado consiste numa referência Key Vault ou num ficheiro JSON. O tipo de conteúdo só pode ser substituído por valores-chave importados. O tipo de conteúdo predefinido para sinalizadores de funcionalidades é "application/vnd.microsoft.appconfig.ff+json;charset=utf-8" e não é atualizado por este parâmetro.	JSON (aplicação/json)

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

Importou os principais valores e sinalizadores de funcionalidades com a etiqueta "prod" de um arquivo de App Configuration a 28 de janeiro de 2021 às 12:00 e atribuiu-lhes a etiqueta "novo". Todos os valores-chave que importou têm o tipo de conteúdo definido como "JSON".

CLI do Azure

Na CLI do Azure, siga os passos abaixo. Se não tiver a CLI do Azure instalada localmente, pode, opcionalmente, utilizar o Azure Cloud Shell.

1. Introduza o comando az appconfig kv import de importação e introduza os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Introduza o nome do arquivo de App Configuration para o qual pretende importar dados	my-app-config-store
   --source	Introduza appconfig para indicar que está a importar dados de um arquivo de App Configuration.	appconfig
   --src-name	Introduza o nome do arquivo de App Configuration a partir do qual pretende importar dados.	my-source-app-config
   --src-label	Restrinja a importação para valores-chave com uma etiqueta específica. Se não utilizar este parâmetro, apenas serão importados valores-chave com uma etiqueta nula. Suporta star assinar como filtro: introduza * para todas as etiquetas; abc* para todas as etiquetas com abc como prefixo.	prod

2. Opcionalmente, adicione os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --label	Opcional. Introduza uma etiqueta que será atribuída aos valores-chave importados.	new
   --content-type	Opcional. Introduza appconfig/kvset ou application/json indique que o conteúdo importado consiste numa referência Key Vault ou num ficheiro JSON. O tipo de conteúdo só pode ser substituído por valores-chave importados. O tipo de conteúdo predefinido para sinalizadores de funcionalidades é "application/vnd.microsoft.appconfig.ff+json;charset=utf-8" por predefinição e não é atualizado por este parâmetro.	application/json

   Exemplo: importe os valores-chave e os sinalizadores de funcionalidades com a etiqueta "prod" de outro App Configuration e atribua-lhes a etiqueta "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 comandos apresenta uma lista das próximas alterações. Confirme a importação ao selecionar y.

   

Importou valores-chave com a etiqueta "prod" de um arquivo App Configuration e atribuiu-lhes a etiqueta "novo". Todos os valores-chave que importou têm o tipo de conteúdo definido como "JSON".

Para obter mais parâmetros e exemplos opcionais, aceda a az appconfig kv import.

Importar dados de Serviço de Aplicações do Azure

Siga os passos abaixo para importar valores-chave de Serviço de Aplicações do Azure.

Nota

Serviço de Aplicações não suporta atualmente sinalizadores de funcionalidades. Todos os sinalizadores de funcionalidade importados para Serviço de Aplicações são convertidos automaticamente em valores-chave. Os recursos Serviço de Aplicações só podem conter valores-chave.

Portal

No portal do Azure:

1. Navegue até ao seu arquivo de App Configuration e selecione Importar/exportar no menu Operações.

   

2. No separador Importar , selecione Serviços de Aplicações em Serviço de origem.

3. Selecione Selecionar recurso, preencha o formulário com os seguintes parâmetros e selecione Aplicar:

   Parâmetro	Descrição	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 Aplicações com a configuração a importar.	my-resource-group
   Recurso	Selecione o Serviço de Aplicações que contém a configuração que pretende importar.	my-app-service

   Nota

   É apresentada uma mensagem a indicar o número de valores-chave que foram obtidos com êxito a partir da origem Serviço de Aplicações recurso.

4. Preencha a parte seguinte do formulário:

   Parâmetro	Descrição	Exemplo
   Prefixo	Opcional. Um prefixo de chave é a parte inicial da propriedade "chave" de um valor-chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração. Este prefixo será anexado à parte frontal da propriedade "chave" de cada chave-valor importado.	TestApp:
   Etiqueta	Opcional. Selecione uma etiqueta existente ou introduza uma nova etiqueta que será atribuída aos valores de chave importados.	prod
   Tipo do conteúdo	Opcional. Indique se o ficheiro que está a importar é uma referência Key Vault ou um ficheiro JSON. Para obter mais informações sobre referências Key Vault, aceda a Utilizar referências de Key Vault numa aplicação ASP.NET Core.	JSON (application/json)

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

Importou todas as definições da aplicação de um Serviço de Aplicações como valores-chave e atribuiu-lhes a etiqueta "prod" e o prefixo "TestApp". Todos os valores-chave que importou têm o tipo de conteúdo definido como "JSON".

CLI do Azure

Na CLI do Azure, siga os passos abaixo. Se não tiver a CLI do Azure instalada localmente, pode utilizar o Azure Cloud Shell.

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

   Parâmetro	Descrição	Exemplo
   --name	Introduza o nome do arquivo de App Configuration para o qual pretende importar dados.	my-app-config-store
   --source	Introduza appservice para indicar que está a importar dados de configuração de aplicações do Serviço de Aplicações do Azure.	appservice
   --appservice-account	Introduza o ID arm do Serviço de Aplicações ou utilize o nome do Serviço de Aplicações, se estiver na mesma subscrição e grupo de recursos que o App Configuration.	/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. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração. Este prefixo será anexado à parte frontal da propriedade "chave" de cada chave-valor importado.	TestApp:
   --label	Opcional. Introduza uma etiqueta que será atribuída aos valores de chave importados. Se não especificar uma etiqueta, a etiqueta nula será atribuída aos valores de chave.	prod
   --content-type	Opcional. Introduza appconfig/kvset ou application/json para indicar que o conteúdo importado consiste numa referência Key Vault ou num ficheiro JSON.	application/json

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

   Exemplo: importe todas as definições da aplicação do seu Serviço de Aplicações como valores-chave com a etiqueta "prod", para o arquivo de App Configuration 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 comandos apresenta uma lista das próximas alterações. Confirme a importação ao selecionar y.

   

Importou todas as definições da aplicação do seu Serviço de Aplicações como valores-chave, atribuiu-lhes a etiqueta "prod" e adicionou um prefixo "TestApp:". Todos os valores-chave que importou têm o tipo de conteúdo definido como "JSON".

Para obter mais parâmetros e exemplos opcionais, aceda a az appconfig kv import.

Exportar dados

Exportar os dados de configuração de escrita armazenados no App Configuration para outro destino. Utilize a função de exportação, por exemplo, para guardar dados de um arquivo de App Configuration num ficheiro que possa ser incorporado no código da aplicação durante a implementação.

Este guia mostra como exportar App Configuration dados:

• para um ficheiro de configuração em Json, Yaml ou Propriedades
• para um arquivo de App Configuration
• para um recurso de Serviço de Aplicações do Azure

Exportar dados para um ficheiro de configuração

Siga os passos abaixo para exportar dados de configuração de um arquivo de configuração de aplicações para um ficheiro Json, Yaml ou Propriedades.

Nota

Atualmente, a exportação de sinalizadores de funcionalidades de um arquivo de App Configuration para um ficheiro de configuração só é suportada na CLI.

Portal

Na portal do Azure, siga estes passos:

1. Navegue até ao seu arquivo de App Configuration e selecione Importar/exportar.

   

2. No separador Exportar , selecione Ficheiro de configuração em Serviço de destino.

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

   Parâmetro	Descrição	Exemplo
   Prefixo	Opcional. Este prefixo será cortado da propriedade "chave" de cada chave-valor. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração.	TestApp:
   A partir da etiqueta	Selecione uma etiqueta existente para restringir a sua exportação a valores-chave com uma etiqueta específica. Se não selecionar uma etiqueta, por predefinição, apenas os valores-chave com a etiqueta "Sem Etiqueta" serão exportados. Veja a nota abaixo.	prod
   Num momento específico	Opcional. Preencha para importar valores-chave de um ponto específico no tempo. Este é o ponto anterior no tempo dos valores de chave no arquivo de configuração selecionado. Formato: "AAAA-MM-DDThh:mm:ssZ". Este campo é predefinido para o ponto atual no tempo dos valores-chave quando deixado em branco.	28/07/2022 00:00
   Tipo de ficheiro	Selecione o tipo de ficheiro que está a exportar entre Yaml, Propriedades ou Json.	JSON
   Separador	O separador é o delimitador para aplanar os valores-chave para Json/Yaml. Suporta a estrutura hierárquica da configuração e não se aplica a ficheiros de propriedades e sinalizadores de funcionalidades. Selecione uma das seguintes opções: ., ,, :, ;, /, -, _, ou(Sem separador).	;

   Importante

   Se não selecionar uma etiqueta De, apenas os valores-chave sem etiquetas serão exportados. Para exportar um valor-chave com uma etiqueta, tem de selecionar a respetiva etiqueta. Tenha em atenção que só pode selecionar uma etiqueta por exportação no portal, caso pretenda exportar os valores-chave com todas as etiquetas especificadas, utilize a CLI.

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

Exportou valores-chave que têm a etiqueta "prod" de um ficheiro de configuração, no respetivo estado a partir de 28/07/2021 00:00 e cortou o prefixo "TestApp". Os valores são separados por ";" no ficheiro.

CLI do Azure

Na CLI do Azure, siga os passos abaixo. Se não tiver a CLI do Azure instalada localmente, pode utilizar o Azure Cloud Shell.

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

   Parâmetro	Descrição	Exemplo
   --name	Introduza o nome do arquivo de App Configuration que contém os valores-chave que pretende exportar.	my-app-config-store
   --destination	Introduza 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 yamlou jsonproperties para indicar o formato do ficheiro que pretende exportar.	json
   --label	Introduza uma etiqueta para exportar os valores de chave e os sinalizadores de funcionalidades com esta etiqueta. Se não especificar uma etiqueta, por predefinição, só exportará os valores de chave e os sinalizadores de funcionalidades sem etiqueta. Pode introduzir uma etiqueta, introduzir várias etiquetas separando-as com ,ou utilizar * para ter em conta todas as etiquetas.	prod

   Importante

   Se não selecionar uma etiqueta, apenas os valores-chave sem etiquetas serão exportados. Para exportar um valor-chave com uma etiqueta, tem de selecionar a respetiva etiqueta.

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

   Parâmetro	Descrição	Exemplo
   --separator	Opcional. O separador é o delimitador para aplanar os valores-chave para Json/Yaml. É necessário para exportar a estrutura hierárquica e será ignorado para ficheiros de propriedades e sinalizadores de funcionalidades. Selecione uma das seguintes opções: ., , ,, :, ;/, -, , . —_	;
   --prefix	Opcional. Prefixo a ser cortado da propriedade "chave" de cada chave-valor. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração. O prefixo será ignorado para sinalizadores de funcionalidades.	TestApp:

   Exemplo: exportar todos os valores de chave e sinalizadores de funcionalidade com a etiqueta "prod" para um ficheiro 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 comandos apresenta uma lista de valores-chave a serem exportados para o ficheiro. Confirme a exportação ao selecionar y.

   

Exportou valores de chave e sinalizadores de funcionalidades que têm a etiqueta "prod" para um ficheiro de configuração e cortou o prefixo "TestApp". Os valores são separados por ";" no ficheiro.

Para obter mais parâmetros e exemplos opcionais, aceda a az appconfig kv export.

Exportar dados para um arquivo de App Configuration

Siga os passos abaixo para exportar os valores de chave e os sinalizadores de funcionalidades para um arquivo de Azure App Configuration.

Pode exportar valores de um arquivo de App Configuration para outro arquivo de App Configuration ou pode exportar valores de um arquivo de App Configuration para o mesmo arquivo de App Configuration para duplicar os respetivos valores e aplicar parâmetros diferentes, como uma nova etiqueta ou tipo de conteúdo.

Portal

Na portal do Azure, siga estes passos:

1. Navegue para o arquivo de App Configuration que contém os dados que pretende exportar e selecione Importar/exportar no menu Operações.

   

2. No separador Exportar, selecione App Configuration em Serviço de destino.

3. Selecione Selecionar recurso, preencha o formulário com os seguintes parâmetros e selecione Aplicar:

   Parâmetro	Descrição	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 arquivo de App Configuration com a configuração a importar.	my-resource-group
   Recurso	Selecione o arquivo de App Configuration que contém a configuração que pretende importar.	my-app-config-store

4. A página apresenta agora o serviço de destino e o ID de recurso selecionados. A ação Selecionar recurso permite-lhe mudar para outro arquivo de App Configuration de origem.

   Nota

   É apresentada uma mensagem no ecrã a indicar que os valores-chave foram obtidos com êxito.

5. Preencha a parte seguinte do formulário:

   Parâmetro	Descrição	Exemplo
   A partir da etiqueta	Selecione pelo menos uma etiqueta para exportar valores com as etiquetas correspondentes. Selecione todos os valores de chave com qualquer etiqueta e (Sem etiqueta) irá restringir a exportação para valores-chave sem etiqueta.	prod
   Num momento específico	Opcional. Preencha para importar valores-chave de um ponto específico no tempo. Este é o ponto anterior no tempo dos valores de chave no arquivo de configuração selecionado. Formato: "AAAA-MM-DDThh:mm:ssZ". Este campo é predefinido para o ponto atual no tempo dos valores-chave quando deixado em branco.	28/07/2022 00:00
   Substituir etiquetas chave-valor predefinidas	Opcional. Por predefinição, os itens importados utilizam a etiqueta atual. Selecione a caixa e introduza uma etiqueta para substituir estas predefinições por uma etiqueta personalizada.	novo

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

Exportou os valores de chave e os sinalizadores de funcionalidade que têm a etiqueta "prod" de um arquivo de App Configuration, no respetivo estado a partir de 28/07/2022 00:00 e atribuiu-lhes a etiqueta "novo".

CLI do Azure

Na CLI do Azure, siga os passos abaixo. Se não tiver a CLI do Azure instalada localmente, pode utilizar o Azure Cloud Shell.

1. Introduza o comando az appconfig kv export de exportação e introduza os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Introduza o nome do arquivo de App Configuration que contém os valores-chave que pretende exportar.	my-app-config-store
   --destination	Introduza appconfig para indicar que está a exportar dados para um arquivo de App Configuration.	appconfig
   --dest-name	Introduza o nome do arquivo de App Configuration para o qual pretende exportar dados.	my-other-app-config-store
   --label	Introduza uma etiqueta para exportar os valores de chave e os sinalizadores de funcionalidades com esta etiqueta. Se não especificar uma etiqueta, por predefinição, só exportará os valores de chave e os sinalizadores de funcionalidades sem etiqueta. Pode introduzir uma etiqueta, introduzir várias etiquetas separando-as com ,ou utilizar * para ter em conta todas as etiquetas.	prod

   Importante

   Se os valores-chave que pretende exportar tiverem etiquetas, tem de utilizar o comando --label e introduzir as etiquetas correspondentes. Se não selecionar uma etiqueta, apenas os valores-chave sem etiquetas serão exportados. Utilize um sinal de vírgula (,) para selecionar várias etiquetas ou utilizar * para incluir todas as etiquetas, incluindo a etiqueta nula (sem etiqueta).

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

   Parâmetro	Descrição	Exemplo
   --dest-label	Opcional. Introduza uma etiqueta de destino para atribuir esta etiqueta a valores-chave exportados.	new

   Exemplo: exporte os valores de chave e os sinalizadores de funcionalidade com a etiqueta "prod" para outro App Configuration loja e adicione a etiqueta 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 comandos apresenta uma lista de valores-chave a serem exportados para os ficheiros. Confirme a exportação ao selecionar y.

   

Exportou os valores de chave e os sinalizadores de funcionalidade que têm a etiqueta "prod" de um arquivo de App Configuration e atribuiu-lhes a etiqueta "novo".

Para obter mais parâmetros e exemplos opcionais, aceda a az appconfig kv import.

Exportar dados para Serviço de Aplicações do Azure

Siga os passos abaixo para exportar valores de chave para Serviço de Aplicações do Azure.

Nota

A exportação de sinalizadores de funcionalidades para Serviço de Aplicações não é atualmente suportada.

Portal

Na portal do Azure, siga estes passos:

1. Navegue até ao seu arquivo de App Configuration e selecione Importar/exportar no menu Operações.

   

2. No separador Exportar , selecione Serviços Aplicacionaisem Serviço de destino.

3. Selecione Selecionar recurso, preencha o formulário com os seguintes parâmetros e selecione Aplicar:

   Parâmetro	Descrição	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 Aplicações com a configuração a exportar.	my-resource-group
   Recurso	Selecione o Serviço de Aplicações que contém a configuração que pretende exportar.	my-app-service

4. A página apresenta agora o serviço de destino e o ID de recurso selecionados. A ação Selecionar recurso permite-lhe mudar para outro recurso de destino Serviço de Aplicações.

5. Opcionalmente, preencha a parte seguinte do formulário:

   Parâmetro	Descrição	Exemplo
   Prefixo	Opcional. Este prefixo será cortado da propriedade "chave" de cada chave-valor exportada. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração. O prefixo será ignorado para sinalizadores de funcionalidades.	TestApp:
   Exportar como referência	Opcional. Verifique se pretende exportar valores-chave para Serviço de Aplicações como referências de App Configuration. Saiba mais
   Num momento específico	Opcional. Preencha para exportar valores-chave de um ponto específico no tempo. Este é o ponto anterior no tempo dos valores de chave no arquivo de configuração selecionado. Formato: "AAAA-MM-DDThh:mm:ssZ". Este campo é predefinido para o ponto atual no tempo dos valores-chave quando deixado em branco.	28/07/2022 00:00
   A partir da etiqueta	Opcional. Selecione uma etiqueta existente para restringir a sua exportação a valores-chave com uma etiqueta específica. Se não selecionar uma etiqueta, apenas os valores-chave com a etiqueta "Sem etiqueta" serão exportados.	prod

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

Exportou valores-chave que têm a etiqueta "prod" de um recurso Serviço de Aplicações, no respetivo estado a partir de 28/07/2021 12:00:00 e cortou o prefixo "TestApp". Os valores-chave foram exportados com um tipo de conteúdo no formato JSON.

Se tiver selecionado a caixa para exportar valores-chave como referências, os valores de chave exportados serão indicados como referências App Configuration na coluna "Origem" das definições de configuração de recursos Serviço de Aplicações.

CLI do Azure

Na CLI do Azure, siga os passos abaixo. Se não tiver a CLI do Azure instalada localmente, pode utilizar o Azure Cloud Shell.

1. Introduza o comando az appconfig kv export de exportação e introduza os seguintes parâmetros:

   Parâmetro	Descrição	Exemplo
   --name	Introduza o nome do arquivo de App Configuration que contém os valores-chave que pretende exportar.	my-app-config-store
   --destination	Introduza appservice para indicar que está a exportar dados para Serviço de Aplicações.	appservice
   --appservice-account	Introduza o ID arm do Serviço de Aplicações ou utilize o nome do Serviço de Aplicações, se estiver na mesma subscrição e grupo de recursos que o App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service ou my-app-service
   --label	Opcional. Introduza uma etiqueta para exportar os valores de chave e os sinalizadores de funcionalidades com esta etiqueta. Se não especificar uma etiqueta, por predefinição, só exportará os valores-chave e os sinalizadores de funcionalidades sem etiqueta.	prod

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

2. Opcionalmente, também adicione um prefixo:

   Parâmetro	Descrição	Exemplo
   --prefix	Opcional. Prefixo a ser cortado da propriedade "chave" de um valor-chave exportado. Um prefixo de chave é a parte inicial de uma chave. Os prefixos podem ser utilizados para gerir grupos de valores-chave num arquivo de configuração.	TestApp:

   Exemplo: exporte todos os valores-chave com a etiqueta "prod" para uma aplicação Serviço de Aplicações 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 comandos apresenta uma lista de valores-chave a serem exportados para um recurso Serviço de Aplicações. Confirme a exportação ao selecionar y.

   

   Exportou todos os valores-chave com a etiqueta "prod" para um recurso Serviço de Aplicações do Azure e cortou o prefixo "TestApp:".

3. Opcionalmente, especifique um sinalizador para exportar como referência de App Configuration.

   Parâmetro	Description
   --export-as-reference -r	Opcional. Especifique se os valores-chave são exportados para Serviço de Aplicações como referências App Configuration. Saiba mais.

   Exemplo: exporte todos os valores-chave com a etiqueta "prod" como referências de configuração de aplicações para uma aplicação Serviço de Aplicações.

   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 comandos apresenta uma lista de valores-chave a serem exportados como referências de configuração de aplicações para um recurso Serviço de Aplicações. Confirme a exportação ao selecionar y.

   

   Exportou todos os valores-chave com a etiqueta "prod" como referências de configuração de aplicações para um recurso Serviço de Aplicações do Azure. No recurso Serviço de Aplicações, os valores-chave importados serão indicados como referências App Configuration na coluna "Origem".

   

Para obter mais parâmetros e exemplos opcionais, aceda a az appconfig kv export.

Mensagens de erro

Pode encontrar as seguintes mensagens de erro ao importar ou exportar App Configuration valores-chave:

• O ficheiro selecionado tem de estar entre 1 e 2097152 bytes.: o ficheiro é demasiado grande. Selecione um ficheiro mais pequeno.
• O acesso público está desativado para a loja ou está a aceder a partir de um ponto final privado que não se encontra nas configurações de ponto final privado da loja. Para importar valores-chave de um arquivo de App Configuration, tem de ter acesso a esse arquivo. Se necessário, ative o acesso público ao arquivo de origem ou aceda ao mesmo a partir de um ponto final privado aprovado. Se tiver ativado o acesso público, aguarde até 5 minutos para que a cache seja atualizada.

Passos seguintes

Integrar num pipeline CI/CD