Определение resources.repositories.repository

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

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  trigger: none | trigger | [ string ] # CI trigger for this repository, no CI trigger if skipped (only works for Azure Repos).
  name: string # repository name (format depends on 'type'; does not accept variables).
  ref: string # ref name to checkout; defaults to 'refs/heads/main'. The branch checked out by default whenever the resource trigger fires.
  type: git | github | githubenterprise | bitbucket # Type of repository: git, github, githubenterprise, and bitbucket.

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  trigger: none | trigger | [ string ] # CI trigger for this repository, no CI trigger if skipped (only works for Azure Repos).
  name: string # repository name (format depends on 'type'; does not accept variables).
  ref: string # ref name to checkout; defaults to 'refs/heads/main'. The branch checked out by default whenever the resource trigger fires.
  type: string # Type of repository: git, github, githubenterprise, and bitbucket.

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  trigger: none | trigger | [ string ] # CI trigger for this repository, no CI trigger if skipped (only works for Azure Repos).
  name: string # repository name (format depends on 'type'; does not accept variables).
  type: string # Type of repository: git, github, githubenterprise, and bitbucket.
  ref: string # ref name to checkout; defaults to 'refs/heads/main'. The branch checked out by default whenever the resource trigger fires. Does not accept variables.

Определения, ссылающиеся на это определение: resources.repositories

Свойства

строка . Обязательный в качестве первого свойства.
Псевдоним для указанного репозитория. Допустимые значения: [-_A-Za-z0-9]*.

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

триггер.
Триггер CI для этого репозитория не активируется, если опущен.

Это важно

  • Repository resource triggers поддерживаются только для #REF! Git repositories.
  • Триггеры ресурсов репозитория не поддерживаются .
  • Убедитесь, что ваши триггерные элементы, такие как пути, правильно отступлены; Неправильное уступление может привести к тому, что триггер не сработает как ожидается.

строка .
Имя репозитория. Формат зависит от типа; не принимает переменные.

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

строка .
ссылка на имя для получения; значение по умолчанию — refs/heads/main. Ветвь, извлеченная по умолчанию при срабатывании триггера ресурса. Не принимает переменные.

строка .
Тип репозитория: git, github, githubenterprise и bitbucket.

Замечания

Это важно

Ресурс репозитория не разрешает переменные конвейера в и . Подстановочные знаки поддерживаются в триггерах.

Выражения шаблонов поддерживаются для свойства (но не для свойства). Подстановочные знаки поддерживаются в триггерах.

Это важно

Repository resource triggers поддерживаются только для #REF! Git repositories. Для получения дополнительной информации о синтаксисе trigger, включая поддержку wildcard для branch и теги, см. trigger definition и build #REF! Git или TFS Git репозитории.

Это важно

не поддерживается в триггерах ресурсов репозитория.

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

Типы

Конвейеры поддерживают следующие значения для типа репозитория: , и . Тип git относится к #REF! репозиториям Git.

  • Если указать type: git, значение name относится к названию репозитория #REF! Git.

    • Если ваш конвейер находится в том же Azure DevOps проекте, что и репозиторий, например, в репозитории с названием tools, вы ссылаетесь на него с помощью name: tools.
    • Если ваш конвейер находится в той же Azure DevOps организации, что и репозиторий, но в другом Azure DevOps проекте, например, проекте с именем ToolsProject, вы должны уточнить имя репозитория с именем проекта: name: ToolsProject/tools.

  • Если указать type: github, значение name будет полным именем #REF! репозитория и включает пользователя или организацию. Примером является . #REF! репозитории требуют #REF! сервисное подключение для авторизации.

  • Если указать , это полное имя репозитория Bitbucket Cloud и включает пользователя или организацию. Примером является . Bitbucket Cloud repos требует подключения к облачной службе Bitbucket для авторизации.

Дополнительные сведения об этих типах см. в статье о нескольких репозиториях в конвейере — определение ресурса репозитория.

Переменные

В каждом запуске метаданные ресурса репозитория доступны всем заданиям в виде переменных среды выполнения. Это идентификатор, который вы предоставили для ресурса репозитория.

resources.repositories.<Alias>.name
resources.repositories.<Alias>.ref
resources.repositories.<Alias>.type
resources.repositories.<Alias>.id
resources.repositories.<Alias>.url
resources.repositories.<Alias>.version

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

resources:
  repositories:
    - repository: common
      type: git
      ref: main
      name: Repo

variables:
  ref: $[ resources.repositories.common.ref ]
  name: $[ resources.repositories.common.name ]
  id: $[ resources.repositories.common.id ]
  type: $[ resources.repositories.common.type ]
  url: $[ resources.repositories.common.url ]
  version: $[ resources.repositories.common.version ]

steps:
- bash: |
    echo "name = $(name)"
    echo "ref = $(ref)"
    echo "id = $(id)"
    echo "type = $(type)"
    echo "url = $(url)"
    echo "version = $(version)"

Переменные

В каждом запуске метаданные ресурса репозитория доступны всем заданиям в виде переменных среды выполнения. Это идентификатор, который вы предоставили для ресурса репозитория.

resources.repositories.<Alias>.name
resources.repositories.<Alias>.ref
resources.repositories.<Alias>.type
resources.repositories.<Alias>.id
resources.repositories.<Alias>.url

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

resources:
  repositories:
    - repository: common
      type: git
      ref: main
      name: Repo

variables:
  ref: $[ resources.repositories.common.ref ]
  name: $[ resources.repositories.common.name ]
  id: $[ resources.repositories.common.id ]
  type: $[ resources.repositories.common.type ]
  url: $[ resources.repositories.common.url ]

steps:
- bash: |
    echo "name = $(name)"
    echo "ref = $(ref)"
    echo "id = $(id)"
    echo "type = $(type)"
    echo "url = $(url)"

Примеры

resources:
  repositories:
  - repository: common
    type: github
    name: Contoso/CommonTools
    endpoint: MyContosoServiceConnection

См. также

  • Добавление ресурсов в конвейер
  • Last updated on