définition resources.repository.repository

Le mot clé 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 . Obligatoire en tant que première propriété.
Alias pour le référentiel spécifié. Valeurs acceptables : [-_A-Za-z0-9]*.

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

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 dépôt sont pris en charge uniquement pour les dépôts Azure Repos Git.
• Les déclencheurs de ressources de référentiel ne prennent pas en charge .
• Assurez-vous que vos éléments déclencheurs comme les chemins sont correctement endentés ; Une indentation incorrecte peut faire que votre déclencheur ne fonctionne pas comme prévu.

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

chaîne .
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 de référentiel : git, github, githubenterprise et bitbucket.

Remarques

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

Important

Les déclencheurs de ressources du dépôt sont pris en charge uniquement pour les dépôts Azure Repos Git. Pour plus d’informations sur la syntaxe trigger, y compris le support wildcard pour les branches et les tags, voir trigger definition et Build Azure Repos Git ou TFS Git repositories.

Important

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 : , et . Le type git fait référence à Azure Repos dépôts Git.

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

  • Si votre pipeline est 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 en utilisant name: tools.
  • Si votre pipeline est dans la même organisation Azure DevOps que le dépôt, mais dans un projet Azure DevOps différent, 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 valeur name est le nom complet du dépôt GitHub et inclut l’utilisateur ou l’organisation. par exemple . GitHub dépôts nécessitent une connexion de service GitHub pour l’autorisation.

• Si vous spécifiez , la valeur est le nom complet du dépôt Bitbucket Cloud et inclut l’utilisateur ou l’organisation. par exemple . 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' 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 , et les variables de ressource de référentiel sont accessibles à l’aide de .

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