resources.repository.repository definition
Mit dem repository
-Schlüsselwort können Sie ein externes Repository angeben. Verwenden Sie eine Repositoryressource, um auf ein zusätzliches Repository in Ihrer Pipeline zu verweisen.
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.
Definitionen, die auf diese Definition verweisen: resources.repositorys
Eigenschaften
repository
Schnur. Erforderlich als erste Eigenschaft.
Alias für das angegebene Repository. Zulässige Werte: [-_A-Za-z0-9]*.
endpoint
Schnur.
ID des Dienstendpunkts, der eine Verbindung mit diesem Repository herstellt.
trigger
Trigger.
CI-Trigger für dieses Repository, kein CI-Trigger, wenn nicht angegeben.
Wichtig
- Repositoryressourcentrigger werden nur für Azure Repos Git-Repositorys unterstützt.
- Repositoryressourcentrigger unterstützen
batch
nicht .
name
Schnur.
Repositoryname. Das Format hängt vom Typ ab; akzeptiert keine Variablen.
ref
Schnur.
Name zum Auschecken zurückweisen; wird standardmäßig auf "refs/heads/Standard" festgelegt. Der Branch wird standardmäßig ausgecheckt, wenn der Ressourcentrigger ausgelöst wird. Vorlagenausdrücke werden unterstützt.
ref
Schnur.
Name zum Auschecken zurückweisen; wird standardmäßig auf "refs/heads/Standard" festgelegt. Der Branch wird standardmäßig ausgecheckt, wenn der Ressourcentrigger ausgelöst wird. Akzeptiert keine Variablen.
type
Schnur.
Repositorytyp: git, github, githubenterprise und bitbucket.
Hinweise
Wichtig
Die Repositoryressource lässt keine Pipelinevariablen in name
und zu ref
. In Triggern werden Wildcards unterstützt.
Vorlagenausdrücke werden für die ref
-Eigenschaft (aber nicht die name
-Eigenschaft) unterstützt. In Triggern werden Wildcards unterstützt.
Wichtig
Repositoryressourcentrigger werden nur für Azure Repos Git-Repositorys unterstützt. Weitere Informationen zur trigger
Syntax, einschließlich der Unterstützung von Wildcards für Branches und Tags, finden Sie unter Triggerdefinition und Erstellen Azure Repos Git- oder TFS-Git-Repositorys.
Wichtig
batch
wird in Repositoryressourcentriggern nicht unterstützt.
Wenn Ihre Pipeline Vorlagen in einem anderen Repository enthält, müssen Sie das System über dieses Repository informieren.
Wenn Ihre Pipeline über Vorlagen in einem anderen Repository verfügt, oder Sie das Auschecken mehrerer Repositorys mit einem Repository verwenden möchten, das eine Dienstverbindung erfordert, müssen Sie das System über dieses Repository informieren.
Typen
Pipelines unterstützen die folgenden Werte für den Repositorytyp: git
, github
und bitbucket
.
Der git
-Typ bezieht sich auf Azure Repos Git-Repositorys.
Wenn Sie angeben
type: git
, bezieht sich dername
Wert auf den Namen eines Azure Repos Git-Repositorys.- Wenn sich Ihre Pipeline im selben Azure DevOps-Projekt wie das Repository befindet, z. B. ein Repository namens
tools
, verweisen Sie mitname: tools
darauf. - Wenn sich Ihre Pipeline im gleichen Azure DevOps-organization wie das Repository befindet, aber in einem anderen Azure DevOps-Projekt, z. B. einem Projekt mit dem Namen
ToolsProject
, müssen Sie den Repositorynamen mit dem Projektnamen qualifizieren:name: ToolsProject/tools
.
- Wenn sich Ihre Pipeline im selben Azure DevOps-Projekt wie das Repository befindet, z. B. ein Repository namens
Wenn Sie
type: github
angeben, ist dername
-Wert der vollständige Name des GitHub-Repositorys und enthält die*den Benutzer*in oder die Organisation. z. B.name: Microsoft/vscode
. GitHub-Repositorys erfordern eine GitHub-Dienstverbindung für die Autorisierung.Wenn Sie
type: bitbucket
angeben, ist dername
-Wert der vollständige Name des Bitbucket-Cloud-Repositorys und enthält die*den Benutzer*in oder die Organisation. z. B.name: MyBitbucket/vscode
. Bitbucket-Cloud-Repositorys erfordern eine Bitbucket-Cloud-Dienstverbindung für die Autorisierung.
Weitere Informationen zu diesen Typen finden Sie unter Überprüfen mehrerer Repositorys in Ihrer Pipeline – Repositoryressourcendefinition.
Variables
In jeder Ausführung sind die Metadaten für eine Repositoryressource für alle Aufträge in Form von Laufzeitvariablen verfügbar. Der <Alias>
ist der Bezeichner, den Sie für Ihre Repositoryressource angegeben haben.
resources.repositories.<Alias>.name
resources.repositories.<Alias>.ref
resources.repositories.<Alias>.type
resources.repositories.<Alias>.id
resources.repositories.<Alias>.url
resources.repositories.<Alias>.version
Das folgende Beispiel enthält eine Repositoryressource mit dem Alias common
, und auf die Variable der Repositoryressource wird mithilfe von resources.repositories.common.*
zugegriffen.
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
In jeder Ausführung sind die Metadaten für eine Repositoryressource für alle Aufträge in Form von Laufzeitvariablen verfügbar. Der <Alias>
ist der Bezeichner, den Sie für Ihre Repositoryressource angegeben haben.
resources.repositories.<Alias>.name
resources.repositories.<Alias>.ref
resources.repositories.<Alias>.type
resources.repositories.<Alias>.id
resources.repositories.<Alias>.url
Das folgende Beispiel enthält eine Repositoryressource mit dem Alias common
, und auf die Variable der Repositoryressource wird mithilfe von resources.repositories.common.*
zugegriffen.
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)"
Beispiele
resources:
repositories:
- repository: common
type: github
name: Contoso/CommonTools
endpoint: MyContosoServiceConnection