resources.repository.repository definition

  • Artikel

Mit dem repository-Schlüsselwort können Sie ein externes Repository angeben. Verwenden Sie eine Repositoryressource, um auf ein zusätzliches Repository in Ihrer Pipeline zu verweisen.

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.

Definitionen, die auf diese Definition verweisen: resources.repositorys

Eigenschaften

repository Schnur. Erforderlich als erste Eigenschaft.
Alias für das angegebene Repository. Zulässige Werte: [-_A-Za-z0-9]*.

endpoint Schnur.
ID des Dienstendpunkts, der eine Verbindung mit diesem Repository herstellt.

triggerTrigger.
CI-Trigger für dieses Repository, kein CI-Trigger, wenn nicht angegeben.

Wichtig

  • Repositoryressourcentrigger werden nur für Azure Repos Git-Repositorys unterstützt.
  • Repositoryressourcentrigger unterstützen batchnicht .

name Schnur.
Repositoryname. Das Format hängt vom Typ ab; akzeptiert keine Variablen.

ref Schnur.
Name zum Auschecken zurückweisen; wird standardmäßig auf "refs/heads/Standard" festgelegt. Der Branch wird standardmäßig ausgecheckt, wenn der Ressourcentrigger ausgelöst wird. Vorlagenausdrücke werden unterstützt.

ref Schnur.
Name zum Auschecken zurückweisen; wird standardmäßig auf "refs/heads/Standard" festgelegt. Der Branch wird standardmäßig ausgecheckt, wenn der Ressourcentrigger ausgelöst wird. Akzeptiert keine Variablen.

type Schnur.
Repositorytyp: git, github, githubenterprise und bitbucket.

Hinweise

Wichtig

Die Repositoryressource lässt keine Pipelinevariablen in name und zu ref. In Triggern werden Wildcards unterstützt.

Vorlagenausdrücke werden für die ref -Eigenschaft (aber nicht die name -Eigenschaft) unterstützt. In Triggern werden Wildcards unterstützt.

Wichtig

Repositoryressourcentrigger werden nur für Azure Repos Git-Repositorys unterstützt. Weitere Informationen zur trigger Syntax, einschließlich der Unterstützung von Wildcards für Branches und Tags, finden Sie unter Triggerdefinition und Erstellen Azure Repos Git- oder TFS-Git-Repositorys.

Wichtig

batch wird in Repositoryressourcentriggern nicht unterstützt.

Wenn Ihre Pipeline Vorlagen in einem anderen Repository enthält, müssen Sie das System über dieses Repository informieren.

Wenn Ihre Pipeline über Vorlagen in einem anderen Repository verfügt, oder Sie das Auschecken mehrerer Repositorys mit einem Repository verwenden möchten, das eine Dienstverbindung erfordert, müssen Sie das System über dieses Repository informieren.

Typen

Pipelines unterstützen die folgenden Werte für den Repositorytyp: git, github und bitbucket. Der git-Typ bezieht sich auf Azure Repos Git-Repositorys.

  • Wenn Sie angebentype: git, bezieht sich der name Wert auf den Namen eines Azure Repos Git-Repositorys.

    • Wenn sich Ihre Pipeline im selben Azure DevOps-Projekt wie das Repository befindet, z. B. ein Repository namens tools, verweisen Sie mit name: toolsdarauf.
    • Wenn sich Ihre Pipeline im gleichen Azure DevOps-organization wie das Repository befindet, aber in einem anderen Azure DevOps-Projekt, z. B. einem Projekt mit dem NamenToolsProject, müssen Sie den Repositorynamen mit dem Projektnamen qualifizieren: name: ToolsProject/tools.

  • Wenn Sie type: github angeben, ist der name-Wert der vollständige Name des GitHub-Repositorys und enthält die*den Benutzer*in oder die Organisation. z. B. name: Microsoft/vscode. GitHub-Repositorys erfordern eine GitHub-Dienstverbindung für die Autorisierung.

  • Wenn Sie type: bitbucket angeben, ist der name-Wert der vollständige Name des Bitbucket-Cloud-Repositorys und enthält die*den Benutzer*in oder die Organisation. z. B. name: MyBitbucket/vscode. Bitbucket-Cloud-Repositorys erfordern eine Bitbucket-Cloud-Dienstverbindung für die Autorisierung.

Weitere Informationen zu diesen Typen finden Sie unter Überprüfen mehrerer Repositorys in Ihrer Pipeline – Repositoryressourcendefinition.

Variables

In jeder Ausführung sind die Metadaten für eine Repositoryressource für alle Aufträge in Form von Laufzeitvariablen verfügbar. Der <Alias> ist der Bezeichner, den Sie für Ihre Repositoryressource angegeben haben.

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

Das folgende Beispiel enthält eine Repositoryressource mit dem Alias common, und auf die Variable der Repositoryressource wird mithilfe von resources.repositories.common.* zugegriffen.

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

Variables

In jeder Ausführung sind die Metadaten für eine Repositoryressource für alle Aufträge in Form von Laufzeitvariablen verfügbar. Der <Alias> ist der Bezeichner, den Sie für Ihre Repositoryressource angegeben haben.

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

Das folgende Beispiel enthält eine Repositoryressource mit dem Alias common, und auf die Variable der Repositoryressource wird mithilfe von resources.repositories.common.* zugegriffen.

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

Beispiele

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

Weitere Informationen