définition resources.repository.repository

Le mot clé repository vous permet de spécifier un référentiel externe. Utilisez une ressource de référentiel 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: git | github | githubenterprise | bitbucket # Type of repository: git, github, githubenterprise, and bitbucket.

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

Propriétés

chaîne repository. Obligatoire en tant que première propriété.
Alias pour le référentiel spécifié. Valeurs acceptables : [-_A-Za-z0-9]*.

chaîne endpoint.
ID du point de terminaison de service qui se connecte à ce référentiel.

trigger déclencheur.
déclencheur CI pour ce référentiel, aucun déclencheur CI s’il n’est omis.

Important

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

chaîne name.
nom du référentiel . Le format dépend de « type » ; n’accepte pas les variables.

chaîne ref.
nom ref à extraire ; la valeur par défaut est « refs/heads/main ». Branche extraite par défaut chaque fois que le déclencheur de ressource se déclenche. expressions de modèle sont prises en charge.

chaîne type.
Type de référentiel : git, github, githubenterprise et bitbucket.

Remarques

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

Important

Les déclencheurs de ressources de référentiel sont pris en charge uniquement pour les référentiels Git Azure Repos. Pour plus d’informations sur la syntaxe trigger, notamment prise en charge des caractères génériques pour branches et balises, consultez définition de déclencheur et Créer des référentiels Git Azure Repos 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 modèles dans un autre référentiel, ou si vous souhaitez utiliser d’extraction multipo avec un référentiel qui nécessite une connexion de service, vous devez informer le système de ce référentiel.

Les types

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

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

  • Si votre pipeline se trouve dans le même projet Azure DevOps que le référentiel, par exemple un référentiel nommé tools, vous le référencez à l’aide de name: tools.
  • Si votre pipeline se trouve dans la même organisation 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 référentiel avec le nom du projet : name: ToolsProject/tools.

• Si vous spécifiez type: github, la valeur name est le nom complet du dépôt GitHub et inclut l’utilisateur ou l’organisation. 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 valeur name est le nom complet du dépôt Bitbucket Cloud et inclut l’utilisateur ou l’organisation. par exemple name: MyBitbucket/vscode. Les dépôts Bitbucket Cloud nécessitent une connexion de service cloud Bitbucket pour l’autorisation.

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

Variables

Dans chaque exécution, les métadonnées d’une ressource de référentiel sont disponibles pour tous les travaux sous la forme de variables d’exécution. 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 référentiel avec un alias de common, et les variables de ressource de référentiel sont accessibles à l’aide de 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)"

Exemples

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

Voir aussi

• Ajouter des ressources à un pipeline