définition resources.repositories.repository

  • Article

Le mot clé repository vous permet de spécifier un référentiel externe. Utilisez une ressource de dépôt pour référencer un référentiel supplémentaire dans votre 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.

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.

Définitions qui font référence à cette définition : resources.repositories

Propriétés

repository String. Obligatoire comme première propriété.
Alias pour le dépôt spécifié. Valeurs acceptables : [-_A-Za-z0-9]*.

endpoint String.
ID du point de terminaison de service qui se connecte à ce dépôt.

triggerdéclencheur.
Déclencheur CI pour ce dépôt, aucun déclencheur CI s’il est omis.

Important

  • Les déclencheurs de ressources de dépôt sont pris en charge uniquement pour Azure Repos référentiels Git.
  • Les déclencheurs de ressources de dépôt ne prennent pas en charge batch.

name String.
Nom du dépôt. Le format dépend de 'type' ; n’accepte pas les variables.

ref String.
ref name to checkout ; la valeur par défaut est « refs/heads/main ». La branche extraite par défaut chaque fois que le déclencheur de ressource se déclenche. Les expressions de modèle sont prises en charge.

ref String.
ref name to checkout ; la valeur par défaut est « refs/heads/main ». La branche extraite par défaut chaque fois que le déclencheur de ressource se déclenche. N’accepte pas les variables.

type String.
Type de dépôt : git, github, githubenterprise et bitbucket.

Remarques

Important

La ressource de dépôt n’autorise pas les variables de pipeline dans name et ref. Les caractères génériques sont pris en charge dans les déclencheurs.

Les expressions de modèle sont prises en charge pour la ref propriété (mais pas pour la name propriété ). Les caractères génériques sont pris en charge dans les déclencheurs.

Important

Les déclencheurs de ressources de dépôt sont pris en charge pour Azure Repos référentiels Git uniquement. Pour plus d’informations sur la syntaxe, notamment la triggerprise en charge des caractères génériques pour les branches et les balises, consultez Définition de déclencheur et Générer Azure Repos référentiels Git ou TFS Git.

Important

batch n’est pas pris en charge dans les déclencheurs de ressources de référentiel.

Si votre pipeline a des modèles dans un autre dépôt, vous devez informer le système de ce dépôt.

Si votre pipeline a des modèles dans un autre référentiel, ou si vous souhaitez utiliser l’extraction multi-référentiel avec un référentiel qui nécessite une connexion de service, vous devez informer le système de ce référentiel.

Types

Les pipelines prennent en charge les valeurs suivantes pour le type de dépôt : git, githubet bitbucket. Le type git fait référence aux référentiels Git Azure Repos.

  • Si vous spécifiez type: git, la name valeur fait référence au nom d’un dépôt Git Azure Repos.

    • Si votre pipeline se trouve dans le même projet Azure DevOps que le dépôt, par exemple un dépôt nommé tools, vous le référencez à l’aide name: toolsde .
    • Si votre pipeline se trouve dans le même organization Azure DevOps que le dépôt, mais dans un autre projet Azure DevOps, par exemple un projet nommé ToolsProject, vous devez qualifier le nom du dépôt avec le nom du projet : name: ToolsProject/tools.

  • Si vous spécifiez type: github, la name valeur est le nom complet du dépôt GitHub et inclut l’utilisateur ou le organization. par exemple name: Microsoft/vscode. Les dépôts GitHub nécessitent une connexion de service GitHub pour l’autorisation.

  • Si vous spécifiez type: bitbucket, la name valeur est le nom complet du dépôt Bitbucket Cloud et inclut l’utilisateur ou le organization. par exemple name: MyBitbucket/vscode. Les référentiels Bitbucket Cloud nécessitent une connexion au service Bitbucket Cloud pour l’autorisation.

Pour plus d’informations sur ces types, consultez Extraire plusieurs référentiels dans votre pipeline - Définition de ressource de dépôt.

Variables

Dans chaque exécution, les métadonnées d’une ressource de référentiel sont disponibles pour tous les travaux en tant que variables de runtime. L’<Alias> est l’identificateur que vous avez donné pour votre ressource de référentiel.

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

L’exemple suivant contient une ressource de dépôt avec un alias de , et les variables de ressource de dépôt sont accessibles à l’aide commonde 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)"

Variables

Dans chaque exécution, les métadonnées d’une ressource de référentiel sont disponibles pour tous les travaux en tant que variables de runtime. L’<Alias> est l’identificateur que vous avez donné pour votre ressource de référentiel.

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

L’exemple suivant contient une ressource de dépôt avec un alias de , et les variables de ressource de dépôt sont accessibles à l’aide commonde 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 ]

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

Exemples

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

Voir aussi