Grupos de agentes
Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2015
Nota:
En Microsoft Team Foundation Server (TFS) 2018 y versiones anteriores, las canalizaciones de compilación y versión se denominan definiciones, las ejecuciones se denominan compilaciones, las conexiones de servicio se denominan puntos de conexión de servicio, las fases se denominan entornos y los trabajos se denominan fases.
En lugar de administrar cada agente individualmente, los agentes se organizan en grupos de agentes. En TFS, los grupos están limitados a todo el servidor; para que pueda compartir un grupo de agentes entre colecciones de proyectos y proyectos.
Una cola de agentes proporciona acceso a un grupo de agentes dentro de un proyecto. Cuando se crea una canalización de compilación o versión, se especifica la cola que usa. Las colas tienen como ámbito el proyecto en TFS 2017 y versiones posteriores, por lo que solo se pueden usar en las canalizaciones de compilación y versión dentro de un proyecto.
Para compartir un grupo de agentes con varios proyectos, en cada uno de esos proyectos, cree una cola de agentes que apunte al mismo grupo de agentes. Aunque varias colas entre proyectos pueden usar el mismo grupo de agentes, varias colas dentro de un proyecto no pueden usar el mismo grupo de agentes. Además, cada cola de agentes solo puede usar un grupo de agentes.
Los grupos de agentes tienen como ámbito colecciones de proyectos.
En lugar de administrar cada agente individualmente, los agentes se organizan en grupos de agentes. En Azure Pipelines, los grupos están limitados a toda la organización, por lo que puede compartir las máquinas del agente entre proyectos. En Azure DevOps Server, los grupos de agentes están limitados a todo el servidor, por lo que puede compartir las máquinas del agente entre proyectos y colecciones.
Cuando se configura un agente, se registra con un único grupo y, al crear una canalización, se especifica el grupo que usa la canalización. Cuando se ejecuta la canalización, se ejecuta en un agente de ese grupo que satisface las demandas de la canalización.
Nota:
Los trabajos del grupo de agentes ejecutan un trabajo en un solo agente. Si necesita ejecutar un trabajo en todos los agentes, como un grupo de implementación para canalizaciones de versión clásicas, consulte Aprovisionamiento de grupos de implementación.
Los grupos de agentes se crean y administran desde la pestaña grupos de agentes en la configuración de administración.
Si es un administrador de la organización, puede crear y administrar grupos de agentes desde la pestaña grupos de agentes en la configuración de administración.
Elija Azure DevOps, Configuración de la organización.
Elija Grupos de agentes.
Elija Azure DevOps, Configuración de colección.
Elija Grupos de agentes.
Elija Azure DevOps, Configuración de colección.
Elija Grupos de agentes.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Elija Administrar grupos.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Elija Administrar grupos.
Vaya al proyecto y elija Administrar proyecto (icono de engranaje).
Elija Panel de control.
Seleccione Grupos de agentes.
Las colas del agente se crean y administran desde la pestaña colas del agente en la configuración del proyecto.
Si es miembro del equipo del proyecto, cree y administre colas de agente desde la pestaña Grupos de agentes en la configuración del proyecto.
Vaya al proyecto y elija la configuración Project ,grupos de agentes.
Vaya al proyecto y elija la configuración Project ,grupos de agentes.
Vaya al proyecto y elija la configuración Project ,grupos de agentes.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Vaya al proyecto y elija Administrar proyecto (icono de engranaje).
Elija Panel de control.
Seleccione la colección de proyectos deseada y elija Ver la página de administración de recopilación.
Seleccione Colas del agente (para TFS 2015, seleccione Compilar y, a continuación, Colas).
Grupos de agentes predeterminados
Los siguientes grupos de agentes se proporcionan de forma predeterminada:
- Grupo predeterminado: úselo para registrar agentes auto-hospedados que haya configurado.
Azure Pipelines grupo hospedado con varias imágenes Windows, Linux y macOS. Para obtener una lista completa de las imágenes disponibles y su software instalado, consulte Agentes hospedados por Microsoft.
Nota:
El Azure Pipelines hospedado reemplaza a los grupos hospedados anteriores que tenían nombres asignados a las imágenes correspondientes. Los trabajos que tenía en los grupos hospedados anteriores se redirigen automáticamente a la imagen correcta en el nuevo grupo Azure Pipelines hospedado. En algunas circunstancias, es posible que todavía vea los nombres de grupo antiguos, pero en segundo plano los trabajos hospedados se ejecutan mediante el grupo Azure Pipelines servidor. Para obtener más información, vea las notas de la versión Grupo hospedado único de las notas de la versión 1 de julio de 2019- Sprint 154.
De forma predeterminada, todos los colaboradores de un proyecto son miembros del rol Usuario en grupos hospedados. Esto permite a todos los colaboradores de un proyecto crear y ejecutar canalizaciones mediante agentes hospedados por Microsoft.
Elección de un grupo y un agente en la canalización
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 usar un grupo privado sin demandas:
pool: MyPool
Para obtener más información, vea el esquema YAML paragrupos.
Administración de grupos y colas
Los grupos de agentes se crean y administran desde la pestaña grupos de agentes en la configuración de administración.
Si es un administrador de la organización, puede crear y administrar grupos de agentes desde la pestaña grupos de agentes en la configuración de administración.
Elija Azure DevOps, Configuración de la organización.
Elija Grupos de agentes.
Elija Azure DevOps, Configuración de colección.
Elija Grupos de agentes.
Elija Azure DevOps, Configuración de colección.
Elija Grupos de agentes.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Elija Administrar grupos.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Elija Administrar grupos.
Vaya al proyecto y elija Administrar proyecto (icono de engranaje).
Elija Panel de control.
Seleccione Grupos de agentes.
Las colas del agente se crean y administran desde la pestaña colas del agente en la configuración del proyecto.
Si es miembro del equipo del proyecto, puede crear y administrar colas de agentes desde la pestaña grupos de agentes en la configuración del proyecto.
Vaya al proyecto y elija laconfiguración Project , grupos de agentes.
Vaya al proyecto y elija laconfiguración Project , grupos de agentes.
Vaya al proyecto y elija laconfiguración Project , grupos de agentes.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Vaya al proyecto y elija Administrar proyecto (icono de engranaje).
Elija Panel de control.
Seleccione la colección de proyectos deseada y elija Ver la página de administración de recopilación.
Seleccione Colas del agente (para TFS 2015, seleccione Compilar y, a continuación, Colas).
Los grupos se usan para ejecutar trabajos. Obtenga información sobre cómo especificar grupos para trabajos.
Si tiene una gran cantidad de agentes auto-hospedados diseñados para distintos equipos o propósitos, puede que quiera crear grupos adicionales, como se explica a continuación.
Creación de grupos de agentes
Estas son algunas situaciones típicas en las que es posible que desee crear grupos de agentes auto-hospedados:
Es miembro de un proyecto y quiere usar un conjunto de máquinas propiedad de su equipo para ejecutar trabajos de compilación e implementación. En primer lugar, asegúrese de que tiene los permisos para crear grupos en el proyecto seleccionando Seguridad en la página grupos de agentes en la configuración del proyecto. Debe tener el rol Administrador para poder crear nuevos grupos. A continuación, seleccione Agregar grupo y seleccione la opción para crear un nuevo grupo en el nivel de organización. Por último, instale y configure los agentes para que sean parte de ese grupo de agentes.
Es miembro del equipo de infraestructura y le gustaría configurar un grupo de agentes para su uso en todos los proyectos. En primer lugar, asegúrese de que es miembro de un grupo en Todos los grupos de agentes con el rol Administrador; para ello, vaya a la página grupos de agentes en la configuración de la organización. A continuación, cree un nuevo grupo de agentes y seleccione la opción Aprovisionar automáticamente los grupos de agentes correspondientes en todos los proyectos al crear el grupo. Esta configuración garantiza que todos los proyectos tengan acceso a este grupo de agentes. Por último, instale y configure los agentes para que sean parte de ese grupo de agentes.
Quiere compartir un conjunto de máquinas de agente con varios proyectos, pero no todos ellos. En primer lugar, vaya a la configuración de uno de los proyectos, agregue un grupo de agentes y seleccione la opción para crear un nuevo grupo en el nivel de organización. A continuación, vaya a cada uno de los demás proyectos y cree un grupo en cada uno de ellos mientras selecciona la opción Usar un grupo de agentes existente de la organización. Por último, instale y configure los agentes para que forman parte del grupo de agentes compartidos.
Es miembro de un proyecto y quiere usar un conjunto de máquinas propiedad de su equipo para ejecutar trabajos de compilación e implementación. En primer lugar, asegúrese de que es miembro de un grupo en Todos los grupos con el rol Administrador. A continuación, cree un nuevo grupo de agentes de proyecto en la configuración del proyecto y seleccione la opción Crear un nuevo grupo de agentes de organización. Como resultado, se creará un grupo de agentes de nivel de organización y de nivel de proyecto. Por último, instale y configure los agentes para que sean parte de ese grupo de agentes.
Es miembro del equipo de infraestructura y le gustaría configurar un grupo de agentes para su uso en todos los proyectos. En primer lugar, asegúrese de que es miembro de un grupo en Todos los grupos con el rol Administrador. A continuación, cree un nuevo grupo de agentes de organización en la configuración de administración y seleccione la opción Aprovisionamiento automático de los grupos de agentes de proyecto correspondientes en todos los proyectos al crear el grupo. Esta configuración garantiza que todos los proyectos tengan un grupo que apunte al grupo de agentes de la organización. El sistema crea un grupo para los proyectos existentes y, en el futuro, lo hará siempre que se cree un nuevo proyecto. Por último, instale y configure los agentes para que sean parte de ese grupo de agentes.
Quiere compartir un conjunto de máquinas de agente con varios proyectos, pero no todos ellos. En primer lugar, cree un grupo de agentes de proyecto en uno de los proyectos y seleccione la opción Crear un nuevo grupo de agentes de organización al crear ese grupo. A continuación, vaya a cada uno de los demás proyectos y cree un grupo en cada uno de ellos mientras selecciona la opción Usar un grupo de agentes de organización existente. Por último, instale y configure los agentes para que forman parte del grupo de agentes compartidos.
Seguridad de los grupos de agentes
Comprender cómo funciona la seguridad para los grupos de agentes le ayuda a controlar el uso compartido y el uso de agentes.
Los roles se definen en cada grupo de agentes y la pertenencia a estos roles rige las operaciones que se pueden realizar en un grupo de agentes.
| Rol en un grupo de agentes en la configuración de la organización | Fin |
|---|---|
| Lector | Los miembros de este rol pueden ver el grupo de agentes, así como los agentes. Normalmente se usa para agregar operadores que son responsables de supervisar los agentes y su estado. |
| Cuenta de servicio | Los miembros de este rol pueden usar el grupo de agentes de la organización para crear un grupo de agentes de proyecto en un proyecto. Si sigue las instrucciones anteriores para crear nuevos grupos de agentes de proyecto, normalmente no tiene que agregar ningún miembro aquí. |
| Administrador | Además de todos los permisos anteriores, los miembros de este rol pueden registrar o anular el registro de agentes del grupo de agentes de la organización. También pueden hacer referencia al grupo de agentes de la organización al crear un grupo de agentes de proyecto en un proyecto. Por último, también pueden administrar la pertenencia a todos los roles del grupo de agentes de la organización. El usuario que creó el grupo de agentes de la organización se agrega automáticamente al rol Administrador de ese grupo. |
El nodo Todos los grupos de agentes de la pestaña Grupos de agentes se usa para controlar la seguridad de todos los grupos de agentes de la organización. Las pertenencias a roles para grupos de agentes de organización individuales se heredan automáticamente de las del nodo "Todos los grupos de agentes". Al usar TFS o Azure DevOps Server, de forma predeterminada, los administradores de TFS y Azure DevOps Server también son administradores del nodo "Todos los grupos de agentes".
Los roles también se definen en cada grupo de agentes de proyecto y las pertenencias a estos roles rigen las operaciones que se pueden realizar en un grupo de agentes en el nivel de proyecto.
| Rol en un grupo de agentes en la configuración del proyecto | Fin |
|---|---|
| Lector | Los miembros de este rol pueden ver el grupo de agentes de proyecto. Normalmente se usa para agregar operadores que son responsables de supervisar los trabajos de compilación e implementación en ese grupo de agentes de proyecto. |
| Usuario | Los miembros de este rol pueden usar el grupo de agentes de proyecto al crear canalizaciones. |
| Administrador | Además de todas las operaciones anteriores, los miembros de este rol pueden administrar la pertenencia a todos los roles del grupo de agentes de proyecto. El usuario que creó el grupo se agrega automáticamente al rol Administrador de ese grupo. |
El nodo Todos los grupos de agentes de la pestaña Grupos de agentes se usa para controlar la seguridad de todos los grupos de agentes de proyecto de un proyecto. Las pertenencias a roles para grupos de agentes de proyecto individuales se heredan automáticamente de las del nodo "Todos los grupos de agentes". De forma predeterminada, los siguientes grupos se agregan al rol administrador de "Todos los grupos de agentes": Administradores de compilación, Administradores de versión, Administradores de Project Administradores.
La acción Seguridad de la pestaña Grupos de agentes se usa para controlar la seguridad de todos los grupos de agentes de proyecto de un proyecto. Las pertenencias a roles para grupos de agentes de proyecto individuales se heredan automáticamente de lo que se define aquí. De forma predeterminada, los siguientes grupos se agregan al rol administrador de "Todos los grupos de agentes": Administradores de compilación, Administradores de versión, Administradores de Project Administradores.
TFS 2015
En TFS 2015, los grupos especiales se definen en grupos de agentes y la pertenencia a estos grupos rige las operaciones que puede realizar.
Los miembros de los administradores del grupo de agentes pueden registrar nuevos agentes en el grupo y agregar usuarios adicionales como administradores o cuentas de servicio.
Agregue personas al grupo Administradores del grupo de agentes para concederles permiso para administrar todos los grupos de agentes. Esto permite a los usuarios crear nuevos grupos y modificar todos los grupos existentes. Los miembros del grupo De administradores de Team Foundation también pueden realizar todas estas operaciones.
Los usuarios del grupo Cuentas de servicio del grupo de agentes tienen permiso para escuchar la cola de mensajes para que el grupo específico reciba trabajo. En la mayoría de los casos no debería tener que administrar los miembros de este grupo. El proceso de registro del agente se encarga de él. La cuenta de servicio que especifique para el agente (normalmente Servicio de red) se agrega automáticamente al registrar el agente.
Preguntas más frecuentes
Si no programo una ventana de mantenimiento, ¿cuándo ejecutarán los agentes el mantenimiento?
Si no se programa ninguna ventana, los agentes de ese grupo no ejecutarán el trabajo de mantenimiento.
¿Qué es un trabajo de mantenimiento?
Puede configurar grupos de agentes para limpiar periódicamente directorios y repositorios de trabajo obsoletos. Esto debería reducir la posibilidad de que los agentes se quedán sin espacio en disco. Los trabajos de mantenimiento se configuran en el nivel de organización o colección de proyectos en la configuración del grupo de agentes.
Para configurar las opciones del trabajo de mantenimiento:
Elija Azure DevOps, Configuración de la organización.
Elija Grupos de agentes.
Elija Azure DevOps, Configuración de colección.
Elija Grupos de agentes.
Elija Azure DevOps, Configuración de colección.
Elija Grupos de agentes.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Elija Administrar grupos.
Vaya al proyecto y elija Configuración (icono de engranaje) Colas del Agente.
Elija Administrar grupos.
Vaya al proyecto y elija Administrar proyecto (icono de engranaje).
Elija Panel de control.
Seleccione Grupos de agentes.
Elija el grupo deseado y elija Configuración para configurar los valores del trabajo de mantenimiento para ese grupo de agentes.
Importante
Debe tener el permiso Administrar colas de compilación para configurar los valores del trabajo de mantenimiento. Si no ve la pestaña Configuración o historial de mantenimiento, no tiene ese permiso, que se concede de forma predeterminada al rol Administrador. Para obtener más información, vea Seguridad de los grupos de agentes.
Configure los valores deseados y elija Guardar.
Seleccione Historial de mantenimiento para ver el historial de trabajos de mantenimiento del grupo de agentes actual. Puede descargar y revisar los registros para ver los pasos de limpieza y las acciones realizadas.
El mantenimiento se realiza por grupo de agentes, no por equipo. Por lo tanto, si tiene varios grupos de agentes en una sola máquina, es posible que tenga problemas de espacio en disco.
Estoy intentando crear un grupo de agentes de proyecto que usa un grupo de agentes de organización existente, pero los controles están atenuados. ¿Por qué?
En el cuadro de diálogo "Crear un grupo de agentes de proyecto", no puede usar un grupo de agentes de organización existente si otro grupo de agentes de proyecto ya hace referencia a él. Solo un grupo de agentes de proyecto de una colección de proyectos determinada puede hacer referencia a cada grupo de agentes de organización.
No puedo seleccionar un grupo hospedado por Microsoft y no puedo poner en cola mi compilación. ¿Cómo puedo corregirlo?
Pida al propietario de la Azure DevOps que le conceda permiso para usar el grupo. Vea Seguridad de los grupos de agentes.
Necesito más recursos de compilación hospedados. ¿Qué se puede hacer?
A. El grupo Azure Pipelines proporciona a todas las Azure DevOps con agentes de compilación hospedados en la nube y minutos de compilación gratuitos cada mes. Si necesita más recursos de compilación hospedados por Microsoft o necesita ejecutar más trabajos en paralelo, puede: