definitie van resources.repositorys.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.

Definities die naar deze definitie verwijzen: resources.repositorys

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.

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

Belangrijk

• Resourcetriggers voor opslagplaatsen worden alleen ondersteund voor Git-opslagplaatsen van Azure-opslagplaatsen.
• Resourcetriggers voor opslagplaatsen bieden geen ondersteuning voor batch.

name tekenreeks.
naam van opslagplaats. Opmaak is afhankelijk van 'type'; accepteert geen variabelen.

ref tekenreeks.
naam voor het uitchecken; is standaard ingesteld op 'refs/heads/main'. De vertakking is standaard uitgecheckt wanneer de resource wordt geactiveerd. sjabloonexpressies worden ondersteund.

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

Opmerkingen

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

Belangrijk

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

Belangrijk

batch wordt niet ondersteund in resourcetriggers van de opslagplaats.

Als uw pijplijn sjablonen in een andere opslagplaats heeft, of als u uitchecken voor 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-opslagplaatsen.

• Als u type: gitopgeeft, verwijst de name waarde naar de naam van een Git-opslagplaats voor 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 type: githubopgeeft, 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 type: bitbucketopgeeft, is de name waarde de volledige naam van de Bitbucket Cloud-opslagplaats en bevat de gebruiker of organisatie. Een voorbeeld is name: MyBitbucket/vscode. Bitbucket Cloud-opslagplaatsen vereisen een Bitbucket Cloud-serviceverbinding voor autorisatie.

Zie Bekijk meerdere opslagplaatsen in uw pijplijn- Resourcedefinitie voor opslagplaatsenvoor 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 commonen de resourcevariabelen van de opslagplaats worden geopend met behulp van 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)"

Voorbeelden

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

Zie ook

• Resources toevoegen aan een pijplijn