resources.repository.repository definition

La palabra clave repository le 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 del repositorio especificado. Valores aceptables: [-_A-Za-z0-9]*.

endpoint Cadena.
Identificador del punto de conexión de servicio que se conecta a este repositorio.

triggerdesencadenador.
Desencadenador de CI para este repositorio, ningún desencadenador de CI si se omite.

Importante

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

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

ref Cadena.
ref name to checkout; el valor predeterminado es "refs/heads/main". La rama desprotegida de forma predeterminada cada vez que se activa el desencadenador de recursos. Se admiten expresiones de plantilla.

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

Comentarios

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

Importante

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

Importante

batch no se admite en desencadenadores de recursos de repositorio.

Si la canalización tiene plantillas en otro repositorio o si quiere usar la restauració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 valores siguientes para el tipo de repositorio: git, github y bitbucket. El tipo git hace referencia al repositorio de Azure Repos de Git.

• Si especifica type: git, el name valor hace referencia al nombre de un repositorio de 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, haga 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 name es el nombre completo del repositorio de Bitbucket Cloud e incluye al usuario u organización. Un ejemplo es name: MyBitbucket/vscode. Los repositorios de Bitbucket Cloud requieren una conexión de servicio de Bitbucket Cloud para la autorización.

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

Variables

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

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 common y 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

Vea también

• Agregar recursos a una canalización