Compartir a través de

definición del grupo

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

Definiciones que hacen referencia a esta definición: canalización, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook

Implementaciones

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

Observaciones

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.

Observaciones

Use esta sintaxis para especificar un grupo privado por nombre.

Nota:

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

Ejemplos

Para usar un grupo privado sin demandas:

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.

demands pool.demand.
demandas (para un grupo privado).

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.

demands pool.demand.
demandas (para un grupo privado).

Observaciones

Especifique un grupo hospedado por Microsoft mediante la propiedad vmImage.

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 mayúsculas de minúsculas.

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

Operación equals

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, vea Especificar demandas.

Consulte también