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

  • Статья

Ключевое слово 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: 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.

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  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

Свойства

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

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

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

Важно!

  • Триггеры ресурсов репозитория поддерживаются только для Azure Repos репозиториев Git.
  • Триггеры ресурсов репозитория не поддерживают batch.

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

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

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

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

Комментарии

Важно!

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

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

Важно!

Триггеры ресурсов репозитория поддерживаются только для Azure Repos репозиториев Git. Дополнительные сведения о trigger синтаксисе, включая поддержку подстановочных знаков для ветвей и тегов, см. в разделах Определение триггера и Сборка Azure Repos репозиториев Git или TFS Git.

Важно!

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

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

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

Типы

Конвейеры поддерживают следующие значения для типа репозитория: git, githubи bitbucket. Тип git ссылается на репозитории Azure Repos Git.

  • Если указать type: gitзначение , это name значение ссылается на имя репозитория Azure Repos Git.

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

  • Если указать type: githubзначение , name это полное имя репозитория GitHub, включающее пользователя или организацию. Например, name: Microsoft/vscode. Для авторизации репозиториям GitHub требуется подключение к службе GitHub .

  • Если вы укажете type: bitbucket, name значение будет полным именем репозитория Bitbucket Cloud и включает пользователя или организацию. Например, name: MyBitbucket/vscode. Для авторизации репозиториям Bitbucket Cloud требуется подключение к облачной службе Bitbucket .

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

Переменные

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

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

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

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)"

Переменные

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

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

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

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

См. также раздел