resources.repository.repository definition

Mit dem schlüsselwort repository 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.

Definitionen, die auf diese Definition verweisen: resources.repositories

Eigenschaften

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

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

trigger auslösen.
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 Zeichenfolge.
Repositoryname. Das Format hängt vom Typ ab; akzeptiert keine Variablen.

ref Zeichenfolge.
Bezugsname zum Auschecken; ist standardmäßig auf "refs/heads/main" festgelegt. Die Verzweigung ist standardmäßig ausgecheckt, wenn die Ressource ausgelöst wird. Vorlagenausdrücke werdenunterstützt.

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

Bemerkungen

Vorlagenausdrücke werden für die eigenschaft ref unterstützt (jedoch nicht die eigenschaft name). Wildcards werden in Triggern unterstützt.

Wichtig

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

Wichtig

batch wird in Triggern für Repositoryressourcen nicht unterstützt.

Wenn Ihre Pipeline Vorlagen in einem anderen Repositoryenthält oder wenn Sie Multi-Repository-Auschecken 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, githubund bitbucket. Der git Typ bezieht sich auf Azure Repos Git-Repositorys.

• Wenn Sie type: gitangeben, verweist der name Wert auf den Namen eines Azure Repos Git-Repositorys.

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

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

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

Weitere Informationen zu diesen Typen finden Sie unter Auschecken mehrerer Repositorys in Ihrer Pipeline – Repositoryressourcendefinition.

Variablen

In jeder Ausführung sind die Metadaten für eine Repositoryressource für alle Aufträge in Form von Laufzeitvariablen verfügbar. Die <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 verfügt über eine Repositoryressource mit einem Alias von common, und auf die Repositoryressourcenvariablen 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)"

Beispiele

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

Siehe auch

• Hinzufügen von Ressourcen zu einer Pipeline-