Creación y administración de grupos de agentes

Para elegir un agente hospedado por Microsoft del grupo de Azure Pipelines en la canalización de YAML de Azure DevOps Services, especifique el nombre de la imagen mediante la etiqueta de imagen de máquina virtual YAML de esta tabla.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Para utilizar un grupo privado sin peticiones:

pool: MyPool

Para más información, consulte Esquema de YAML para grupos.

Los administradores de la organización crean y administran grupos de agentes desde la pestaña Grupos de agentes en la configuración de administración.

1. Inicie sesión en su organización (https://dev.azure.com/{yourorganization}).

2. SeleccioneConfiguración de organización de >.

   

3. Seleccione Grupos de agentes.

   

1. Inicie sesión en la colección de proyectos (http://your-server/DefaultCollection).

2. Seleccione Azure DevOps>Configuración de la colección.

   

3. Seleccione Grupos de agentes.

   

Los miembros del equipo del proyecto crean y administran grupos de agentes desde la pestaña Grupos de agentes en la configuración del proyecto.

Vaya a su proyecto y seleccione Configuraciones del proyecto>Grupos de agentes.

Vaya a su proyecto y seleccione Configuraciones del proyecto>Grupos de agentes.

Enumeración de grupos de agentes | Mostrar detalles del grupo de agentes | Enumerar colas de agentes | Mostrar detalles de la cola de agentes

Enumerar grupos de agentes

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parámetros

• action: filtre la lista con la acción de usuario permitida. Los valores aceptados son manage, noney use.
• detect: detecta automáticamente la organización. Los valores aceptados son false y true.
• org o organization: dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Este proceso es necesario si no está configurado como predeterminado o no es reconocido a través de la configuración de Git. Por ejemplo: https://dev.azure.com/MyOrganizationName/.
• pool-name: filtre la lista con un nombre de grupo coincidente.
• pool-type: filtre la lista según el tipo de grupo. Los valores aceptados son automation y deployment.

Ejemplo

En el ejemplo siguiente se enumeran todos los grupos en formato de tabla. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool list --output table

ID    Name                             Is hosted    Pool type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Mostrar detalles del grupo de agentes

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parámetros

• id o pool-id: (Obligatorio) ID del grupo para listar los detalles.
• action: filtre la lista con la acción de usuario permitida. Los valores aceptados son manage, noney use.
• detect: detecta automáticamente la organización. Los valores aceptados son false y true.
• org o organization: dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Este proceso es necesario si no está configurado como predeterminado o no es reconocido a través de la configuración de Git. Por ejemplo: https://dev.azure.com/MyOrganizationName/.

Ejemplo

En el siguiente ejemplo se muestran los detalles del pool para el pool Hospedado de Windows 2019 con VS2019. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

También puede usar --output table, que devuelve la misma información que el list comando .

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Enumerar colas de agentes

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parámetros

• action: filtre la lista con la acción de usuario permitida. Los valores aceptados son manage, noney use.
• detect: detecta automáticamente la organización. Los valores aceptados son false y true.
• org o organization: dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Este proceso es necesario si no está configurado como predeterminado o no es reconocido a través de la configuración de Git. Por ejemplo: https://dev.azure.com/MyOrganizationName/.
• project o p: nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Este proceso es necesario si no está configurado como predeterminado o no es reconocido a través de la configuración de Git.
• queue-name: filtre la lista con una expresión regular de nombre de cola coincidente (por ejemplo, ubuntu para una cola denominada Hosted Ubuntu 1604).

Ejemplo

El siguiente ejemplo enumera todas las colas en formato de tabla. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue list --output table
This command group is in preview. It might be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Mostrar detalles de la cola de agentes

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parámetros

• id o queue-id: ID de la cola de agentes para obtener información.
• action: filtre la lista con la acción de usuario permitida. Los valores aceptados son manage, noney use.
• detect: detecta automáticamente la organización. Los valores aceptados son false y true.
• org o organization: dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Este proceso es necesario si no está configurado como predeterminado o no es reconocido a través de la configuración de Git. Por ejemplo: https://dev.azure.com/MyOrganizationName/.
• project o p: nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Este proceso es necesario si no está configurado como predeterminado o no es reconocido a través de la configuración de Git.

Ejemplo

En el siguiente ejemplo se muestran los detalles de la cola hospedada de Windows 2019 con VS2019. Usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.