resources.repository.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.

參考此定義的定義： resources.repositories

屬性

repository 字串。 作為第一個屬性的必要專案。
指定存放庫的別名。 可接受的值：[-_A-Za-z0-9]*。

endpoint 字串。
連線到此存放庫的服務端點識別碼。

trigger觸發程式。
此存放庫的 CI 觸發程式，如果省略 CI 觸發程式，則不會觸發任何 CI 觸發程式。

重要

• 只有Azure Repos Git 存放庫才支援存放庫資源觸發程式。
• 存放庫資源觸發程式不支援 batch 。

name 字串。
存放庫名稱。 格式取決於 'type';不接受變數。

ref 字串。
要簽出的 ref 名稱;預設為 'refs/heads/main'。 每當引發資源觸發程式時，分支預設會取出。 支援範本運算式。

type 字串。
存放庫類型：git、github、githubenterprise 和 bitbucket。

備註

屬性 (支援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)"

範例

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

另請參閱

• 將資源新增至管線