Kolla in flera lagringsplatser i pipelinen

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

Pipelines förlitar sig ofta på flera lagringsplatser som innehåller källan, verktyg, skript eller andra objekt som du behöver för att kompilera koden. Genom att använda flera checkout steg i pipelinen kan du hämta och checka ut andra lagringsplatser utöver den du använder för att lagra YAML-pipelinen.

Ange flera lagringsplatser

Lagringsplatser kan anges som en lagringsplatsresurs eller infogas checkout i steget.

Följande lagringsplatstyper stöds.

Följande kombinationer av checkout steg stöds.

Resursdefinition för lagringsplats

Du måste använda en lagringsplatsresurs om din lagringsplatstyp kräver en tjänstanslutning eller ett annat fält för utökade resurser. Följande lagringsplatstyper kräver en tjänstanslutning.

Du kan använda en lagringsplatsresurs även om din lagringsplatstyp inte kräver någon tjänstanslutning, till exempel om du redan har definierat en lagringsplatsresurs för mallar på en annan lagringsplats.

I följande exempel deklareras tre lagringsplatser som lagringsplatsresurser. Azure Repos Git-lagringsplatsen i en annan organisation, GitHub och Bitbucket Cloud-lagringsplatsen kräver tjänstanslutningar, som anges som endpoint för dessa lagringsplatsresurser. Det här exemplet innehåller fyra checkout steg som checkar ut de tre lagringsplatser som deklarerats som lagringsplatsresurser tillsammans med den aktuella self lagringsplatsen som innehåller yaml-pipelinen.

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)

Om lagringsplatsen self heter CurrentReposcript genererar kommandot följande utdata: CurrentRepo MyAzureReposGitRepo MyBitbucketRepo MyGitHubRepo. I det här exemplet används namnen på lagringsplatserna (som anges av name egenskapen i lagringsplatsens resurs) för mapparna, eftersom inget path anges i utcheckningssteget. Mer information om lagringsplatsens mappnamn och platser finns i följande avsnitt om sökväg till utcheckning.

Infogad syntaxutcheckning

Om lagringsplatsen inte kräver någon tjänstanslutning kan du deklarera den i din checkout steg.

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

Sökväg till utcheckning

Om inte en path anges i steget placeras källkoden checkout i en standardkatalog. Den här katalogen skiljer sig beroende på om du checkar ut en enskild lagringsplats eller flera lagringsplatser.

• Enskild lagringsplats: Om du har ett enda checkout steg i jobbet, eller om du inte har något utcheckningssteg som motsvarar , checkas källkoden ut till en katalog som heter s som en undermapp (Agent.BuildDirectory)till checkout: self. Om (Agent.BuildDirectory) är C:\agent\_work\1checkas koden ut till C:\agent\_work\1\s.

• Flera lagringsplatser: Om du har flera checkout steg i jobbet checkas källkoden ut till kataloger med namnet efter lagringsplatserna som en undermapp s i i (Agent.BuildDirectory). Om (Agent.BuildDirectory) är C:\agent\_work\1 och dina lagringsplatser namnges tools och codecheckas koden ut till C:\agent\_work\1\s\tools och C:\agent\_work\1\s\code.

  Kommentar

  Om inget path anges i checkout steget används namnet på lagringsplatsen för mappen, inte det repository värde som används för att referera till lagringsplatsen i checkout steget.

Om en path anges för ett checkout steg används den sökvägen i förhållande till (Agent.BuildDirectory).

Checka ut en specifik referens

Standardgrenen är utcheckad om du inte anger en specifik referens.

Om du använder infogad syntax anger du referensen genom att lägga till @<ref>. Till exempel:

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

När du använder en lagringsplatsresurs anger du referensen med egenskapen ref . I följande exempel checkas grenen features/tools/ av den avsedda lagringsplatsen ut.

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

steps:
- checkout: MyGitHubRepo

I följande exempel används taggar för att kolla in incheckningen som refereras av MyTag.

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

Information om lagringsplats

När du checkar ut flera lagringsplatser är viss information om lagringsplatsen self tillgänglig som variabler. När du använder utlösare för flera lagringsplatser har vissa av dessa variabler information om den utlösande lagringsplatsen i stället. Information om alla lagringsplatser som används av jobbet är tillgängliga som ett mallkontextobjekt med namnet resources.repositories.

Om du till exempel vill hämta referensen för en icke-lagringsplatsself kan du skriva en pipeline så här:

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"

Vanliga frågor

• Varför kan jag inte checka ut en lagringsplats från ett annat projekt? Det fungerade tidigare.
• Varför uppmanas jag att auktorisera resurser första gången jag försöker checka ut en annan lagringsplats?

Varför kan jag inte checka ut en lagringsplats från ett annat projekt? Det fungerade tidigare.

Azure Pipelines tillhandahåller en inställning för att Begränsa jobbets auktoriseringsområde till aktuellt projekt, som när den är aktiverad inte tillåter pipelinen att komma åt resurser utanför projektet som innehåller pipelinen. Den här inställningen kan anges på organisations- eller projektnivå. Om den här inställningen är aktiverad kan du inte checka ut en lagringsplats i ett annat projekt om du inte uttryckligen beviljar åtkomst. Mer information finns i Auktoriseringsområde för jobb.

Varför uppmanas jag att auktorisera resurser första gången jag försöker checka ut en annan lagringsplats?

När du checkar ut andra Git-lagringsplatser för Azure Repos än den som innehåller pipelinen kan du uppmanas att auktorisera åtkomst till resursen innan pipelinen körs för första gången. Dessa uppmaningar visas på sammanfattningssidan för pipeline-körningen.

Välj Visa eller Auktorisera resurser och följ anvisningarna för att auktorisera resurserna.

Mer information finns i Felsöka auktorisering för en YAML-pipeline.