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: 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

repository 문자열입니다. 첫 번째 속성으로 필요합니다.
지정된 리포지토리의 별칭을 . 허용되는 값: [-_A-Za-z0-9]*.

endpoint 문자열입니다.
이 리포지토리에 연결하는 서비스 엔드포인트의 ID를 .

trigger 트리거.
이 리포지토리에 대한 CI 트리거를 생략하면 CI 트리거가 없습니다.

name 문자열입니다.
리포지토리 이름입니다. 형식은 'type'에 따라 달라집니다. 는 변수를 허용하지 않습니다.

ref 문자열입니다.
체크 아웃에 참조 이름을 ; 기본값은 'refs/heads/main'입니다. 리소스 트리거가 발생할 때마다 분기가 기본적으로 체크 아웃됩니다. 템플릿 식은지원됩니다.

ref 문자열입니다.
체크 아웃에 참조 이름을 ; 기본값은 'refs/heads/main'입니다. 리소스 트리거가 발생할 때마다 분기가 기본적으로 체크 아웃됩니다. 변수를 허용하지 않습니다.

type 문자열입니다.
리포지토리 유형: git, github, githubenterprise 및 bitbucket입니다.

ref 지원되지만 name 속성은 지원되지 않습니다. 와일드카드는 트리거에서 지원됩니다.

파이프라인에 다른 리포지토리 템플릿이 있거나 서비스 연결이 필요한 리포지토리와 함께 다중 리포지토리 체크 아웃 사용하려는 경우 해당 리포지토리에 대해 시스템에 알려야 합니다.

변수

각 실행에서 리포지토리 리소스에 대한 메타데이터는 런타임 변수 형식의 모든 작업에 사용할 수 있습니다. <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)"