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

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

Необходимые компоненты

• Подписка Azure — создайте бесплатную учетную запись.
• Конфигурация приложений магазин — создайте его бесплатно
• Проект Azure DevOps — создайте его бесплатно
• Агент Azure Pipelines версии 2.144.0 или более поздней версии и Node версии 16 или более поздней для выполнения задачи на локальных агентах.

Создание подключения службы

Подключение службы обеспечивает получение доступа к ресурсам в подписке Azure из проекта Azure DevOps.

1. В Azure DevOps перейдите к проекту с целевым конвейером. В левом нижнем углу выберите Параметры проекта.

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

3. В разделе Новое подключение службы выберите Azure Resource Manager.

   

4. В диалоговом окне "Метод проверки подлинности" выберите федерацию удостоверений рабочей нагрузки (автоматически), чтобы создать федерацию удостоверений рабочей нагрузки или выбрать федерацию удостоверений рабочей нагрузки (вручную), чтобы использовать существующую федерацию удостоверений рабочей нагрузки.

5. Введите подписку, группу ресурсов и имя подключения к службе.

Если вы создали новую субъект-службу, найдите имя субъект-службы, назначенной для подключения к службе. На следующем шаге мы добавим новое назначение роли этому субъекту-службе.

1. Перейдите в раздел Параметры проекта>Подключения службы.

2. Выберите новое подключение к службе.

3. Выберите Управление субъектом-службой.

4. Запишите значение, указанное в поле Отображаемое имя.

   

Добавление назначения роли

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

1. Перейдите к целевому хранилищу Конфигураций приложений.

2. В меню слева выберите Управление доступом (IAM).

3. В правой области выберите "Добавить назначение ролей".

   

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

5. Выберите субъект-службу, связанный с подключением службы, созданным в предыдущем разделе.

   

6. Выберите Проверить + назначить.

Использование в сборках

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

1. Перейдите на страницу конвейера сборки, щелкнув Pipelines>Pipelines. Дополнительные сведения о конвейерах сборки см. в разделе "Создание первого конвейера".
   • Если создается новый конвейер сборки, на последнем шаге процесса на вкладке Просмотр выберите Показать помощника в правой части конвейера.

     

   • Если вы используете существующий конвейер сборки, нажмите кнопку Изменить в правом верхнем углу.

     

2. Найдите задачу моментального снимка Конфигурация приложений Azure.

   

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

   

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

Использование в выпусках

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

1. Перейдите на страницу конвейера выпуска, выбрав "Выпуски конвейеров>". Дополнительные сведения о конвейерах выпуска см. в разделе "Создание первого конвейера".
2. Выберите существующий конвейер выпуска. Если его нет, выберите + Новый, чтобы создать новый.
3. Нажмите кнопку Изменить в правом верхнем углу, чтобы изменить конвейер выпуска.
4. В раскрывающемся списке Задачи выберите Этап, в который необходимо добавить задачу. Дополнительные сведения о этапах добавления, зависимостях и условиях см. в разделе "Добавление этапов".

   

5. Щелкните + рядом с заданием, к которому нужно добавить новую задачу.

   

6. В диалоговом окне "Добавление задач" введите Конфигурация приложений Azure моментальный снимок в поле поиска и выберите его.
7. Настройте необходимые параметры в задаче для создания моментального снимка в хранилище Конфигурация приложений. Описание параметров дано в разделе Параметры ниже и в подсказках рядом с каждым параметром.
8. Сохраните выпуск и добавьте его в очередь. В журнале выпуска отображаются все сбои, возникающие во время выполнения задачи.

Параметры

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

• Подписка Azure: раскрывающийся список, содержащий доступные подключения служб Azure. Чтобы обновить список доступных подключений служб Azure, нажмите кнопку Обновить подписку Azure справа от текстового поля.

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

• Имя моментального снимка: укажите имя моментального снимка.

• Тип композиции: значение по умолчанию — Ключ.

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

  • Key-Label: фильтры будут применены, и все ключ-значение в результирующем моментальном снимке будут однозначно определены ключом и меткой вместе.

• Фильтры. Представляет фильтр ключей и меток, используемый для создания моментального снимка Конфигурация приложений. Фильтры должны иметь допустимый формат JSON. Пример [{"key":"abc*", "label":"1.0.0"}]. Необходимо указать по крайней мере один фильтр, и можно указать не более трех фильтров.

• Период хранения: значение по умолчанию — 30 дней. Ссылается на количество дней, в течение которых моментальный снимок будет сохранен после архивирования. Архивные моментальные снимки можно восстановить в течение периода хранения.

• Теги: объект JSON в формате{"tag1":"val1", "tag2":"val2"}, который определяет теги, добавляемые к каждому моментальному снимку, созданному в хранилище Конфигурация приложений.

Устранение неполадок

При возникновении непредвиденной ошибки можно включить журналы отладки, задав для переменной конвейера system.debug значение true.

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

Полный справочник по параметрам или использованию этой задачи конвейера в конвейерах YAML см. в следующем документе.

Справочник по задаче моментального снимка Конфигурация приложений Azure

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

Экспорт параметров из Конфигурация приложений с помощью конвейеров Azure

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

Импорт параметров в Конфигурация приложений с помощью конвейеров Azure