Compartir a través de

Cómo: Crear y administrar agentes de compilación

  • Artículo

Actualización: noviembre 2007

Antes de crear una nueva definición de compilación, debe configurar primero el equipo que se va a designar como agente de compilación. Para obtener más información, vea Cómo: Configurar e instalar Team Foundation Build. Una vez instalados en uno o varios equipos Team Foundation Build y los componentes necesarios, puede utilizar la interfaz de usuario de Visual Studio Team System para crear nuevos agentes de compilación o administrar los agentes de compilación existentes. Cada agente de compilación sólo se puede asociar a un puerto. Normalmente, esto implica que cada agente de compilación está asociado a un equipo de compilación. Sin embargo, también puede especificar un puerto interactivo que puede utilizar ejecutando tfsbuildservice.exe desde la línea de comandos. El puerto interactivo permite ejecutar comprobaciones que impliquen abrir y cerrar formularios Windows Forms. Para obtener más información, vea Valores de configuración de TfsBuildService.exe.config en componentes de Team Foundation Server y Cómo: Configurar un puerto interactivo para Team Foundation Build.

Permisos necesarios

Para realizar este procedimiento, debe tener el permiso Administrar una generación establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.

Crear un nuevo agente de compilación

Utilice el cuadro de diálogo Administrar agentes de compilación para designar un equipo como agente de compilación.

Para crear un nuevo agente de compilación

  1. Seleccione el proyecto de equipo al que desea asociar el agente de compilación en Team Explorer.

  2. Haga clic en Administrar agentes de compilación en el menú Compilación.

    Aparece el cuadro de diálogo Administrar agentes de compilación.

  3. Haga clic en Nuevo.

    Aparece el cuadro de diálogo Propiedades de agente de compilación.

  4. Escriba un nombre para el agente de compilación en el cuadro de texto Nombre para mostrar.

    En el cuadro de diálogo Administrar agentes de compilación se muestra el nombre.

  5. Escriba una descripción opcional en el cuadro de texto Descripción.

    Por ejemplo, "Este agente de compilación está dedicado a compilaciones acumuladas".

  6. En el cuadro de texto Nombre del equipo, escriba el nombre del equipo en el que está instalado Team Foundation Build.

  7. En el cuadro de texto Comunicaciones, escriba el número de puerto que Team Foundation utiliza para comunicarse con Team Foundation Build.

    El valor predeterminado es 9191. Para obtener más información sobre los puertos utilizados por Team Foundation, vea Arquitectura de seguridad de Team Foundation Server.

  8. Active Requiere canal seguro (HTTPS) si desea configurar el agente de compilación para que requiera HTTPS y Capa de sockets seguros (SSL).

    Para obtener más información sobre los pasos necesarios para utilizar HTTPS, vea Cómo: Configurar un agente de compilación para que exija el uso de HTTPS y Capa de sockets seguros (SSL).

  9. En el cuadro de texto Directorio de trabajo, especifique un valor para el directorio de trabajo del agente de compilación.

    El valor predeterminado es $(Temp)\$(BuildDefinitionPath). La propiedad BuildDefinitionPath se expande en <Proyecto de equipo>\<Nombre de definición de compilación>. También puede utilizar BuildDefinitionId que se expande en un identificador entero único para la definición de compilación. BuildDefinitionId se utiliza normalmente para crear una ruta de acceso más corta.

    Nota:

    Haga clic en el botón Predeterminado para restablecer los valores de los cuadros de texto Comunicaciones y Directorio de trabajo a sus valores predeterminados.

    Habilitado es el valor predeterminado de Estado de agente. Otros valores se muestran para reflejar el estado del agente, según corresponda.

Editar y quitar agentes de compilación

También puede utilizar el cuadro de diálogo Administrar agentes de compilación para editar y quitar agentes de compilación que ya se han designado.

Para quitar un agente de compilación

  1. Seleccione el proyecto de equipo que contiene el agente de compilación que desea quitar en Team Explorer.

  2. Haga clic en Administrar agentes de compilación en el menú Compilación.

    Aparece el cuadro de diálogo Administrar agentes de compilación.

  3. Seleccione el agente de compilación que desea quitar en la lista Agentes de compilación y a continuación, haga clic en Quitar.

    El agente de compilación se quita de la lista.

Para editar un agente de compilación

  1. Seleccione el proyecto de equipo que contiene el agente de compilación que desea editar en Team Explorer.

  2. Haga clic en Administrar agentes de compilación en el menú Compilación.

    Aparece el cuadro de diálogo Administrar agentes de compilación.

  3. Seleccione el agente de compilación que desea editar en la lista Agentes de compilación y a continuación, haga clic en Editar.

    Aparece el cuadro de diálogo Propiedades de agente de compilación.

  4. En el cuadro de diálogo Propiedades de agente de compilación, puede editar cualquiera de las entradas y, a continuación, hacer clic en Aceptar para guardarlas.

  5. Para deshabilitar un agente de compilación, en el menú desplegable Estado de agente, seleccione Deshabilitado.

    Cuando el estado del agente de compilación está establecido en Deshabilitado, todas las compilaciones puestas en cola permanecen en la cola en estado activo hasta que el agente de compilación se establece de nuevo en Habilitado.

Vea también

Tareas

Tutorial: Crear una definición de compilación en Team Foundation Build

Cómo: Establecer permisos para el agente de Team Foundation Build

Cómo: Configurar e instalar Team Foundation Build

Tutorial: Personalizar Team Foundation Build con una tarea personalizada

Conceptos

Información general sobre Team Foundation Build

Otros recursos

Trabajar con definiciones de compilación en Team Foundation Build