resources.repositories.repository definition

Med nyckelordet repository kan du ange en extern lagringsplats. Använd en lagringsplatsresurs för att referera till ytterligare en lagringsplats i din pipeline.

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.

Definitioner som refererar till den här definitionen: resources.repositories

Egenskaper

repository Sträng. Krävs som första egenskap.
Alias för den angivna lagringsplatsen. Acceptabla värden: [-_A-Za-z0-9]*.

endpoint Sträng.
ID för tjänstslutpunkten som ansluter till den här lagringsplatsen.

triggerutlösare.
CI-utlösare för den här lagringsplatsen, ingen CI-utlösare om den utelämnas.

Viktigt

• Utlösare för lagringsplatsresurser stöds endast för Git-lagringsplatser i Azure Repos.
• Lagringsplatsresursutlösare stöder batchinte .

name Sträng.
Namn på lagringsplats. Formatet beror på "typ"; accepterar inte variabler.

ref Sträng.
referensnamn till utcheckning; standardvärdet "refs/heads/main". Grenen checkas ut som standard när resursutlösaren utlöses. Malluttryck stöds.

type Sträng.
Typ av lagringsplats: git, github, githubenterprise och bitbucket.

Kommentarer

Malluttryck stöds för egenskapen ref (men inte egenskapen name ). Jokertecken stöds i utlösare.

Viktigt

Utlösare för lagringsplatsresurser stöds endast för Git-lagringsplatser för Azure-lagringsplatser. Mer information om trigger syntax, inklusive stöd för jokertecken för grenar och taggar, finns i utlösardefinition och Skapa Git- eller TFS Git-lagringsplatser för Azure-lagringsplatser.

Viktigt

batch stöds inte i lagringsplatsens resursutlösare.

Om din pipeline har mallar på en annan lagringsplats, eller om du vill använda utcheckning med flera lagringsplatser med en lagringsplats som kräver en tjänstanslutning, måste du meddela systemet om lagringsplatsen.

Typer

Pipelines stöder följande värden för lagringsplatstypen: git, githuboch bitbucket. Typen git refererar till Git-lagringsplatser för Azure-lagringsplatser.

• Om du anger type: gitname refererar värdet till namnet på en Azure Repos Git-lagringsplats.

  • Om din pipeline finns i samma Azure DevOps-projekt som lagringsplatsen, till exempel en lagringsplats med namnet tools, refererar du till den med hjälp av name: tools.
  • Om din pipeline finns i samma Azure DevOps-organisation som lagringsplatsen, men i ett annat Azure DevOps-projekt, till exempel ett projekt med namnet ToolsProject, måste du kvalificera lagringsplatsens namn med projektnamnet: name: ToolsProject/tools.

• Om du anger type: githubname är värdet det fullständiga namnet på GitHub-lagringsplatsen och inkluderar användaren eller organisationen. Ett exempel är name: Microsoft/vscode. GitHub-lagringsplatser kräver en GitHub-tjänstanslutning för auktorisering.

• Om du anger type: bitbucketname är värdet det fullständiga namnet på Bitbucket Cloud-lagringsplatsen och inkluderar användaren eller organisationen. Ett exempel är name: MyBitbucket/vscode. Bitbucket Cloud-lagringsplatser kräver en Bitbucket Cloud-tjänstanslutning för auktorisering.

Mer information om dessa typer finns i Check out multiple repositories in your pipeline - Repository resource definition (Kolla in flera lagringsplatser i din pipeline – resursdefinition för lagringsplats).

Variabler

I varje körning är metadata för en lagringsplatsresurs tillgängliga för alla jobb i form av körningsvariabler. <Alias> är den identifierare som du gav för din lagringsplatsresurs.

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

I följande exempel finns en lagringsplatsresurs med aliaset common, och lagringsplatsens resursvariabler används med .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)"

Exempel

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

Se även

• Lägga till resurser i en pipeline