Управление подключениями служб

Службы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

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

Например, ваши конвейерные линии могут использовать следующие категории подключений служб:

• Подписки Azure для использования в задачах развертывания веб-сайтов на Azure.
• Различные серверы сборки или файловые серверы, такие как стандартное подключение службы Enterprise Server GitHub к репозиторию GitHub.
• Сетевые среды непрерывной интеграции, такие как подключение службы Jenkins для непрерывной интеграции репозиториев Git.
• Службы, установленные на удаленных компьютерах, например подключение службы Azure Resource Manager к виртуальной машине Azure с управляемым удостоверением службы.
• Внешние службы, такие как подключение службы к реестру Docker, кластеру Kubernetes или репозиторию Maven.

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

Предварительные требования

• Проект и конвейер Azure DevOps.
• Соответствующие назначенные роли пользователей для создания, просмотра, использования или управления подключением к службе. Дополнительные сведения см. в разделе "Разрешения подключения службы".

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

Просмотр подключения службы

Чтобы просмотреть сведения о подключении к службе, в project выберите параметры Project>Service connections и выберите подключение службы, которое требуется просмотреть.

• На вкладке "Обзор " отображаются сведения о подключении к службе, например тип подключения, создатель и тип проверки подлинности.

  Скриншот страницы обзора Azure Resource Manager.

• На вкладке "История использования" отображаются сведения об использовании подключения к службе.

  

• На вкладке "Утверждения и проверки" отображаются утверждения и проверки, позволяющие этапу конвейера использовать подключение к службе. Чтобы добавить утверждения и проверки, выберите + символ или добавить новый.

  

Изменение подключения к службе

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

• Вы также можете выбрать "Безопасность " или "Удалить " в меню "Дополнительные параметры ". Дополнительные сведения об управлении разрешениями безопасности см. в разделе "Настройка разрешений подключения службы".

• Чтобы изменить существующие утверждения и проверки, выберите в меню "Дополнительные параметры " рядом с утверждением на вкладке "Утверждения и проверки ".

Используйте подключение службы

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

• Для конвейеров YAML используйте имя подключения в коде, например azureSubscription, или другое значение имени подключения.

  

• Для классических потоков выберите имя подключения в подписке Azure или другое имя подключения в задаче потока.

  

Авторизация конвейеров

• Чтобы авторизовать один конвейер обработки для использования подключения к сервису:

  1. Выберите «Запустить конвейер» на странице конвейера, чтобы запустить сборку вручную.
  2. Появляется сообщение: "Этот конвейер требует разрешения для доступа к ресурсу, прежде чем выполнение может продолжиться". Выберите "Вид " рядом с сообщением.
  3. На экране "Ожидание проверки" выберите "Разрешение" и на экране подтверждения снова нажмите кнопку "Разрешить".

  Это действие явно добавляет конвейер в качестве авторизованного пользователя подключения к службе.

• Чтобы авторизовать все существующие и будущие конвейеры для использования подключения к службе, выберите параметр "Предоставить доступ ко всем конвейерам" в свойствах подключения. Этот параметр использовать не рекомендуется. Вместо этого авторизуйте каждый конвейер по отдельности для использования подключения к службе.

Типы подключений общего сервиса

Azure Pipelines поддерживает следующие типы подключений службы по умолчанию. Вы также можете создать собственные индивидуальные подключения к службам.

подключение классической службы Azure

Используйте следующие параметры, чтобы определить и защитить подключение к подписке Microsoft Azure, используя учетные данные Azure или сертификат управления Azure.

Для проверки подлинности сертификата выберите "Проверить ", чтобы проверить сведения о подключении.

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

Azure Repos

Подключитесь к организации Azure DevOps или коллекции проектов, используя базовую или токен-аутентификацию. Используйте следующие параметры, чтобы определить и защитить подключение к другой Azure DevOps организации.

Выберите "Проверить", чтобы проверить сведения о подключении.

Дополнительные сведения см. в разделе Аутентификация с помощью персональных токенов доступа для Azure DevOps.

подключение службы Azure Resource Manager

Сведения о создании подключения службы к службе Azure Resource Manager см. в разделе Connect to Azure с помощью подключения службы Azure Resource Manager.

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

Для повышения безопасности используйте задачу Publish To Служебная шина Azure версии 2 вместо подключения службы Служебная шина Azure для отправки сообщения в Служебная шина Azure. Эта версия задачи поддерживает систему Microsoft Entra ID и федерацию удостоверений рабочих нагрузок.

Подключение службы Bitbucket Cloud

Используйте OAuth с авторизацией Grant или имя пользователя и пароль с базовой аутентификацией, чтобы настроить подключение к Bitbucket Cloud. Чтобы конвейеры работали, доступ к репозиторию должен оставаться активным.

Выберите " Проверить или авторизовать ", чтобы проверить сведения о подключении.

Подключение к грузовому сервису

Используйте следующие параметры, чтобы определить и защитить подключение к репозиторию артефактов Cargo .

Подключение службы Chef

Используйте следующие параметры, чтобы определить и защитить подключение к серверу автоматизации Chef .

Подключение службы узла Docker

Используйте следующие параметры, чтобы определить и защитить подключение к узлу Docker.

Дополнительные сведения о защите подключения к узлу Docker см. в разделе "Защита сокета управляющей программы Docker".

Подключение к службе реестра Docker

Вы можете создать подключение службы к реестру контейнеров Docker.

Выберите тип реестра:

Docker Hub или другие

Введите следующие параметры, чтобы определить подключение к реестру Docker Hub или Others.

Перед вводом остальных параметров можно выбрать "Проверить", чтобы проверить учетные данные.

Реестр контейнеров Azure (Реестр контейнеров Azure)

Подключение типовой службы

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

подключение службы GitHub

Используйте следующие параметры, чтобы определить подключение к репозиторию GitHub.

1. Откройте параметры Пользователя из вашего имени аккаунта в правой части заголовка страницы Azure Pipelines.
2. Выберите токены личного доступа.
3. Выберите " Добавить " и введите сведения, необходимые для создания маркера.

Дополнительные сведения см. в статье Источники артефактов — управление версиями.

подключение службы GitHub Enterprise Server

Используйте следующие параметры, чтобы определить подключение к репозиторию GitHub Enterprise.

1. Откройте параметры Пользователя из вашего имени аккаунта в правой части заголовка страницы Azure Pipelines.
2. Выберите токены личного доступа.
3. Выберите " Добавить " и введите сведения, необходимые для создания маркера.

Подключение службы входящих вебхуков

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

Подключение к службе Jenkins

Используйте следующие параметры, чтобы определить подключение к службе Jenkins.

Перед вводом остальных параметров можно выбрать "Проверить", чтобы проверить учетные данные.

Дополнительные сведения см. в статьях "Источники артефактов" - Jenkins.

Подключение службы Jira

Используйте следующие параметры, чтобы определить подключение к службе Jira.

Подключение к службе Kubernetes

При определении подключения к кластеру Kubernetes используйте следующие параметры. Выберите метод проверки подлинности из следующих параметров:

• Kubeconfig
• Сервисная учётная запись
• подписка Azure

Параметр Kubeconfig

Параметр учетной записи службы

Используйте следующую команду, чтобы получить URL-адрес сервера.

kubectl config view --minify -o 'jsonpath={.clusters[0].cluster.server}'

Используйте следующую последовательность команд, чтобы получить объект Secret, необходимый для подключения и проверки подлинности в кластере.

kubectl get serviceAccounts <service-account-name> -n <namespace> -o 'jsonpath={.secrets[*].name}'

В следующей команде замените service-account-secret-name на результат предыдущей команды.

kubectl get secret <service-account-secret-name> -n <namespace> -o json

Скопируйте и вставьте объект Secret, извлекаемый в форме YAML, в текстовое поле Secret.

параметр подписки Azure

Для кластера с поддержкой RBAC Azure служба ServiceAccount создается в выбранном пространстве имен вместе с объектом RoleBinding, чтобы созданный ServiceAccount может выполнять действия только в выбранном пространстве имен.

Для отключенного кластера RBAC Azure служба ServiceAccount создается в выбранном пространстве имен, но созданная служба ServiceAccount имеет права на уровне кластера (между пространствами имен).

Подключение службы Maven

При определении и защите подключения к репозиторию Maven используйте следующие параметры.

Подключение службы npm

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

Подключение службы NuGet

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

Сведения о настройке NuGet для проверки подлинности с помощью Azure Artifacts и других репозиториев NuGet см. в статье NuGet Authenticate.

Другое подключение службы Git

Используйте следующие параметры, чтобы определить и защитить подключение к внешнему серверу репозитория Git. Существует определенное подключение службы для GitHub и GitHub Enterprise Server.

Дополнительные сведения см. в статьях "Источники артефактов".

подключение службы загрузки пакета Python

Используйте следующие параметры при определении и защите подключения к репозиторию Python для скачивания пакетов Python.

Подключение к службе загрузки пакетов Python

Используйте следующие параметры при определении и защите подключения к репозиторию Python для отправки пакетов Python.

Подключение службы Service Fabric

При создании подключения службы к кластеру Service Fabric у вас есть три варианта для метода проверки подлинности: на основе сертификата, учетные данные Microsoft Entra или безопасность Windows с использованием gMSA.

Опция аутентификации на основе сертификатов

параметр проверки подлинности учетных данных Microsoft Entra

Безопасность Windows с использованием параметра проверки подлинности gMSA

Подключение службы SSH

При определении и защите подключения к удаленному узлу с помощью Secure Shell (SSH) используйте следующие параметры.

Дополнительные сведения см. в статье "Задача SSH" и копирование файлов по протоколу SSH.

Подключение службы Subversion

При определении и защите подключения к репозиторию Subversion используйте следующие параметры.

Имя области можно найти несколькими способами:

• Если вы обращаетесь к репозиторию через HTTP или HTTPS: откройте репозиторий в веб-браузере без сохраненных учетных данных. Он использует имя домена в диалоговом окне проверки подлинности.

• Используйте командную строку svn. Если вы сохранили учетные данные, запустите пример svn info https://svnserver/repo. Имя области отображается при запросе ввода пароля.

• Если вы сохранили учетные данные для доступа к репозиторию, найдите имя области аутентификации в одном из файлов в разделе кэша проверки подлинности Subversion профиля пользователя. Например, ~/.subversion/auth/svn/simple или C:\Users\yourname\Application Data\Subversion\auth\svn.simple.

подключение службы Центр приложений Visual Studio

При определении и защите подключения к Центр приложений Visual Studio используйте следующие параметры.

Расширения для других сервисных подключений

Другие типы подключений и задачи службы можно установить в качестве расширений. См. следующие примеры подключений к службе, доступных с помощью расширений:

• Интеграция System Center Virtual Machine Manager (SCVMM). Подключитесь к серверу SCVMM для подготовки виртуальных машин и выполнения действий на них, например:

  • Управление контрольными точками
  • Запуск и остановка виртуальных машин
  • Выполнение скриптов PowerShell

• Развертывание ресурсов VMware. Подключитесь к серверу VMware vCenter Server из Visual Studio Team Services или Team Foundation Server для подготовки, запуска, остановки или моментального снимка виртуальных машин VMware.

• Средства сборки для Power Platform. Используйте средства сборки Microsoft Power Platform для автоматизации распространенных задач сборки и развертывания, связанных с приложениями, созданными на основе Microsoft Power Platform. После установки расширения тип подключения службы Power Platform имеет следующие свойства.

  Параметр	Описание
  Имя подключения	Обязательный. Имя, используемое для ссылки на это подключение к службе в свойствах задачи.
  URL-адрес сервера	Обязательный. URL-адрес экземпляра Power Platform. Пример: https://contoso.crm4.dynamics.com
  Идентификатор клиента	Обязательный. Идентификатор клиента (также называемый идентификатором каталога на портале Azure), к которому нужно пройти аутентификацию. Ознакомьтесь со https://aka.ms/buildtools-spn скриптом, который отображает идентификатор арендатора и настраивает идентификатор приложения, а также связанный с ним секрет клиента. Пользователь приложения также должен быть создан в CDS
  Идентификатор приложения	Обязательный. Идентификатор приложения Azure для аутентификации.
  Секретный ключ клиента для идентификатора приложения	Обязательный. Секрет клиента служебного принципала, связанного с указанным выше идентификатором приложения, используемого для подтверждения личности.

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

Часто задаваемые вопросы и устранение неполадок с сервисными подключениями

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

• Устранение неполадок служебных подключений Azure Resource Manager
• Устранение неполадок с подключениями к службе идентификации рабочей нагрузки

Вопрос: Как Azure DevOps обеспечивает эффективное использование ресурсов Entra ID?

Azure DevOps может кэшировать токены доступа Entra ID, выданные для целевых удостоверений в подключениях служб, использующих проверку подлинности Entra ID, например Azure Resource Manager и Docker Registry. Это помогает предотвратить ограничение Entra ID, которое может произойти из-за большого количества выполнения серверных задач и других действий, требующих, чтобы Azure DevOps аутентифицировался с Entra ID для обработки запроса. Кэширование применяется только к внутренним потокам, в которых маркер никогда не предоставляется пользователю. Если вы получаете токен Entra ID, например в скрипте производственного процесса, он всегда будет выдан заново. Изменение подключения службы аннулирует кэш токенов и временно отключает кэширование для этой конечной точки службы. Если у вас возникли проблемы из-за устаревания токена после изменений в Entra ID, подождите час или попробуйте обновить соответствующую конечную точку службы.

Помощь и поддержка

• Ознакомьтесь с советами по устранению неполадок.
• Получите советы по Stack Overflow.
• Опубликуйте свои вопросы, найдите ответы или предложите функцию в Azure DevOps Сообщество разработчиков.
• Получите суппорт для Azure DevOps.