Udostępnij za pośrednictwem


resources.repositoryies.repository definition

Słowo repository kluczowe umożliwia określenie repozytorium zewnętrznego. Użyj zasobu repozytorium, aby odwołać się do dodatkowego repozytorium w potoku.

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.

Definicje odwołujące się do tej definicji: resources.repozytoria

Właściwości

repository Ciąg. Wymagane jako pierwsza właściwość.
Alias dla określonego repozytorium. Dopuszczalne wartości: [-_A-Za-z0-9]*.

endpoint Ciąg.
Identyfikator punktu końcowego usługi łączącego się z tym repozytorium.

triggerwyzwalacz.
Wyzwalacz ciągłej integracji dla tego repozytorium, bez wyzwalacza ciągłej integracji w przypadku pominięcia.

Ważne

  • Wyzwalacze zasobów repozytorium są obsługiwane tylko w przypadku repozytoriów git Azure Repos.
  • Wyzwalacze zasobów repozytorium nie obsługują batchpolecenia .

name Ciąg.
Nazwa repozytorium. Format zależy od typu; nie akceptuje zmiennych.

ref Ciąg.
ref name to checkout; wartość domyślna to "refs/head/main". Gałąź jest domyślnie wyewidencjonowana za każdym razem, gdy wyzwalacz zasobu zostanie wyewidencjonowany. Wyrażenia szablonu są obsługiwane.

ref Ciąg.
ref name to checkout; wartość domyślna to "refs/head/main". Gałąź jest domyślnie wyewidencjonowana za każdym razem, gdy wyzwalacz zasobu zostanie wyewidencjonowany. Nie akceptuje zmiennych.

type Ciąg.
Typ repozytorium: git, github, githubenterprise i bitbucket.

Uwagi

Ważne

Zasób repozytorium nie zezwala na zmienne potoku w systemie name i ref. Symbole wieloznaczne są obsługiwane w wyzwalaczach.

Wyrażenia szablonu są obsługiwane dla ref właściwości (ale nie name dla właściwości). Symbole wieloznaczne są obsługiwane w wyzwalaczach.

Ważne

Wyzwalacze zasobów repozytorium są obsługiwane tylko w przypadku repozytoriów git Azure Repos. Aby uzyskać więcej informacji na trigger temat składni, w tym obsługi symboli wieloznacznych dla gałęzi i tagów, zobacz definicje wyzwalacza i tworzenie repozytoriów Git Azure Repos Git lub TFS.

Ważne

batch nie jest obsługiwany w wyzwalaczach zasobów repozytorium.

Jeśli potok zawiera szablony w innym repozytorium, musisz poinformować system o tym repozytorium.

Jeśli potok zawiera szablony w innym repozytorium lub jeśli chcesz użyć wyewidencjonowania wielu repozytoriów z repozytorium, które wymaga połączenia z usługą, musisz poinformować system o tym repozytorium.

Typy

Potoki obsługują następujące wartości dla typu repozytorium: git, githubi bitbucket. Typ git odnosi się do Azure Repos repozytoriów Git.

  • Jeśli określisz type: gitwartość , name odwołuje się do nazwy repozytorium Azure Repos Git.

    • Jeśli potok znajduje się w tym samym projekcie usługi Azure DevOps co repozytorium, na przykład repozytorium o nazwie tools, odwołujesz się do niego przy użyciu polecenia name: tools.
    • Jeśli potok znajduje się w tej samej organizacji usługi Azure DevOps co repozytorium, ale w innym projekcie usługi Azure DevOps, na przykład projekt o nazwie ToolsProject, musisz zakwalifikować nazwę repozytorium z nazwą projektu: name: ToolsProject/tools.
  • Jeśli określisz type: githubwartość , name jest pełną nazwą repozytorium GitHub i zawiera użytkownika lub organizację. Może to być na przykład name: Microsoft/vscode. Repozytoria GitHub wymagają połączenia usługi GitHub na potrzeby autoryzacji.

  • Jeśli określisz type: bitbucketwartość , name jest pełną nazwą repozytorium Bitbucket Cloud i zawiera użytkownika lub organizację. Może to być na przykład name: MyBitbucket/vscode. Repozytoria usługi Bitbucket Cloud wymagają połączenia usługi Bitbucket w chmurze na potrzeby autoryzacji.

Aby uzyskać więcej informacji o tych typach, zobacz Zapoznaj się z wieloma repozytoriami w potoku — definicja zasobu repozytorium.

Zmienne

W każdym przebiegu metadane zasobu repozytorium są dostępne dla wszystkich zadań w postaci zmiennych środowiska uruchomieniowego. Jest <Alias> to identyfikator, który został nadany dla zasobu repozytorium.

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

Poniższy przykład zawiera zasób repozytorium z aliasem common, a do zmiennych zasobów repozytorium uzyskuje się dostęp przy użyciu polecenia 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)"

Zmienne

W każdym przebiegu metadane zasobu repozytorium są dostępne dla wszystkich zadań w postaci zmiennych środowiska uruchomieniowego. Jest <Alias> to identyfikator, który został nadany dla zasobu repozytorium.

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

Poniższy przykład zawiera zasób repozytorium z aliasem common, a do zmiennych zasobów repozytorium uzyskuje się dostęp przy użyciu polecenia 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)"

Przykłady

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

Zobacz też