Administrar el sistema de compilación

Ha configurado los servidores de compilación, incluidos los controladores de compilación y los agentes de compilación. Ha definido los procesos de compilación para satisfacer las necesidades del equipo. El equipo ejecuta y administra las compilaciones automatizadas ahora para compilar y probar la aplicación.

En ocasiones, encontrará situaciones en las que es necesario supervisar y administrar el sistema de compilación, por ejemplo, al diagnosticar problemas o escalar el sistema de compilación.

Permisos necesarios

Debe ser miembro del grupo Administradores de Windows en el servidor de compilación y del grupo Project Collection Build Administrators en la colección de proyectos de equipo. Vea Referencia de permisos para Team Foundation Server.

¿Qué desea hacer?

• Comprobar el estado, administrar y modificar los controladores y los agentes de Visual Studio

• Comprobar el estado, administrar y modificar el servidor, el controlador y los agentes de la consola de administración

• Iniciar, detener o reiniciar un servidor de compilación

• Reiniciar un controlador de compilación o agente de compilación

• Habilitar o deshabilitar un controlador o agente

• Especificar el número máximo de compilaciones en ejecución simultánea para un controlador

• Registrar o anular el registro de un servidor de compilación

• Supervisar el estado del servidor de compilación

• Usar los registros de eventos para diagnosticar problemas

• Siga estos pasos

Comprobar el estado, administrar y modificar los controladores y los agentes de Visual Studio

A veces se desea comprobar el estado y administrar los controladores de compilación y los agentes de compilación, por ejemplo, cuando un proceso de compilación en cola no se inicia o no puede progresar. Puede hacer todo esto directamente en Visual Studio.

1. En Visual Studio, en Team Explorer:

   1. Si aún no está conectado a un proyecto de equipo en el proyecto de equipo, conéctese al mismo.

   2. Elija Inicio y luego elija Compilaciones.

2. En la página de compilaciones, elija Acciones y, a continuación, Administrar controladores de compilación.

Pasos siguientes

• Compruebe el estado de los controladores y agentes

  • Si Estado es Disponible y Situación es Habilitado, probablemente el componente funciona correctamente.

  • Si Estado es Deshabilitado, puede seleccionar el componente, elija Propiedades y después vuelva a habilitar el componente.

  • Si Situación es Sin conexión, el componente está desconectado. Inicie sesión en el servidor de compilación y asegúrese de que está registrado y puede conectarse a Team Foundation Server.

• Ver, modificar, deshabilitar o habilitar un controlador o agente
  Selecciónelo y elija Propiedades y después vea Implementar y configurar un controlador de compilación o Implementar y configurar los agentes de compilación.

• Quitar un controladora o un agente
  Vea Quitar un controlador de compilación o Quitar un agente de compilación.

• Administrar o resolver problemas de un servidor, un controlador o un agente de compilación
  Para obtener más información, vea la sección , más adelante.

Comprobar el estado, administrar y modificar el servidor, el controlador y los agentes de la consola de administración

Cuando desee comprobar o administrar los componentes del sistema de compilación, a veces necesitará capacidades adicionales que están disponibles cuando inicia sesión en el servidor de compilación.

1. Inicie sesión en el servidor de compilación que desea configurar.

2. Desde Inicio de Windows, ejecute Consola de administración de Team Foundation Server.

   Aparece la Consola de administración de Team Foundation.

3. En el panel de árbol, expanda el nombre del servidor.

4. Elija el nodo Configuración de compilación.

Pasos siguientes

• Compruebe el estado de los controladores y agentes

  • Si cualquiera de los controladores de compilación o agentes de compilación procesan una compilación, puede ver mensajes acerca de este trabajo actual en tiempo real de la Consola de administración de Team Foundation.

    

    Para obtener más información acerca de cómo supervisar un proceso de compilación en ejecución, vea Ejecutar, supervisar y administrar compilaciones y Diagnosticar problemas de la compilación.

  • Si un controlador o agente está en rojo, el componente está desconectado. Asegúrese de que el servidor de compilación puede conectarse a Team Foundation Server.

• Trabajar con el servidor de compilación

  

  • Elija Reiniciar, Detener o Inicio para iniciar, detener o reiniciar el servidor de compilación.

  • Elija Propiedades para implementar y configurar un servidor de compilación.

  • Elija Registro o Anular Registro para registrar o anular el registro de un servidor de compilación.

  • Elija Eventos… para usar los registros de eventos para diagnosticar problemas.

  • Supervisar el estado del servidor de compilación.

• Trabajar con el controlador de compilación
  

  • Elija Propiedades y vea Implementar y configurar un controlador de compilación.

  • Elija Reiniciar para reiniciar el controlador.

  • Elija Habilitar o Deshabilitar para habilitar o deshabilitar el controlador.

• Trabajar con el agente de compilación
  

  • Elija Propiedades y vea Implementar y configurar los agentes de compilación.

  • Elija Reiniciar para reiniciar el agente.

  • Elija Habilitar o Deshabilitar para habilitar o deshabilitar el agente.

Iniciar, detener o reiniciar un servidor de compilación

Es recomendable detener el servidor de compilación cada vez que esté realizando su mantenimiento. En Consola de administración de Team Foundation, elija Detener para tener hospedados a todos los controladores de compilación y agentes de compilación en el servidor de compilación sin conexión. Elija Inicio cuando esté preparado para poner a los controladores y agentes de nuevo en servicio.

Si el servidor de compilación no responde (por ejemplo, si un proceso de compilación no se inicia o no avanza en el tiempo esperado), elegir Reiniciar podría servir de ayuda. Cuando se reinicia el servidor de compilación, el proceso del Servicio de Team Foundation Build se cierra y se reinicia en un estado casi tan actualizado como si se reiniciara el equipo. Si el controlador de compilación o cualquier agente de compilación está procesando compilaciones en este servidor de compilación, estas se cancelarán.

Reiniciar un controlador de compilación o agente de compilación

Cuando el reinicio del servidor de compilación es demasiado perturbador o innecesario, puede elegir el vínculo Reiniciar del controlador de compilación o del agente de compilación en la Consola de administración de Team Foundation. Al reiniciar un controlador de compilación, este recarga los ensamblados y se anulan todas las compilaciones que estaba procesando. Al reiniciar un agente de compilación, este descarta el dominio de aplicación, recarga los ensamblados y se anula la compilación que estaba procesando.

Habilitar o deshabilitar un controlador o agente

Puede deshabilitar un controlador o un agente para evitar que se le asignen compilaciones. Si se deshabilita un controlador o un agente que procesa una compilación, la compilación se completa antes de que se deshabilite el componente.

Esta capacidad puede ayudarle a ajustar, o modificar temporalmente, la manera en que funciona el sistema de compilación. Supongamos, por ejemplo, que sospecha que un servidor de compilación puede estar ejecutando demasiados agentes de compilación porque las compilaciones se procesan con demasiada lentitud. Puede deshabilitar algunos agentes de compilación y evaluar la repercusión de esta medida en el rendimiento. A continuación, puede volver a habilitar uno o más agentes de compilación según sea necesario.

Para habilitar o deshabilitar un agente de compilación o controlador de compilación:

• En el cuadro de diálogo Administrar controladores de compilación de Visual Studio, seleccione el controlador de compilación o agente de compilación que desea deshabilitar o habilitar, y después elija Propiedades. Aparece el cuadro de diálogo Propiedades del controlador de compilación o Propiedades del agente de compilación. Active o desactive la casilla El servicio Controlador de compilación está habilitado o El servicio Agente de compilación está habilitado.

• En Consola de administración de Team Foundation, busque el controlador de compilación o agente de compilación que desea deshabilitar o habilitar, y después elija el vínculo Habilitar o Deshabilitar .

Registrar o anular el registro de un servidor de compilación

En Consola de administración de Team Foundation, elija Anular Registro si desea sacar el servidor de compilación del sistema de compilación. Cuando elija Anular Registro, se le preguntará si desea eliminar algún controlador de compilación y agente de compilación que se esté ejecutando en el servidor de compilación.

• Elija No si desea retirar el servidor de compilación temporalmente. Los controladores y agentes de este servidor de compilación no se eliminan de la colección de proyectos de equipo y aparecen con el Estado Sin conexión en el cuadro de diálogo Administrar controladores de compilación de Visual Studio. Puede elegir Registrar y restaurar el controlador de compilación y los agentes de compilación.

• Elija Sí si desea eliminar toda la configuración para esta compilación de la colección de proyectos de equipo. Se elimina toda la información sobre cualquier controlador de compilación y cualquier agente de compilación.

Si aparece el mensaje El servicio de compilación no está registrado, puede elegir Registrar para poner de nuevo en servicio el servidor de compilación y habilitarla para hospedar controladores de compilación y agentes de compilación.

Supervisar el estado del servidor de compilación

Mientras está conectado al servidor de compilación, puede confirmar que Servicio de Team Foundation Build está en ejecución, obtener información sobre los recursos que utiliza y confirmar el estado general del servidor de compilación.

1. Ejecute el Administrador de tareas de Windows (Administrador de tareas en Windows 8).

2. En Windows 8, si aparece el vínculo Más detalles, elíjalo.

3. Elija la pestaña Proceso.

4. En las versiones de Windows distintas de Windows 8, asegúrese de que está seleccionado Mostrar los procesos de todos los usuarios.

5. ¿En qué versión de Windows se ejecuta el servidor de compilación?

   • Windows 8: Busque el proceso Host del servicio de Visual Studio Team Foundation Build. Debería encontrarse en la sección Procesos en segundo plano o, si el servidor de compilación se ejecuta en modo interactivo, en la sección Aplicaciones. Observe los recursos de CPU, memoria, disco y red que el proceso está utilizando.

   • Otra versión de Windows: busque el proceso TFSBuildServiceHost.exe . Observe los recursos de memoria y CPU que el proceso está utilizando.

6. Use las otras pestañas del Administrador de tareas para confirmar el estado general del servidor de compilación. Por ejemplo, puede elegir la pestaña Rendimiento para confirmar que el equipo tiene el suficientes recursos del procesador y de memoria. Después puede elegir Monitor de recursos (en Windows 8, Abrir el Monitor de recursos).

Usar los registros de eventos para diagnosticar problemas

Use el Visor de eventos para obtener información que puede ayudarle a supervisar el funcionamiento del servidor de compilación y a diagnosticar problemas con el servidor de compilación o el proceso de compilación.

Ver los eventos recientes

Comience comprobando los eventos más recientes. En Consola de administración de Team Foundation, elija Eventos… para abrir el visor de eventos y mostrar los mensajes informativos, de advertencia y de error más recientes.

Ver el registro operativo

Para obtener información más detallada durante un período de tiempo más largo, en el Visor de eventos, en el panel de árbol expanda Registros de aplicaciones y servicios, Microsoft, Team Foundation Server, Servicios de compilación y, a continuación, elija Operativo.

Ver el registro analítico

En la mayoría de los casos no necesita leer los mensajes internos expuestos por el registro analítico. Sin embargo, estos datos pueden ser útiles cuando se trabaja con soporte al cliente para resolver un problema.

Para habilitar el registro analítico

1. En el visor de eventos, elija Ver, Mostrar registros analíticos y de depuración.

2. En el panel del árbol, expanda Registros de aplicaciones y servicios, Microsoft, Team Foundation Server, Servicios de compilación y, a continuación, elija Analítico.

3. Mientras Analítico aún esté seleccionado, abra el menú contextual y, después, elija Habilitar.

Personalizar y ver datos

Para guardar los datos en un archivo permanente que es fácil de examinar y ver, en el panel de árbol, seleccione uno de los nodos descritos anteriormente, abra el menú contextual y, a continuación, elija Guardar todos los eventos…. Use el cuadro de diálogo Guardar como para guardar los datos en el formato que cubra sus necesidades.

Pasos siguientes

• Implementar y trabajar con un servidor de compilación
  Para utilizar Team Foundation Build con Team Foundation Server local, debe implementar al menos un servidor de compilación. El servidor puede implementarse en un equipo físico o en una máquina virtual.

• Implementar y configurar un controlador de compilación
  Use un controlador de compilación para realizar las tareas ligeras y distribuya el trabajo de compilación que usa muchos recursos del procesador al conjunto de agentes de compilación. Puede hospedar un controlador de compilación en un servidor de compilación.

• Implementar y configurar los agentes de compilación
  Use un agente de compilación para que realice el trabajo que requiere un uso intensivo del procesador de su compilación, lo que incluye recibir archivos del control de versiones, proporcionar el área de trabajo, compilar el código y realizar pruebas. Puede hospedar uno o más agentes de compilación en un servidor de compilación.

• Configurar carpetas de entrega
  Puede preparar y, a continuación, designar una o más carpetas de entrega para que el sistema de compilación pueda entregar archivos binarios, resultados de pruebas y archivos de registro a su equipo.

• Escalar el sistema de Team Foundation Build
  Mientras el equipo y la base de código aumentan, puede expandir el sistema de compilación de forma incremental con relativa facilidad.