Импорт и экспорт данных конфигурации

Конфигурация приложений Azure поддерживает операции импорта и экспорта данных. Эти операции позволяют выполнять массовые операции с данными конфигурации и обмен данными между хранилищем Конфигурации приложений и проектом кода. Например, можно настроить одно хранилище Конфигурации приложений для тестирования, а другое — для рабочей среды. Вы можете копировать параметры приложения между ними, чтобы не вводить данные дважды.

В этой статье приведено руководство по импорту и экспорту данных с помощью портал Azure или Azure CLI. Если вы приняли конфигурацию в качестве кода и управляете конфигурациями в GitHub или Azure DevOps, вы можете настроить текущий импорт файла конфигурации с помощью GitHub Actions или использовать задачу импорта Azure Pipeline.

Импорт данных

Операция импорта позволяет перенести данные конфигурации в хранилище Конфигурации приложений из существующего источника. С помощью функции импорта можно переносить данные в хранилище Конфигурации приложений или для агрегировать данные из нескольких источников.

В этом руководстве показано, как импортировать данные Конфигурации приложений:

• из файла конфигурации в формате JSON, YAML или свойств;
• из хранилища Конфигурации приложений;
• из Службы приложений Azure.

Импорт данных из файла конфигурации

Чтобы импортировать пары "ключ-значение" из файла, выполните указанные ниже действия.

Портал

На портале Azure сделайте следующее:

1. Перейдите в хранилище Конфигурация приложений и выберите "Импорт и экспорт" в меню "Операции".

   

2. Переключатель импорта выбран по умолчанию. В разделе "Исходный тип" выберите файл конфигурации.

3. Заполните форму, указав следующие параметры:

   Параметр	Описание	Пример
   Тип файла	Выберите тип файла для импорта: YAML, Properties или JSON.	Json

4. Нажмите кнопку "Обзор " и выберите файл для импорта.

5. Заполните следующую часть формы:

   Параметр	Описание	Пример
   Профиль содержимого файла	Выберите профиль содержимого: default или KVSet. Профиль содержимого файла по умолчанию относится к стандартной схеме файлов конфигурации, широко принятой существующими платформами программирования или системами, поддерживает форматы файлов JSON, Yaml или Properties. Профиль содержимого файла KVSet ссылается на схему файла, содержащую все свойства Конфигурация приложений key-value, включая ключ, значение, метку, тип контента и теги.	По умолчанию
   Режим Import	Режим импорта используется для определения того, следует ли игнорировать идентичные значения ключей. При использовании параметра "Игнорировать совпадение" все значения ключей в хранилище, которые совпадают с значениями в файле конфигурации, игнорируются. При использовании параметра "Все " все значения ключей в файле конфигурации обновляются.	Игнорировать совпадение
   Исключить флаг компонента	При проверке флаги компонентов не будут импортированы.	Флажок снят
   Strict	Если флажок установлен, все значения ключей в хранилище с указанным префиксом и меткой, не включенными в файл конфигурации, удаляются, если для профиля содержимого файла задано значение Default. Если для профиля содержимого файла задано значение KVSet, все значения ключей в хранилище, не включенные в файл конфигурации, удаляются. Если поле снято, ключ-значения в хранилище не будут удалены.	Флажок снят
   Разделитель	Разделитель — это разделитель, используемый для выравнивания файлов JSON или YAML в ключ-значение. Он будет игнорироваться для файлов свойств и флагов компонентов. Поддерживаемые значения включают no-разделитель, период (.), запятую (,), точку с запятой (;), дефис (-), символ подчеркивания (_), двойный символ подчеркивания (__), косую черту (/) и двоеточие (:).	:
   Глубина	Необязательно. Глубина для выравнивания файлов JSON или YAML в пары "ключ-значение". По умолчанию файлы сглаживаются до самого глубокого уровня, если выбран разделитель. Этот параметр не применяется для файлов свойств или флагов компонентов.
   Добавление префикса	Необязательно. Если задано, префикс будет добавлен в имена ключей всех импортированных значений ключей.	TestApp:
   Добавить метку	Необязательно. Если задано, указанная метка будет назначена всем импортированным значениям ключей.	тыкать
   Добавление типа контента	Необязательно. Если задано, указанный тип контента будет добавлен ко всем импортированным значениям ключей.	JSON (application/json)
   Добавление тегов	Необязательно. При указании указанные теги будут добавлены ко всем импортированным значениям ключей.	{tag: tag1}

6. Выберите Применить, чтобы продолжить импорт.

Вы успешно импортировали значения ключей из JSON-файла. Имена ключей : были выровнированы с помощью разделителя и префикса.TestApp: Все импортированные значения ключей помечены как prodтип application/jsonконтента и помечены тегом tag: tag1.

Azure CLI

В Azure CLI выполните указанные ниже действия. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

1. Введите команду импорта az appconfig kv import и добавьте следующие параметры:

   Параметр	Описание	Пример
   --name	Введите имя хранилища Конфигурации приложений, в которое вы хотите импортировать данные.	my-app-config-store
   --source	Введите file, чтобы указать, что вы импортируете данные конфигурации приложения из файла.	file
   --path	Введите локальный путь к файлу с данными, которые требуется импортировать.	C:/Users/john/Downloads/data.json
   --format	Введите yaml, properties или json, чтобы указать формат импортируемого файла.	json

2. При необходимости также добавьте следующие параметры:

   Параметр	Описание	Пример
   --separator	Необязательно. Разделитель — это символ для выравнивания пар "ключ-значение" в файле JSON или YAML. Он необходим для экспорта иерархической структуры и игнорируется для файлов свойств и флагов признаков. Выберите один из следующих вариантов: ., ,, :, ;, /, -, _, —.	;
   --prefix	Необязательно. Префикс ключа — это начальная часть ключа. Префиксы можно использовать для управления группами ключевых значений в хранилище конфигурации. Этот префикс будет добавлен к передней части свойства "key" каждого импортированного значения ключа.	TestApp:
   --label	Необязательно. Введите метку, которая будет назначена импортированным парам "ключ-значение".	prod
   --content-type	Необязательно. Введите appconfig/kvset или application/json, чтобы указать, что импортированное содержимое состоит из ссылки на хранилище ключей или JSON-файла.	application/json

   Пример: импортируйте все значения ключей и флаги функций из JSON-файла, примените метку prod и добавьте префикс TestApp. Добавьте тип контента 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. В командной строке отобразится список предстоящих изменений. Выберите y, чтобы подтвердить импорт.

   

Вы импортировали значения ключей из JSON-файла и назначили им метку "prod" и префикс "TestApp:". Используется разделитель ";", а все значения ключей, импортируемые вами, имеют тип контента в формате JSON.

Другие необязательные параметры и примеры см. в описании команды az appconfig kv import.

Импорт данных из хранилища Конфигурации приложений

Вы можете импортировать значения из одного хранилища Конфигурации приложений в другое или из одного хранилища Конфигурации приложений в то же самое хранилище, если требуется продублировать значения, но применить другие параметры, такие как новая метка или тип контента.

Выполните указанные ниже действия, чтобы импортировать пары "ключ-значение" и флаги признаков из хранилища Конфигурации приложений Azure.

Портал

На портале Azure сделайте следующее:

1. Перейдите в хранилище Конфигурация приложений и выберите "Импорт и экспорт" в меню "Операции".

   

2. Переключатель импорта выбран по умолчанию. В разделе "Исходный тип" выберите Конфигурация приложений.

3. Выберите хранилище Конфигурация приложений для импорта данных и заполните форму следующими параметрами:

   Параметр	Описание	Пример
   Отток подписок	Текущая подписка выбрана по умолчанию.	my-subscription
   Группа ресурсов	Выберите группу ресурсов с хранилищем Конфигурации приложений с конфигурацией, которую требуется импортировать. Ваша текущая группа ресурсов будет выбрана по умолчанию.	my-resource-group
   Ресурс	Выберите хранилище Конфигурации приложений, содержащее конфигурацию, которую требуется импортировать.	my-other-app-config-store

4. Заполните следующую часть формы:

   Параметр	Описание	Пример
   Режим выбора	Выберите, следует ли импортировать из обычных значений ключей, которые являются параметром по умолчанию или из моментального снимка.	По умолчанию
   Фильтр ключей	Используется для фильтрации значений ключей на основе имени ключа для импорта. Если ключи не указаны, все ключи имеют право.	Начинается с тестирования
   В определенное время	Необязательно. Заполните это поле, чтобы импортировать значения ключей из определенной точки во времени в выбранном хранилище конфигурации. Если оставить пустым, по умолчанию используется текущая точка во времени значений ключей.	28.07.2022 00:00:00
   Из метки	Выберите одну или несколько меток для импорта значений ключей, связанных с этими метками. Если метка не выбрана, все метки имеют право.	тыкать
   Исключить флаг компонента	При проверке флаги компонентов не будут импортированы.	Флажок снят
   Добавление префикса	Необязательно. Если задано, префикс будет добавлен в имена ключей всех импортированных значений ключей.	TestApp:
   Переопределение меток	Необязательно. По умолчанию исходные метки исходных ключевых значений сохраняются. Чтобы переопределить их, установите флажок и введите новую метку для импортированных значений ключей.	новую
   Переопределение типов контента	Необязательно. По умолчанию исходные типы контента исходных ключевых значений сохраняются. Чтобы переопределить их, установите флажок и введите новый тип контента для импортированных значений ключей. Обратите внимание, что не удается переопределить тип контента флагов компонентов.	JSON (application/json)

5. Выберите Применить, чтобы продолжить импорт.

Вы импортировали значения ключей из хранилища Конфигурация приложений с 28 января 2021 г. в 12:00 с именами ключей, начиная с test меткиprod. Имена ключей были префиксированы.TestApp: Все импортированные значения ключей были назначены меткой new и типом application/jsonконтента.

Azure CLI

В Azure CLI выполните указанные ниже действия. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

1. Введите команду импорта az appconfig kv import и укажите следующие параметры:

   Параметр	Описание	Пример
   --name	Введите имя хранилища Конфигурации приложений, в которое вы хотите импортировать данные.	my-app-config-store
   --source	Введите appconfig, чтобы указать, что вы импортируете данные из хранилища Конфигурации приложений.	appconfig
   --src-name	Введите имя хранилища Конфигурации приложений, из которого вы хотите импортировать данные.	my-source-app-config
   --src-label	Ограничьте импорт значениями ключей с определенной меткой. Если этот параметр не используется, импортируются только значения ключей с меткой NULL. В качестве фильтра поддерживается знак звездочки: введите *, чтобы выбрать все метки, или abc*, чтобы выбрать все метки с префиксом abc.	prod

2. При необходимости добавьте следующие параметры:

   Параметр	Описание	Пример
   --label	Необязательно. Введите метку, которая будет назначена импортированным парам "ключ-значение".	new
   --content-type	Необязательно. Введите appconfig/kvset или application/json, чтобы указать, что импортированное содержимое состоит из ссылки на хранилище ключей или JSON-файла. Тип контента можно переопределить только для импортированных пар "ключ-значение". По умолчанию для флагов признаков по умолчанию используется тип контента "application/vnd.microsoft.appconfig.ff+json;charset=utf-8", и изменить его с помощью этого параметра невозможно.	application/json

   Пример: импортируйте значения ключей и флаги функций с меткой "prod" из другой Конфигурация приложений и назначьте им метку new. Добавьте тип контента 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. В командной строке отобразится список предстоящих изменений. Выберите y, чтобы подтвердить импорт.

   

Вы импортировали значения ключей с меткой "prod" из хранилища Конфигурация приложений и назначили им метку new. Все импортированные значения ключей имеют тип контента в формате JSON.

Другие необязательные параметры и примеры см. в описании команды az appconfig kv import.

Импорт данных из Службы приложений Azure

Чтобы импортировать пары "ключ-значение" из Службы приложений Azure, выполните указанные ниже действия.

Примечание.

Служба приложений в настоящее время не поддерживает флаги признаков. Все флаги признаков, импортированные в Службу приложений, автоматически преобразуются в пары "ключ-значение". Ресурсы Службы приложений могут содержать только пары "ключ-значение".

Портал

На портале Azure

1. Перейдите в хранилище Конфигурация приложений и выберите "Импорт и экспорт" в меню "Операции".

   

2. Переключатель импорта выбран по умолчанию. В разделе "Исходный тип" выберите Служба приложений.

3. Выберите хранилище Конфигурация приложений для импорта данных и заполните форму следующими параметрами:

   Параметр	Описание	Пример
   Отток подписок	Текущая подписка выбрана по умолчанию.	my-subscription
   Группа ресурсов	Выберите группу ресурсов, которая содержит Службу приложений с конфигурацией, которую требуется импортировать.	my-resource-group
   Ресурс	Выберите Службу приложений, содержащую конфигурацию, которую требуется импортировать.	my-app-service

4. Заполните следующую часть формы:

   Параметр	Описание	Пример
   Обновление параметров для ссылки	При проверке параметры приложения в Служба приложений будут обновлены до Конфигурация приложений ссылок на импортированные значения ключей. Это позволяет управлять параметрами приложения в Конфигурация приложений вперед. Служба приложений автоматически извлекнет текущее значение из Конфигурация приложений. Дополнительные сведения см. в статье "Использование ссылок Конфигурация приложений для Служба приложений и Функции Azure".	Помечено
   Добавление префикса	Необязательно. Если задано, префикс будет добавлен в имена ключей всех импортированных значений ключей.	TestApp:
   Добавить метку	Необязательно. Если задано, указанная метка будет назначена всем импортированным значениям ключей.	тыкать
   Добавление типа контента	Необязательно. Если задано, указанный тип контента будет добавлен ко всем импортированным значениям ключей.	JSON (application/json)

5. Выберите Применить, чтобы продолжить импорт.

Вы импортировали все параметры приложения из Служба приложений в качестве значений ключей и назначили им метку prod и префиксTestApp:. Все импортированные значения ключей имеют тип application/jsonконтента.

Azure CLI

В Azure CLI выполните указанные ниже действия. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

1. Введите команду импорта az appconfig kv import и добавьте следующие параметры:

   Параметр	Описание	Пример
   --name	Введите имя хранилища Конфигурации приложений, в которое вы хотите импортировать данные.	my-app-config-store
   --source	Введите appservice, чтобы указать, что вы импортируете данные конфигурации приложения из Службы приложений Azure.	appservice
   --appservice-account	Введите идентификатор ARM для Службы приложений или используйте имя Службы приложений, если она находится в той же подписке и группе ресурсов, что и Конфигурация приложений.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service или my-app-service

2. При необходимости также добавьте следующие параметры:

   Параметр	Описание	Пример
   --prefix	Необязательно. Префикс ключа — это начальная часть свойства key-value. Префиксы можно использовать для управления группами ключевых значений в хранилище конфигурации. Этот префикс будет добавлен к передней части свойства "key" каждого импортированного значения ключа.	TestApp:
   --label	Необязательно. Введите метку, которая будет назначена импортированным парам "ключ-значение". Если метка не указана, вашим парам "ключ-значение" будет назначена метка NULL.	prod
   --content-type	Необязательно. Введите appconfig/kvset или application/json, чтобы указать, что импортированное содержимое состоит из ссылки на хранилище ключей или JSON-файла.	application/json

   Чтобы получить значение --appservice-account, используйте команду az webapp show --resource-group <resource-group> --name <resource-name>.

   Пример: импортируйте все параметры приложения из Службы приложений в виде пар "ключ-значение" с меткой "prod" в свое хранилище Конфигурации приложений и добавьте префикс "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. В командной строке отобразится список предстоящих изменений. Выберите y, чтобы подтвердить импорт.

   

Вы импортировали все параметры приложения из Служба приложений в качестве значений ключей, назначили им метку prod и добавили префикс TestApp:. Все импортированные значения ключей имеют тип контента в формате JSON.

Другие необязательные параметры и примеры см. в описании команды az appconfig kv import.

Экспорт данных

Операция экспорта позволяет записать данные конфигурации, хранящиеся в Конфигурации приложений, в другое место назначения. Функция экспорта позволяет, к примеру, сохранять данные из хранилища Конфигурации приложений в файл, который может быть внедрен в код приложения во время развертывания.

В этом руководстве показано, как экспортировать данные Конфигурации приложений:

• в файл конфигурации в формате JSON, YAML или свойств;
• в хранилище Конфигурации приложений;
• в ресурс Службы приложений Azure.

Экспорт данных в файл конфигурации

Выполните следующие действия, чтобы экспортировать данные конфигурации из хранилища Конфигурация приложений в ФАЙЛ JSON, YAML или Properties.

Портал

На портале Azure сделайте следующее:

1. Перейдите в хранилище Конфигурация приложений и выберите (Импорт и экспорт).

   

2. Нажмите переключатель "Экспорт" и в разделе "Целевой тип" выберите файл конфигурации.

3. Заполните форму, указав следующие параметры:

   Параметр	Описание	Пример
   Тип файла	Выберите тип файла для экспорта: YAML, Properties или JSON.	JSON
   Профиль содержимого файла	Выберите профиль содержимого: default или KVSet. Профиль содержимого файла по умолчанию относится к стандартной схеме файлов конфигурации, широко принятой существующими платформами программирования или системами, поддерживает форматы файлов JSON, Yaml или Properties. Профиль содержимого файла KVSet ссылается на схему файла, содержащую все свойства Конфигурация приложений key-value, включая ключ, значение, метку, тип контента и теги.	По умолчанию
   Режим выбора	Выберите, следует ли экспортировать из обычных значений ключей, которые являются параметром по умолчанию или из моментального снимка.	По умолчанию
   Фильтр ключей	Используется для фильтрации значений ключей на основе имени ключа для экспорта. Если ключи не указаны, все ключи имеют право.	Начинается с TestApp:
   В определенное время	Необязательно. Заполните это поле для экспорта значений ключей из определенной точки во времени в выбранном хранилище конфигурации. Если оставить пустым, по умолчанию используется текущая точка во времени значений ключей.	28.07.2022 00:00:00
   Из метки	Выберите метку для экспорта значений ключей, связанных с этими метками. Если метка не выбрана, все метки имеют право. Обратите внимание, что при экспорте с помощью профиля содержимого Default файла можно выбрать только одну метку. Чтобы экспортировать значения ключей с несколькими метками, используйте профиль содержимого KVSet файла.	тыкать
   Удаление префикса	Необязательно. Если задано, префикс будет удален из имен ключей всех экспортированных значений ключей, содержащих его.	TestApp:
   Разделитель	Разделитель — это разделитель, используемый для сегментирования имен ключей и восстановления иерархических конфигураций для ФАЙЛОВ JSON или YAML из значений ключей. Он будет игнорироваться для файлов свойств и флагов компонентов. Поддерживаемые значения включают разделитель, период (.), запятую (,), точку с запятой (;), дефис (-), символ подчеркивания (_), двойный символ подчеркивания (__), косую черту (/) и двоеточие (:)).	:

4. Нажмите Экспорт для завершения экспорта.

Вы экспортировали значения ключей из хранилища Конфигурация приложений по состоянию на 28 июля 2021 г. в 12:00 с именами ключей, начиная с TestApp: меткиprod, в JSON-файл. Префикс TestApp: был обрезан из имен ключей, и разделитель : использовался для сегментирования имен ключей и восстановления иерархического формата JSON.

Azure CLI

В Azure CLI выполните указанные ниже действия. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

1. Введите команду экспорта az appconfig kv export и добавьте следующие параметры:

   Параметр	Описание	Пример
   --name	Введите имя хранилища Конфигурации приложений, содержащего пары "ключ-значение", которые требуется экспортировать.	my-app-config-store
   --destination	Введите file, чтобы указать, что данные экспортируются в файл.	file
   --path	Укажите путь, по которому требуется сохранить файл.	C:/Users/john/Downloads/data.json
   --format	Введите yaml, properties или json, чтобы указать формат файла, который требуется экспортировать.	json
   --label	Введите метку для экспорта ключевых значений и флагов компонентов с этой меткой. Если метка не указана, по умолчанию экспортируются только ключевые значения и флаги компонентов без меток. Вы можете ввести одну метку, ввести несколько меток, разделив их с ,помощью или используя * их для учета всех меток.	prod

   Внимание

   Если вы не выберете метку, будут экспортированы только ключевые значения без меток. Чтобы экспортировать пару "ключ-значение" с меткой, необходимо выбрать ее метку.

2. При необходимости также добавьте следующие параметры:

   Параметр	Описание	Пример
   --separator	Необязательно. Разделитель — это символ для выравнивания пар "ключ-значение" в файле JSON или YAML. Он необходим для экспорта иерархической структуры и игнорируется для файлов свойств и флагов признаков. Выберите один из следующих вариантов: ., ,, :, ;, /, -, _, —.	;
   --prefix	Необязательно. Префикс для обрезки из каждого свойства key-value. Префикс ключа — это начальная часть ключа. Префиксы можно использовать для управления группами ключевых значений в хранилище конфигурации. Префикс игнорируется для флагов признаков.	TestApp:

   Пример: экспорт всех ключевых значений и флагов функций с меткой "prod" в JSON-файл.

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

3. В командной строке отобразится список пар "ключ-значение", экспортируемых в файл. Выберите y, чтобы подтвердить экспорт.

   

Вы экспортировали пары "ключ-значение" и флаги признаков с меткой "prod" в файл конфигурации и обрезали префикс "TestApp". Значения разделяются в файле символом ";".

Другие необязательные параметры и примеры см. в описании команды az appconfig kv export.

Экспорт данных в хранилище Конфигурации приложений

Выполните указанные ниже действия, чтобы экспортировать пары "ключ-значение" и флаги признаков в хранилище Конфигурации приложений Azure.

Вы можете экспортировать значения из одного хранилища Конфигурации приложений в другое или из одного хранилища Конфигурации приложений в то же самое хранилище, если требуется продублировать значения, но применить другие параметры, такие как новая метка или тип контента.

Портал

На портале Azure сделайте следующее:

1. Перейдите в хранилище Конфигурация приложений, содержащее данные, которые вы хотите экспортировать, и выберите "Импорт и экспорт" в меню "Операции".

   

2. Нажмите переключатель "Экспорт" и в разделе "Целевой тип" выберите Конфигурация приложений.

3. Заполните форму, указав следующие параметры:

   Параметр	Описание	Пример
   Режим выбора	Выберите, следует ли экспортировать из обычных значений ключей, которые являются параметром по умолчанию или из моментального снимка.	По умолчанию
   Фильтр ключей	Используется для фильтрации значений ключей на основе имени ключа для экспорта. Если ключи не указаны, все ключи имеют право.	Начинается с TestApp:
   В определенное время	Необязательно. Заполните это поле для экспорта значений ключей из определенной точки во времени в выбранном хранилище конфигурации. Если оставить пустым, по умолчанию используется текущая точка во времени значений ключей.	28.07.2022 00:00:00
   Из метки	Выберите одну или несколько меток для экспорта ключевых значений, связанных с этими метками. Если метка не выбрана, все метки имеют право.	тыкать
   Исключить флаг компонента	При проверке флаги компонентов не будут экспортированы.	Флажок снят

4. Выберите целевое хранилище, заполните форму следующими параметрами:

   Параметр	Описание	Пример
   Отток подписок	Текущая подписка выбрана по умолчанию.	my-subscription
   Группа ресурсов	Выберите группу ресурсов, содержащую хранилище Конфигурация приложений, в котором требуется экспортировать конфигурацию. Ваша текущая группа ресурсов будет выбрана по умолчанию.	my-resource-group
   Ресурс	Выберите хранилище Конфигурация приложений, в котором требуется экспортировать конфигурацию.	my-other-app-config-store

5. Заполните следующую часть формы:

   Параметр	Описание	Пример
   Удаление префикса	Необязательно. Если задано, префикс будет удален из имен ключей всех экспортированных значений ключей, содержащих его.	TestApp:
   Переопределение меток	Необязательно. По умолчанию исходные метки исходных ключевых значений сохраняются. Чтобы переопределить их, установите флажок и введите новую метку для экспортированных значений ключей.	новую
   Переопределение типов контента	Необязательно. По умолчанию исходные типы контента исходных ключевых значений сохраняются. Чтобы переопределить их, установите флажок и введите новый тип контента для экспортированных значений ключей. Обратите внимание, что не удается переопределить тип контента флагов компонентов.	JSON (application/json)

6. Выберите Применить, чтобы продолжить экспорт.

Вы экспортировали значения ключей из хранилища Конфигурация приложений с 28 июля 2022 г. в 12:00 с именами ключей, начиная с TestApp: меткиprod, в другое Конфигурация приложений хранилище. Все экспортированные значения ключей были обрезаны префиксом TestApp:ключа и назначены метка new и тип application/jsonконтента.

Azure CLI

В Azure CLI выполните указанные ниже действия. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

1. Введите команду экспорта az appconfig kv export и укажите следующие параметры:

   Параметр	Описание	Пример
   --name	Введите имя хранилища Конфигурации приложений, содержащего пары "ключ-значение", которые требуется экспортировать.	my-app-config-store
   --destination	Введите appconfig, чтобы указать, что вы экспортируете данные в хранилище Конфигурации приложений.	appconfig
   --dest-name	Введите имя хранилища Конфигурации приложений, в которое вы хотите экспортировать данные.	my-other-app-config-store
   --label	Введите метку для экспорта ключевых значений и флагов компонентов с этой меткой. Если метка не указана, по умолчанию вы экспортируете только ключевые значения и флаги компонентов без меток. Можно ввести одну метку, несколько меток через разделитель , или *, чтобы выбрать все метки в учетной записи.	prod

   Внимание

   Если значения ключей, которые требуется экспортировать, имеют метки, необходимо использовать команду --label и ввести соответствующие метки. Если вы не выберете метку, будут экспортированы только ключевые значения без меток. Используйте знак запятой (,), чтобы выбрать несколько меток, или *, чтобы выбрать все метки, включая NULL (без метки).

2. При необходимости также добавьте следующий параметр:

   Параметр	Описание	Пример
   --dest-label	Необязательно. Введите целевую метку, которую хотите назначить экспортированным парам "ключ-значение".	new

   Пример: экспортируйте значения ключей и флаги функций с меткой "prod" в другое хранилище Конфигурация приложений и добавьте метку назначения "new".

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

3. В командной строке отобразится список пар "ключ-значение", экспортируемых в файлы. Выберите y, чтобы подтвердить экспорт.

   

Вы экспортировали значения ключей и флаги компонентов, которые имеют метку "prod" из хранилища Конфигурация приложений и назначили им метку new.

Другие необязательные параметры и примеры см. в описании команды az appconfig kv import.

Экспорт данных в Службу приложений Azure

Чтобы экспортировать пары "ключ-значение" в Службу приложений Azure, выполните указанные ниже действия.

Примечание.

Экспорт флагов компонентов в Служба приложений не поддерживается.

Портал

На портале Azure сделайте следующее:

1. Перейдите в хранилище Конфигурация приложений и выберите "Импорт и экспорт" в меню "Операции".

   

2. Нажмите переключатель "Экспорт" и в разделе "Целевой тип" выберите Служба приложений.

3. Параметр "Экспорт в качестве ссылки " установлен по умолчанию. Если флажок установлен, параметры приложения в Служба приложений будут добавлены как Конфигурация приложений ссылки для экспортированных значений ключей. Это позволяет управлять параметрами в Конфигурация приложений с помощью Служба приложений автоматического извлечения текущих значений из Конфигурация приложений. Дополнительные сведения см. в статье "Использование ссылок Конфигурация приложений для Служба приложений и Функции Azure". Если флажок снят, ключ и значение будут экспортированы непосредственно в Служба приложений. Не забудьте снова экспортировать данные при внесении изменений в Конфигурация приложений, чтобы убедиться, что приложение получает обновления.

4. Заполните форму, указав следующие параметры:

   Параметр	Описание	Пример
   Режим выбора	Выберите, следует ли экспортировать из обычных значений ключей, которые являются параметром по умолчанию или из моментального снимка.	По умолчанию
   Фильтр ключей	Используется для фильтрации значений ключей на основе имени ключа для экспорта. Если ключи не указаны, все ключи имеют право.	Начинается с TestApp:
   В определенное время	Необязательно. Заполните это поле для экспорта значений ключей из определенной точки во времени в выбранном хранилище конфигурации. Если оставить пустым, по умолчанию используется текущая точка во времени значений ключей.	28.07.2022 00:00:00
   Из метки	Выберите одну метку, чтобы экспортировать значения ключей, связанные с этой меткой.	тыкать

5. Выберите целевое хранилище и заполните форму следующими параметрами:

   Параметр	Описание	Пример
   Отток подписок	Текущая подписка выбрана по умолчанию.	my-subscription
   Группа ресурсов	Выберите группу ресурсов, содержащую Служба приложений, в которой требуется экспортировать конфигурацию.	my-resource-group
   Ресурс	Выберите Служба приложений, где нужно экспортировать конфигурацию.	my-app-service

6. При необходимости заполните следующую часть формы:

   Параметр	Описание	Пример
   Удаление префикса	Необязательно. Если задано, префикс будет удален из имен ключей всех экспортированных значений ключей, содержащих его.	TestApp:

7. Выберите Применить, чтобы продолжить экспорт.

Вы экспортировали значения ключей из хранилища Конфигурация приложений по состоянию на 28 июля 2022 г. в 12:00, с именами ключей, начиная с TestApp: меткиprod, в параметры приложения Служба приложений ресурса. Префикс TestApp: был обрезанный из экспортированных имен ключей.

Если вы установите флажок для экспорта значений ключей в качестве ссылок, экспортированные значения ключей указываются как Конфигурация приложений ссылки в столбце "Источник" параметров конфигурации ресурсов Служба приложений.

Azure CLI

В Azure CLI выполните указанные ниже действия. Если у вас нет Azure CLI, установленного локально, можно использовать Azure Cloud Shell.

1. Введите команду экспорта az appconfig kv export и укажите следующие параметры:

   Параметр	Описание	Пример
   --name	Введите имя хранилища Конфигурации приложений, содержащего пары "ключ-значение", которые требуется экспортировать.	my-app-config-store
   --destination	Введите appservice, чтобы указать, что данные экспортируются в Службу приложений.	appservice
   --appservice-account	Введите идентификатор ARM для Службы приложений или используйте имя Службы приложений, если она находится в той же подписке и группе ресурсов, что и Конфигурация приложений.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service или my-app-service
   --label	Необязательно. Введите метку для экспорта ключевых значений и флагов компонентов с этой меткой. Если метка не указана, по умолчанию вы экспортируете только ключевые значения и флаги компонентов без меток.	prod

   Чтобы получить значение --appservice-account, используйте команду az webapp show --resource-group <resource-group> --name <resource-name>.

2. При необходимости также добавьте префикс:

   Параметр	Описание	Пример
   --prefix	Необязательно. Префикс для обрезки из экспортированного свойства key-value. Префикс ключа — это начальная часть ключа. Префиксы можно использовать для управления группами ключевых значений в хранилище конфигурации.	TestApp:

   Пример: экспортируйте все пары "ключ-значение" с меткой "prod" в приложение Службы приложений с обрезкой префикса "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:
   

   В командной строке отображается список ключевых значений, экспортируемых в ресурс Служба приложений. Выберите y, чтобы подтвердить экспорт.

   

   Вы экспортировали все значения ключей с меткой prod в ресурс службы приложение Azure и обрезали префикс TestApp:.

3. При необходимости укажите флаг для экспорта в качестве Конфигурация приложений ссылки.

   Параметр	Описание
   --export-as-reference -r	Необязательно. Укажите, экспортируются ли значения ключей в Служба приложений в виде Конфигурация приложений ссылок. Подробнее.

   Пример. Экспорт всех значений ключей с меткой prod в качестве ссылок на конфигурацию приложения в приложение Служба приложений.

   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
   

   В командной строке отображается список ключевых значений, экспортируемых в виде ссылок на конфигурацию приложения в ресурс Служба приложений. Выберите y, чтобы подтвердить экспорт.

   

   Вы экспортировали все значения ключей с меткой "prod" в качестве ссылок на конфигурацию приложения на ресурс службы приложение Azure. В ресурсе Служба приложений импортированные значения ключей будут указаны как Конфигурация приложений ссылки в столбце Source.

   

Другие необязательные параметры и примеры см. в описании команды az appconfig kv export.

Сообщения об ошибках

При импорте или экспорте Конфигурация приложений ключевых значений могут возникнуть следующие сообщения об ошибках:

• Открытый доступ для вашего хранилища отключен, или вы обращаетесь из частной конечной точки, которая не относится к конфигурациям частных конечных точек хранилища. Если в хранилище Конфигурация приложений включены частные конечные точки, доступ к нему можно получить только из настроенной виртуальной сети по умолчанию. Убедитесь, что компьютер под управлением портал Azure или CLI присоединен к той же виртуальной сети, что и частная конечная точка. Если вы только что включили доступ к общедоступной сети в хранилище Конфигурация приложений, подождите не менее 5 минут, прежде чем повторить попытку, чтобы разрешить кэшу обновляться.

Следующие шаги

Интеграция с конвейером CI/CD