Ознакомьтесь с несколькими репозиториями в конвейере

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

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

Указание нескольких репозиториев

Репозитории можно указать в качестве ресурса репозитория или в соответствии с checkout шагом.

Поддерживаются следующие типы репозитория.

Поддерживаются следующие сочетания checkout шагов.

Определение ресурса репозитория

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

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

В следующем примере три репозитория объявляются как ресурсы репозитория. Репозиторий Azure Repos Git в другой организации, GitHub и Ресурсах облачного репозитория Bitbucket требуют подключения к службе, которые указаны в качестве endpoint для этих ресурсов репозитория. В этом примере есть четыре checkout шага, которые проверяют три репозитория, объявленные как ресурсы репозитория, а также текущий self репозиторий, содержащий YAML конвейера.

resources:
  repositories:
  - repository: MyGitHubRepo # The name used to reference this repository in the checkout step
    type: github
    endpoint: MyGitHubServiceConnection
    name: MyGitHubOrgOrUser/MyGitHubRepo
  - repository: MyBitbucketRepo
    type: bitbucket
    endpoint: MyBitbucketServiceConnection
    name: MyBitbucketOrgOrUser/MyBitbucketRepo
  - repository: MyAzureReposGitRepository # In a different organization
    endpoint: MyAzureReposGitServiceConnection
    type: git
    name: OtherProject/MyAzureReposGitRepo

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: self
- checkout: MyGitHubRepo
- checkout: MyBitbucketRepo
- checkout: MyAzureReposGitRepository

- script: dir $(Build.SourcesDirectory)

Если репозиторий self называетсяCurrentRepo, script команда создает следующие выходные данные: CurrentRepo MyAzureReposGitRepo MyBitbucketRepo MyGitHubRepo В этом примере имена репозиториев (как указано name свойством в ресурсе репозитория) используются для папок, так как в шаге извлечения не path указано. Дополнительные сведения о именах и расположениях папок репозитория см. в следующем разделе пути к выходу.

Встроенный синтаксический контроль

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

steps:
- checkout: self
- checkout: git://MyProject/MyRepo # Azure Repos Git repository in the same organization

Путь к извлечению

Если на шаге checkout не указано значениеpath, исходный код помещается в каталог по умолчанию. Этот каталог отличается в зависимости от того, извлекаете ли вы один репозиторий или несколько репозиториев.

• Один репозиторий: если у вас есть один checkout шаг в задании или нет шага получения, который эквивалентен checkout: self, исходный код извлекается в каталог, который s называется вложенной папкой (Agent.BuildDirectory). Если (Agent.BuildDirectory) это C:\agent\_work\1так, код извлекается C:\agent\_work\1\s.

• Несколько репозиториев: если у вас есть несколько checkout шагов в задании, исходный код извлекается в каталоги с именем репозиториев в виде вложенной s (Agent.BuildDirectory)папки. Если (Agent.BuildDirectory) есть C:\agent\_work\1 и ваши репозитории именуются tools , и codeкод извлекается и C:\agent\_work\1\s\tools C:\agent\_work\1\s\code.

  Примечание.

  Если на шаге нет path , checkout имя репозитория используется для папки, а не repository значение, которое используется для ссылки на репозиторий на шаге checkout .

Если для шага задано path значение, используется этот путь относительно (Agent.BuildDirectory).checkout

Извлечение определенного ссылок

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

Если используется встроенный синтаксис, назначьте ссылку путем @<ref>добавления. Например:

- checkout: git://MyProject/MyRepo@features/tools # checks out the features/tools branch
- checkout: git://MyProject/MyRepo@refs/heads/features/tools # also checks out the features/tools branch
- checkout: git://MyProject/MyRepo@refs/tags/MyTag # checks out the commit referenced by MyTag.

При использовании ресурса репозитория укажите ссылку с помощью ref свойства. В следующем примере проверяется features/tools/ ветвь указанного репозитория.

resources:
  repositories:
  - repository: MyGitHubRepo
    type: github
    endpoint: MyGitHubServiceConnection
    name: MyGitHubOrgOrUser/MyGitHubRepo
    ref: features/tools

steps:
- checkout: MyGitHubRepo

В следующем примере используются теги для проверки фиксации, на которую ссылается MyTagссылка.

resources:
  repositories:
  - repository: MyGitHubRepo
    type: github
    endpoint: MyGitHubServiceConnection
    name: MyGitHubOrgOrUser/MyGitHubRepo
    ref: refs/tags/MyTag

steps:
- checkout: MyGitHubRepo

trigger:
- main
- feature

resources:
  repositories:
  - repository: A
    type: git
    name: MyProject/A
    ref: main
    trigger:
    - main

  - repository: B
    type: git
    name: MyProject/B
    ref: release
    trigger:
    - main
    - release
steps:
- checkout: self
- checkout: A
- checkout: B

Сведения о репозитории

При извлечении нескольких репозиториев некоторые сведения о self репозитории доступны в виде переменных. При использовании триггеров с несколькими репозиториями некоторые из этих переменных содержат сведения о триггерном репозитории. Сведения обо всех репозиториях, потребляемых заданием, доступны как объект resources.repositoriesконтекста шаблона.

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

resources:
  repositories:
  - repository: other
    type: git
    name: MyProject/OtherTools

variables:
  tools.ref: $[ resources.repositories['other'].ref ]

steps:
- checkout: self
- checkout: other
- bash: |
    echo "Tools version: $TOOLS_REF"

Вопросы и ответы

• Почему я не могу извлечь репозиторий из другого проекта? (Почему не удается оформить заказ на репозиторий из другого проекта? Раньше все работало.)
• Почему мне предлагается авторизовать ресурсы при первом попытке проверить другой репозиторий?

Почему я не могу извлечь репозиторий из другого проекта? (Почему не удается оформить заказ на репозиторий из другого проекта? Раньше все работало.)

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

Почему мне предлагается авторизовать ресурсы при первом попытке проверить другой репозиторий?

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

Выберите "Просмотреть или авторизовать ресурсы" и следуйте инструкциям по авторизации ресурсов.

Дополнительные сведения см. в разделе Устранение неполадок с авторизацией для конвейера YAML.