definice resources.repositories.repository

  • Článek

Klíčové repository slovo umožňuje zadat externí úložiště. Prostředek úložiště použijte k odkazování na další úložiště ve vašem kanálu.

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.

Definice, které odkazují na tuto definici: resources.repositories

Vlastnosti

repository Řetězec. Povinný argument jako první vlastnost.
Alias pro zadané úložiště. Přijatelné hodnoty: [-_A-Za-z0-9]*.

endpoint Řetězec.
ID koncového bodu služby, který se připojuje k tomuto úložišti.

triggertrigger.
Trigger CI pro toto úložiště, žádný trigger CI, pokud je vynechán.

Důležité

  • Triggery prostředků úložiště se podporují jenom pro úložiště Azure Repos Git.
  • Triggery prostředků úložiště nepodporují batch.

name Řetězec.
Název úložiště. Formát závisí na typu; nepřijímá proměnné.

ref Řetězec.
referenční název k pokladně; výchozí hodnota je refs/heads/main. Větev je ve výchozím nastavení rezervovaná vždy, když se aktivuje aktivační událost prostředku. Podporují se výrazy šablon.

ref Řetězec.
referenční název k pokladně; výchozí hodnota je refs/heads/main. Větev je ve výchozím nastavení rezervovaná vždy, když se aktivuje aktivační událost prostředku. Nepřijímá proměnné.

type Řetězec.
Typ úložiště: github, github, githubenterprise a bitbucket.

Poznámky

Důležité

Prostředek úložiště neumožňuje proměnné kanálu v name a ref. Triggery podporují zástupné cardy.

Výrazy šablony jsou podporovány pro vlastnost ref (ale ne vlastnost name ). Triggery podporují zástupné cardy.

Důležité

Triggery prostředků úložiště se podporují jenom pro Azure Repos úložiště Git. Další informace o trigger syntaxi, včetně podpory zástupných znaků pro větve a značky, najdete v tématu Definice triggeru a Sestavení Azure Repos úložištích Git nebo TFS Git.

Důležité

batch se nepodporuje v triggerech prostředků úložiště.

Pokud váš kanál obsahuje šablony v jiném úložišti, musíte o tom dát systému vědět.

Pokud váš kanál obsahuje šablony v jiném úložišti nebo pokud chcete použít rezervaci s více úložišti s úložištěm, které vyžaduje připojení služby, musíte o tom dát systému vědět.

Typy

Kanály podporují následující hodnoty pro typ úložiště: git, githuba bitbucket. Typ git odkazuje na Azure Repos úložiště Gitu.

  • Pokud zadáte type: git, name hodnota odkazuje na název úložiště Azure Repos Git.

    • Pokud je váš kanál ve stejném projektu Azure DevOps jako úložiště, například úložiště s názvem tools, odkazujete na něj pomocí name: tools.
    • Pokud je váš kanál ve stejné organizaci Azure DevOps jako úložiště, ale v jiném projektu Azure DevOps, například v projektu s názvem ToolsProject, musíte název úložiště kvalifikovat názvem projektu: name: ToolsProject/tools.

  • Pokud zadáte type: github, name hodnota je úplný název úložiště GitHub a zahrnuje uživatele nebo organizaci. Příklad: name: Microsoft/vscode. Úložiště GitHubu vyžadují pro autorizaci připojení služby GitHub .

  • Pokud zadáte type: bitbucket, name hodnota je úplný název úložiště Bitbucket Cloud a zahrnuje uživatele nebo organizaci. Příklad: name: MyBitbucket/vscode. Úložiště Bitbucket Cloud vyžadují připojení ke službě Bitbucket Cloud pro autorizaci.

Další informace o těchto typech najdete v tématu Rezervace více úložišť v kanálu – definice prostředku úložiště.

Proměnné

Při každém spuštění jsou metadata pro prostředek úložiště dostupná pro všechny úlohy ve formě proměnných modulu runtime. Je <Alias> identifikátor, který jste zadali pro prostředek úložiště.

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

Následující příklad obsahuje prostředek úložiště s aliasem commona k proměnným prostředků úložiště se přistupuje pomocí 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)"

Proměnné

Při každém spuštění jsou metadata pro prostředek úložiště dostupná pro všechny úlohy ve formě proměnných modulu runtime. Je <Alias> identifikátor, který jste zadali pro prostředek úložiště.

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

Následující příklad obsahuje prostředek úložiště s aliasem commona k proměnným prostředků úložiště se přistupuje pomocí 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)"

Příklady

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

Viz také