resources.repository.repository definition

La palabra clave repository permite especificar un repositorio externo. Use un recurso de repositorio para hacer referencia a un repositorio adicional en la canalización.

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.

Definiciones que hacen referencia a esta definición: resources.repositories

Propiedades

repository cadena. Obligatorio como primera propiedad.
Alias para el repositorio especificado. Valores aceptables: [-_A-Za-z0-9]*.

endpoint cadena.
identificador del punto de conexión de servicio que se conecta a este repositorio.

trigger desencadenador.
desencadenador de CI para este repositorio, si no se omite ningún desencadenador de CI.

Importante

• Los desencadenadores de recursos del repositorio solo se admiten para repositorios git de Azure Repos.
• Los desencadenadores de recursos del repositorio no admiten batch.

name cadena.
Nombre del repositorio. El formato depende de 'type'; no acepta variables.

ref cadena.
nombre ref para desproteger; el valor predeterminado es "refs/head/main". La rama desprotegida de forma predeterminada siempre que se active el desencadenador de recursos. se admiten expresiones de plantilla.

type cadena.
Tipo de repositorio: git, github, githubenterprise y bitbucket.

Observaciones

se admiten expresiones de plantilla para la propiedad ref (pero no para la propiedad name). Los caracteres comodín se admiten en desencadenadores.

Importante

Solo se admiten desencadenadores de recursos de repositorio para repositorios git de Azure Repos. Para obtener más información sobre la sintaxis de trigger, incluida compatibilidad con caracteres comodín para ramas de y etiquetas de , consulte definición de desencadenador y Compilación de repositorios git de Azure Repos o git de TFS.

Importante

batch no se admite en los desencadenadores de recursos del repositorio.

Si la canalización tiene plantillas en otro repositorio, o si quiere usar desprotección de varios repositorios con un repositorio que requiera una conexión de servicio, debe informar al sistema sobre ese repositorio.

Tipos

Las canalizaciones admiten los siguientes valores para el tipo de repositorio: git, githuby bitbucket. El tipo de git hace referencia a los repositorios de Git de Azure Repos.

• Si especifica type: git, el valor de name hace referencia al nombre de un repositorio git de Azure Repos.

  • Si la canalización está en el mismo proyecto de Azure DevOps que el repositorio, por ejemplo, un repositorio denominado tools, se hace referencia a ella mediante name: tools.
  • Si la canalización está en la misma organización de Azure DevOps que el repositorio, pero en otro proyecto de Azure DevOps, por ejemplo, un proyecto denominado ToolsProject, debe calificar el nombre del repositorio con el nombre del proyecto: name: ToolsProject/tools.

• Si especifica type: github, el valor name es el nombre completo del repositorio de GitHub e incluye el usuario o la organización. Un ejemplo es name: Microsoft/vscode. Los repositorios de GitHub requieren una conexión de servicio de GitHub para la autorización.

• Si especifica type: bitbucket, el valor de name es el nombre completo del repositorio de Bitbucket Cloud e incluye el usuario o la organización. Un ejemplo es name: MyBitbucket/vscode. Los repositorios de Bitbucket Cloud requieren un conexión de servicio de Bitbucket Cloud para la autorización.

Para obtener más información sobre estos tipos, consulte Consulte varios repositorios en la canalización: definición de recursos del repositorio.

variables

En cada ejecución, los metadatos de un recurso de repositorio están disponibles para todos los trabajos en forma de variables en tiempo de ejecución. El <Alias> es el identificador que proporcionó para el recurso del repositorio.

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

En el ejemplo siguiente se tiene un recurso de repositorio con un alias de commony se accede a las variables de recursos del repositorio mediante 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)"

Ejemplos

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

Consulte también

• Agregar recursos a una canalización