Condividi tramite

definizione resources.repository.repository

  • Articolo

La repository parola chiave consente di specificare un repository esterno. Usare una risorsa del repository per fare riferimento a un repository aggiuntivo nella 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.

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.

Definizioni che fanno riferimento a questa definizione: resources.repository

Proprietà

repository stringa. Obbligatorio come prima proprietà.
Alias per il repository specificato. Valori accettabili: [-_A-Za-z0-9]*.

endpoint stringa.
ID dell'endpoint di servizio che si connette a questo repository.

trigger trigger.
trigger CI per questo repository, nessun trigger CI se omesso.

Importante

  • I trigger di risorse del repository sono supportati solo per i repository Git di Azure Repos.
  • I trigger delle risorse del repository non supportano batch.

name stringa.
Nome repository. Il formato dipende da 'type'; non accetta variabili.

ref stringa.
nome di riferimento da estrarre; il valore predefinito è "refs/heads/main". Il ramo estratto per impostazione predefinita ogni volta che viene attivato il trigger della risorsa. le espressioni modello sono supportate.

ref stringa.
nome di riferimento da estrarre; il valore predefinito è "refs/heads/main". Il ramo estratto per impostazione predefinita ogni volta che viene attivato il trigger della risorsa. Non accetta variabili.

type stringa.
Tipo di repository: git, github, githubenterprise e bitbucket.

Osservazioni:

Importante

La risorsa del repository non consente variabili della pipeline in name e ref. I caratteri jolly sono supportati nei trigger.

le espressioni modello sono supportate per la proprietà ref (ma non per la proprietà name). I caratteri jolly sono supportati nei trigger.

Importante

I trigger di risorse del repository sono supportati solo per i repository Git di Azure Repos. Per altre informazioni sulla sintassi di trigger, incluso supporto dei caratteri jolly per rami e tag , vedere definizione del trigger e Compilare repository Git Di Azure Repos o GIT TFS.

Importante

batch non è supportato nei trigger di risorse del repository.

Se la pipeline include modelli di in un altro repositoryo se si vuole usare di estrazione di più repository con un repository che richiede una connessione al servizio, è necessario informare il sistema su tale repository.

Tipi

Le pipeline supportano i valori seguenti per il tipo di repository: git, githube bitbucket. Il git tipo fa riferimento ai repository Git di Azure Repos.

  • Se si specifica type: git, il valore name fa riferimento al nome di un repository Git di Azure Repos.

    • Se la pipeline si trova nello stesso progetto di Azure DevOps del repository, ad esempio un repository denominato tools, si fa riferimento usando name: tools.
    • Se la pipeline si trova nella stessa organizzazione di Azure DevOps del repository, ma in un progetto Azure DevOps diverso, ad esempio un progetto denominato ToolsProject, è necessario qualificare il nome del repository con il nome del progetto: name: ToolsProject/tools.

  • Se si specifica type: github, il valore name è il nome completo del repository GitHub e include l'utente o l'organizzazione. Un esempio è name: Microsoft/vscode. I repository GitHub richiedono una connessione del servizio GitHub per l'autorizzazione.

  • Se si specifica type: bitbucket, il valore name è il nome completo del repository Bitbucket Cloud e include l'utente o l'organizzazione. Un esempio è name: MyBitbucket/vscode. I repository di Bitbucket Cloud richiedono una connessione al servizio cloud Bitbucket per l'autorizzazione.

Per altre informazioni su questi tipi, vedere Controllare più repository nella pipeline - Definizione della risorsa del repository.

Variabili

In ogni esecuzione, i metadati per una risorsa del repository sono disponibili per tutti i processi sotto forma di variabili di runtime. Il <Alias> è l'identificatore assegnato per la risorsa del repository.

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'esempio seguente include una risorsa del repository con un alias di commone le variabili di risorsa del repository sono accessibili usando 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)"

Variabili

In ogni esecuzione, i metadati per una risorsa del repository sono disponibili per tutti i processi sotto forma di variabili di runtime. Il <Alias> è l'identificatore assegnato per la risorsa del repository.

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

L'esempio seguente include una risorsa del repository con un alias di commone le variabili di risorsa del repository sono accessibili usando 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)"

Esempi

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

Vedere anche