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: pipeline, stages.stage, jobs.job, jobs.deployment, preDeployHook, deployHook, routeTrafficHook, postRouteTrafficHook, onFailureHook, onSuccessHook
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
- Especificar peticiones
- Obtenga más información sobre las condiciones y los tiempos de espera.