Delen via


definitie resources.repositories.repository

Met repository het trefwoord kunt u een externe opslagplaats opgeven. Gebruik een opslagplaatsresource om te verwijzen naar een extra opslagplaats in uw pijplijn.

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.

Definities die naar deze definitie verwijzen: resources.repositories

Eigenschappen

repository Tekenreeks. Vereist als eerste eigenschap.
Alias voor de opgegeven opslagplaats. Acceptabele waarden: [-_A-Za-z0-9]*.

endpoint Tekenreeks.
Id van het service-eindpunt dat verbinding maakt met deze opslagplaats.

triggertrigger.
CI-trigger voor deze opslagplaats, geen CI-trigger als u dit weglaat.

Belangrijk

  • Resourcetriggers voor opslagplaatsen worden alleen ondersteund voor Git-opslagplaatsen in Azure-opslagplaatsen.
  • Triggers voor opslagplaatsresources bieden geen ondersteuning voor batch.

name Tekenreeks.
Naam van opslagplaats. Formaat is afhankelijk van 'type'; accepteert geen variabelen.

ref Tekenreeks.
verw naam om uit te checken; is standaard ingesteld op 'refs/heads/main'. De vertakking is standaard uitgecheckt wanneer de resourcetrigger wordt geactiveerd. Sjabloonexpressies worden ondersteund.

ref Tekenreeks.
verw naam om uit te checken; is standaard ingesteld op 'refs/heads/main'. De vertakking is standaard uitgecheckt wanneer de resourcetrigger wordt geactiveerd. Accepteert geen variabelen.

type Tekenreeks.
Type opslagplaats: git, github, githubenterprise en bitbucket.

Opmerkingen

Belangrijk

Opslagplaatsresource staat geen pijplijnvariabelen toe in name en ref. Jokertekens worden ondersteund in triggers.

Sjabloonexpressies worden ondersteund voor de ref eigenschap (maar niet voor de name eigenschap). Jokertekens worden ondersteund in triggers.

Belangrijk

Resourcetriggers voor opslagplaatsen worden alleen ondersteund voor Git-opslagplaatsen van Azure-opslagplaatsen. Zie triggerdefinitieenBuild Azure Repos Git- of TFS Git-opslagplaatsen voor meer informatie over trigger syntaxis, inclusief ondersteuning voor jokertekens voor vertakkingen en tags.

Belangrijk

batch wordt niet ondersteund in opslagplaatsresourcetriggers.

Als uw pijplijn sjablonen in een andere opslagplaats bevat, moet u het systeem op de hoogte stellen van die opslagplaats.

Als uw pijplijn sjablonen in een andere opslagplaats heeft of als u het uitchecken van meerdere opslagplaatsen wilt gebruiken met een opslagplaats waarvoor een serviceverbinding is vereist, moet u het systeem op de hoogte stellen van die opslagplaats.

Typen

Pijplijnen ondersteunen de volgende waarden voor het type opslagplaats: git, githuben bitbucket. Het git type verwijst naar Git-opslagplaatsen van Azure.

  • Als u opgeeft type: git, verwijst de name waarde naar de naam van een Git-opslagplaats in Azure-opslagplaatsen.

    • Als uw pijplijn zich in hetzelfde Azure DevOps-project bevindt als de opslagplaats, bijvoorbeeld een opslagplaats met de naam tools, verwijst u ernaar met behulp van name: tools.
    • Als uw pijplijn zich in dezelfde Azure DevOps-organisatie bevindt als de opslagplaats, maar in een ander Azure DevOps-project, bijvoorbeeld een project met de naam ToolsProject, moet u de naam van de opslagplaats kwalificeren met de projectnaam: name: ToolsProject/tools.
  • Als u opgeeft type: github, is de name waarde de volledige naam van de GitHub-opslagplaats en bevat deze de gebruiker of organisatie. Een voorbeeld is name: Microsoft/vscode. GitHub-opslagplaatsen vereisen een GitHub-serviceverbinding voor autorisatie.

  • Als u opgeeft type: bitbucket, is de name waarde de volledige naam van de Bitbucket Cloud-opslagplaats en bevat deze de gebruiker of organisatie. Een voorbeeld is name: MyBitbucket/vscode. Bitbucket Cloud-opslagplaatsen vereisen een Bitbucket Cloud-serviceverbinding voor autorisatie.

Zie Meerdere opslagplaatsen in uw pijplijn uitchecken - Resourcedefinitie opslagplaats voor meer informatie over deze typen.

Variabelen

In elke uitvoering zijn de metagegevens voor een opslagplaatsresource beschikbaar voor alle taken in de vorm van runtimevariabelen. De <Alias> is de id die u hebt opgegeven voor uw opslagplaatsresource.

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

Het volgende voorbeeld bevat een opslagplaatsresource met een alias van en de resourcevariabelen van de opslagplaats zijn toegankelijk met behulp van commonresources.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)"

Variabelen

In elke uitvoering zijn de metagegevens voor een opslagplaatsresource beschikbaar voor alle taken in de vorm van runtimevariabelen. De <Alias> is de id die u hebt opgegeven voor uw opslagplaatsresource.

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

Het volgende voorbeeld bevat een opslagplaatsresource met een alias van en de resourcevariabelen van de opslagplaats zijn toegankelijk met behulp van commonresources.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 ]

steps:
- bash: |
    echo "name = $(name)"
    echo "ref = $(ref)"
    echo "id = $(id)"
    echo "type = $(type)"
    echo "url = $(url)"

Voorbeelden

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

Zie ook