resources.repositories.repository definition

  • Artigo

A repository palavra-chave permite-lhe especificar um repositório externo. Utilize um recurso de repositório para referenciar um repositório adicional no 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: 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.

Definições que referenciam esta definição: resources.repositories

Propriedades

repository cadeia. Necessário como primeira propriedade.
Alias para o repositório especificado. Valores aceitáveis: [-_A-Za-z0-9]*.

endpoint cadeia.
ID do ponto final de serviço a ligar a este repositório.

triggeracionador.
Acionador CI para este repositório, sem acionador CI, se omitido.

Importante

  • Os acionadores de recursos do repositório são suportados apenas para repositórios git do Repositório do Azure.
  • Os acionadores de recursos do repositório não suportam batch.

name cadeia.
Nome do repositório. O formato depende do "tipo"; não aceita variáveis.

ref cadeia.
ref name to checkout; a predefinição é "refs/heads/main". O ramo deu saída por predefinição sempre que o acionador de recursos é acionado. As expressões de modelo são suportadas.

ref cadeia.
ref name to checkout; a predefinição é "refs/heads/main". O ramo deu saída por predefinição sempre que o acionador de recursos é acionado. Não aceita variáveis.

type cadeia.
Tipo de repositório: git, github, githubenterprise e bitbucket.

Observações

Importante

O recurso de repositório não permite variáveis de pipeline em name e ref. Os carateres universais são suportados nos acionadores.

As expressões de modelo são suportadas para a ref propriedade (mas não para a name propriedade). Os carateres universais são suportados nos acionadores.

Importante

Os acionadores de recursos do repositório são suportados apenas para repositórios Git do Repositório do Azure. Para obter mais informações sobre trigger a sintaxe, incluindo o suporte de carateres universais para ramos e etiquetas, veja Definição do acionador e Compilar repositórios Git do Repositório do Azure ou Git do TFS.

Importante

batch não é suportado em acionadores de recursos do repositório.

Se o pipeline tiver modelos noutro repositório, tem de informar o sistema sobre esse repositório.

Se o pipeline tiver modelos noutro repositório ou se quiser utilizar a finalização da compra de múltiplos repositórios com um repositório que necessite de uma ligação de serviço, tem de informar o sistema sobre esse repositório.

Tipos

Os pipelines suportam os seguintes valores para o tipo de repositório: git, githube bitbucket. O git tipo refere-se aos repositórios git do Azure Repos.

  • Se especificar type: git, o name valor refere-se ao nome de um repositório Git do Repositório do Azure.

    • Se o pipeline estiver no mesmo projeto do Azure DevOps que o repositório, por exemplo, um repositório com o nome tools, referencia-o com name: tools.
    • Se o pipeline estiver na mesma organização do Azure DevOps que o repositório, mas num projeto do Azure DevOps diferente, por exemplo, um projeto com o nome ToolsProject, tem de qualificar o nome do repositório com o nome do projeto: name: ToolsProject/tools.

  • Se especificar type: github, o name valor é o nome completo do repositório do GitHub e inclui o utilizador ou organização. Um exemplo é name: Microsoft/vscode. Os repositórios do GitHub requerem uma ligação de serviço do GitHub para autorização.

  • Se especificar type: bitbucket, o name valor é o nome completo do repositório do Bitbucket Cloud e inclui o utilizador ou organização. Um exemplo é name: MyBitbucket/vscode. Os repositórios do Bitbucket Cloud necessitam de uma ligação do serviço Bitbucket Cloud para autorização.

Para obter mais informações sobre estes tipos, veja Dar saída de vários repositórios no pipeline – Definição de recursos do repositório.

Variáveis

Em cada execução, os metadados de um recurso de repositório estão disponíveis para todas as tarefas na forma de variáveis de runtime. É <Alias> o identificador que deu para o recurso do repositório.

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

O exemplo seguinte tem um recurso de repositório com um alias de common, e as variáveis de recursos do repositório são acedidas com 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)"

Variáveis

Em cada execução, os metadados de um recurso de repositório estão disponíveis para todas as tarefas na forma de variáveis de runtime. É <Alias> o identificador que deu para o recurso do repositório.

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

O exemplo seguinte tem um recurso de repositório com um alias de common, e as variáveis de recursos do repositório são acedidas com 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)"

Exemplos

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

Ver também