Auschecken mehrerer Repositorys in Ihrer Pipeline

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Pipelines basieren häufig auf mehreren Repositorys, die Quellen, Tools, Skripts oder andere Elemente enthalten, die Sie zum Erstellen Ihres Codes benötigen. Durch die Verwendung mehrerer checkout-Schritte in Ihrer Pipeline können Sie neben dem Repository, in dem Sie Ihre YAML-Pipeline speichern, auch weitere Repositorys abrufen und auschecken.

Angeben mehrerer Repositorys

Repositorys können als Repositoryressource oder inline mit dem checkout-Schritt angegeben werden.

Die folgenden Repositorytypen werden unterstützt.

Die folgenden Kombinationen von checkout-Schritten werden unterstützt.

Definition einer Repositoryressource

Sie müssen eine Repositoryressource verwenden, wenn Ihr Repositorytyp eine Dienstverbindung oder ein anderes erweitertes Ressourcenfeld benötigt. Die folgenden Repositorytypen erfordern eine Dienstverbindung.

Sie können eine Repositoryressource auch dann verwenden, wenn für Ihren Repositorytyp keine Dienstverbindung erforderlich ist, z. B. wenn Sie bereits eine Repositoryressource für Vorlagen in einem anderen Repository definiert haben.

Im folgenden Beispiel werden drei Repositorys als Repositoryressourcen deklariert. Die Repositoryressourcen für ein Azure Repos Git-Repository in einer anderen Organisation, für GitHub und Bitbucket Cloud erfordern Dienstverbindungen, die als endpoint für diese Repositoryressourcen angegeben werden. Dieses Beispiel umfasst vier checkout-Schritte, in denen die drei als Repositoryressourcen deklarierten Repositorys zusammen mit dem aktuellen self-Repository ausgecheckt werden, das die Pipeline-YAML enthält.

resources:
  repositories:
  - repository: MyGitHubRepo # The name used to reference this repository in the checkout step
    type: github
    endpoint: MyGitHubServiceConnection
    name: MyGitHubOrgOrUser/MyGitHubRepo
  - repository: MyBitbucketRepo
    type: bitbucket
    endpoint: MyBitbucketServiceConnection
    name: MyBitbucketOrgOrUser/MyBitbucketRepo
  - repository: MyAzureReposGitRepository # In a different organization
    endpoint: MyAzureReposGitServiceConnection
    type: git
    name: OtherProject/MyAzureReposGitRepo

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- checkout: self
- checkout: MyGitHubRepo
- checkout: MyBitbucketRepo
- checkout: MyAzureReposGitRepository

- script: dir $(Build.SourcesDirectory)

Wenn das self-Repository den Namen CurrentRepo aufweist, erzeugt der Befehl script die folgende Ausgabe: CurrentRepo MyAzureReposGitRepo MyBitbucketRepo MyGitHubRepo. In diesem Beispiel werden die Namen der Repositorys (wie durch die name-Eigenschaft in der Repositoryressource angegeben) für die Ordner verwendet, da im Check-Out-Schritt kein path angegeben ist. Weitere Informationen zu Repositoryordnernamen und Speicherorten finden Sie im folgenden Abschnitt zum Check-Out-Pfad.

Auschecken mit Inline-Syntax

Wenn für Ihr Repository keine Dienstverbindung erforderlich ist, können Sie es inline mit Ihrem checkout-Schritt deklarieren.

steps:
- checkout: self
- checkout: git://MyProject/MyRepo # Azure Repos Git repository in the same organization

Check-Out-Pfad

Wenn im checkout-Schritt kein path angegeben ist, wird der Quellcode in einem Standardverzeichnis abgelegt. Dieses Verzeichnis ist unterschiedlich, je nachdem, ob Sie ein einzelnes Repository oder mehrere Repositorys auschecken.

• Einzelnes Repository: Wenn Sie in Ihrem Auftrag nur einen einzigen checkout-Schritt oder keinen Check-Out-Schritt verwenden (was checkout: self entspricht), wird Ihr Quellcode in ein Verzeichnis namens s ausgecheckt, das sich in einem Unterordner von (Agent.BuildDirectory) befindet. Wenn (Agent.BuildDirectory) als C:\agent\_work\1 angegeben ist, wird Ihr Code in C:\agent\_work\1\sausgecheckt.

• Mehrere Repositorys: Wenn Sie mehrere checkout-Schritte in Ihrem Auftrag verwenden, wird Ihr Quellcode in Verzeichnisse ausgecheckt, die nach den Repositorys als Unterordner von s in (Agent.BuildDirectory) benannt sind. Wenn (Agent.BuildDirectory) als C:\agent\_work\1 angegeben ist und die Namen Ihrer Repositorys tools und code lauten, wird Ihr Code in C:\agent\_work\1\s\tools und C:\agent\_work\1\s\code ausgecheckt.

  Hinweis

  Wenn im checkout-Schritt kein path angegeben wird, wird anstelle des repository-Werts, der im checkout-Schritt zum Verweis auf das Repository verwendet wird, der Name des Repositorys für den Ordner verwendet.

Wenn ein path für einen checkout-Schritt angegeben ist, wird dieser Pfad relativ zu (Agent.BuildDirectory) verwendet.

Auschecken per Verweis

Sofern Sie keinen spezifischen Verweis angeben, wird der Standardbranch ausgecheckt.

Bei Verwendung der Inline-Syntax geben Sie den Verweis durch Anhängen von @<ref> an. Beispiel:

- checkout: git://MyProject/MyRepo@features/tools # checks out the features/tools branch
- checkout: git://MyProject/MyRepo@refs/heads/features/tools # also checks out the features/tools branch
- checkout: git://MyProject/MyRepo@refs/tags/MyTag # checks out the commit referenced by MyTag.

Wenn Sie eine Repositoryressource verwenden, geben Sie den Verweis mithilfe der Eigenschaft ref an. Im folgenden Beispiel wird der Branch features/tools/ des angegebenen Repositorys ausgecheckt.

resources:
  repositories:
  - repository: MyGitHubRepo
    type: github
    endpoint: MyGitHubServiceConnection
    name: MyGitHubOrgOrUser/MyGitHubRepo
    ref: features/tools

steps:
- checkout: MyGitHubRepo

Im folgenden Beispiel werden Tags verwendet, um den Commit auszuchecken, auf den über MyTag verwiesen wird.

resources:
  repositories:
  - repository: MyGitHubRepo
    type: github
    endpoint: MyGitHubServiceConnection
    name: MyGitHubOrgOrUser/MyGitHubRepo
    ref: refs/tags/MyTag

steps:
- checkout: MyGitHubRepo

trigger:
- main
- feature

resources:
  repositories:
  - repository: A
    type: git
    name: MyProject/A
    ref: main
    trigger:
    - main

  - repository: B
    type: git
    name: MyProject/B
    ref: release
    trigger:
    - main
    - release
steps:
- checkout: self
- checkout: A
- checkout: B

Details zum Repository

Wenn Sie mehrere Repositorys auschecken, stehen einige Details zum self-Repository als Variablen zur Verfügung. Wenn Sie Trigger für mehrere Repositorys verwenden, enthalten einige dieser Variablen stattdessen Informationen über das auslösende Repository. Details zu allen vom Auftrag genutzten Repositorys sind als Vorlagenkontextobjekt namens resources.repositories verfügbar.

Um zum Beispiel den Verweis für ein Repository zu erhalten, bei dem es sich nicht um self handelt, könnten Sie eine Pipeline wie diese schreiben:

resources:
  repositories:
  - repository: other
    type: git
    name: MyProject/OtherTools

variables:
  tools.ref: $[ resources.repositories['other'].ref ]

steps:
- checkout: self
- checkout: other
- bash: |
    echo "Tools version: $TOOLS_REF"

Häufig gestellte Fragen

• Warum kann ich kein Repository aus einem anderen Projekt auschecken? Vorher hat dies funktioniert.
• Warum werde ich beim ersten Versuch, ein anderes Repository auszuchecken, zur Autorisierung von Ressourcen aufgefordert?

Warum kann ich kein Repository aus einem anderen Projekt auschecken? Vorher hat dies funktioniert.

Azure Pipelines stellt eine Einstellung Auftragsautorisierungsbereich auf aktuelles Projekt beschränken bereit. Diese Einstellung bewirkt, dass die Pipeline nicht auf Ressourcen außerhalb des Projekts zugreifen kann, in dem die Pipeline enthalten ist. Diese Einstellung kann entweder auf Organisations- oder Projektebene festgelegt werden. Wenn diese Einstellung aktiviert ist, kann ein Repository in einem anderen Projekt nur dann ausgecheckt werden, wenn Sie explizit Zugriff gewähren. Weitere Informationen finden Sie unter Auftragsautorisierungsbereich.

Warum werde ich beim ersten Versuch, ein anderes Repository auszuchecken, zur Autorisierung von Ressourcen aufgefordert?

Wenn Sie andere Azure Repos Git-Repositorys als das auschecken, das die Pipeline enthält, werden Sie möglicherweise aufgefordert, den Zugriff auf diese Ressource zu autorisieren, bevor die Pipeline zum ersten Mal ausgeführt wird. Diese Eingabeaufforderungen werden auf der Zusammenfassungsseite der Pipelineausführung angezeigt.

Wählen Sie Anzeigen oder Ressourcen autorisieren aus, und befolgen Sie die Anweisungen zum Autorisieren der Ressourcen.

Weitere Informationen finden Sie unter Problembehandlung bei der Autorisierung für eine YAML-Pipeline.