Compartir a través de


definición de grupo

La palabra clave pool especifica qué grupo se va a usar para un trabajo de la canalización. Una especificación pool también contiene información sobre la estrategia del trabajo para ejecutarse.

Definiciones que hacen referencia a esta definición: canalización, jobs.job

Implementaciones

Implementación Descripción
pool: string Especifique un grupo privado por nombre.
pool: name, demand, vmImage Sintaxis completa para usar demandas y grupos hospedados por Microsoft.
Implementación Descripción
pool: string Especifique un grupo privado por nombre.
pool: name, demand Grupo que se va a usar para un trabajo de la canalización.

Comentarios

En Azure DevOps Server 2019 puede especificar un grupo en el nivel de trabajo en YAML y en el nivel de canalización en la interfaz de usuario de configuración de canalización. En Azure DevOps Server 2019.1 también puede especificar un grupo en el nivel de canalización de YAML si tiene un único trabajo implícito.

Puede especificar un grupo en el nivel de canalización, fase o trabajo.

El grupo especificado en el nivel más bajo de la jerarquía se usa para ejecutar el trabajo.

pool: string

Especifique un grupo privado por nombre que se usará para un trabajo de la canalización.

pool: string # Specify a private pool by name.

pool Cadena.

Especifique un grupo privado por nombre.

Comentarios

Use esta sintaxis para especificar un grupo privado por nombre.

Nota

Si el nombre del grupo tiene un espacio en él, incluya el nombre del grupo entre comillas simples, como pool: 'My pool'.

Ejemplos

Para utilizar un grupo privado sin peticiones:

pool: MyPool

pool: name, demand, vmImage

Sintaxis completa para usar demandas y grupos hospedados por Microsoft.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).
  vmImage: string # Name of the VM image you want to use; valid only in the Microsoft-hosted pool.

Propiedades

name Cadena.
Nombre de un grupo.

demandspool.demand.
Demandas (para una piscina privada).

vmImage Cadena.
Nombre de la imagen de máquina virtual que desea usar; válido solo en el grupo hospedado por Microsoft.

pool: name, demand

Grupo que se va a usar para un trabajo de la canalización.

pool:
  name: string # Name of a pool.
  demands: string | [ string ] # Demands (for a private pool).

Propiedades

name Cadena.
Nombre de un grupo.

demandspool.demand.
Demandas (para una piscina privada).

Comentarios

Especifique un grupo hospedado por Microsoft mediante la vmImage propiedad .

Si el nombre del grupo de agentes autohospedado tiene un espacio en él, incluya el nombre del grupo entre comillas simples, como name: 'My pool'.

Ejemplos

Para usar un grupo hospedado por Microsoft, omita el nombre y especifique una de las imágenes hospedadas disponibles:

pool:
  vmImage: ubuntu-latest

Puede especificar las demandas de un grupo privado mediante la sintaxis completa.

Para agregar una sola demanda a la canalización de compilación de YAML, agregue la línea demands: a la sección pool.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

O bien, si necesita agregar varias demandas, agregue una por línea.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

La comprobación de la existencia de una funcionalidad (existe) y la comprobación de una cadena específica en una funcionalidad (igual a) son las dos únicas operaciones admitidas para las demandas.

Operación Exists

La operación existe comprueba la presencia de una funcionalidad con el nombre específico. La comparación no distingue entre mayúsculas y minúsculas.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Operación igual a

La operación igual comprueba la existencia de una funcionalidad y, si está presente, comprueba su valor con el valor especificado. Si la funcionalidad no está presente o los valores no coinciden, la operación se evalúa como false. Las comparaciones no distinguen mayúsculas de minúsculas.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Variables del agente como funcionalidades del sistema

Los agentes autohospedados tienen las siguientes funcionalidades del sistema con nombres similares a las variables de agente, pero no son variables y no requieren sintaxis de variable al comprobar si existe o es igual a una demanda.

  • Agent.Name
  • Agent.Version
  • Agent.ComputerName
  • Agent.HomeDirectory
  • Agent.OS
  • Agent.OSArchitecture
  • Agent.OSVersion (solo agentes de Windows)

Para obtener más información, consulte Especificar peticiones.

Consulte también