Definir la configuración inicial de Team Foundation Build

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Puede personalizar los permisos de compilación iniciales de un proyecto que usa Team Foundation Build. El build.xml complemento especifica los permisos de seguridad para las actividades de compilación de todos los proyectos creados con la misma plantilla de proceso. Los siguientes archivos de plantilla se cargan en la base de datos del proyecto:

Importante

Para TFS 2013 y versiones posteriores, el complemento build.xml ya no carga archivos de plantilla de compilación. Además, para TFS 2018 y versiones posteriores, no se admite la personalización de permisos de compilación mediante el complemento de compilación. En su lugar, los permisos predeterminados se establecen para el nivel de proyecto y el nivel de colección.
grupos de seguridad para canalizaciones de compilación (nivel de objeto).

Los nombres del archivo, la carpeta y el complemento para las plantillas de proceso predeterminadas son los siguientes:

Nombre de archivo: Build.xml
Nombre de carpeta: Nombre del complemento de compilación: Microsoft.ProjectCreationWizard.Build

Nota

Puede cambiar el nombre del archivo XML y el de la carpeta, pero no el del complemento. El sistema no incluye un mecanismo para la implementación de complementos del lado cliente, directivas u otras modificaciones. Si desea implementar este tipo de funcionalidad, debe utilizar su propio programa de instalación y distribución.

En el archivo build.xml, puede especificar una o más tareas y sus dependencias. El archivo de complemento TSF especifica los permisos asignados a grupos de seguridad predeterminados específicos. Para obtener más información sobre la tarea , taskXml y los elementos de dependencia, vea Definir las tareas para procesar un complemento y Definir dependencias para grupos de tareas y tareas.

El código siguiente representa el archivo de build.xml predeterminado que se define para todas las plantillas de proceso predeterminadas.

<?xml version="1.0" encoding="utf-8"?>  
<tasks>  
  <task id="BuildTask" name="Add Build Permissions" plugin="Microsoft.ProjectCreationWizard.Build" completionMessage="Build tasks completed.">  
    <dependencies />  
    <taskXml>  
      <!-- Project-level groups -->  
      <Permission allow="ViewBuilds, ViewBuildDefinition" identity="[$$PROJECTNAME$$]\Readers" />  
      <Permission allow="EditBuildQuality, ViewBuilds, QueueBuilds, ViewBuildDefinition" identity="[$$PROJECTNAME$$]\Contributors" />  
      <Permission allow="DeleteBuilds, DestroyBuilds, EditBuildQuality, ManageBuildQualities, RetainIndefinitely, ViewBuilds, ManageBuildQueue, QueueBuilds, StopBuilds, DeleteBuildDefinition, EditBuildDefinition, ViewBuildDefinition, AdministerBuildPermissions" identity="[$$PROJECTNAME$$]\Build Administrators" />  
      <Permission allow="DeleteBuilds, DestroyBuilds, EditBuildQuality, ManageBuildQualities, RetainIndefinitely, ViewBuilds, ManageBuildQueue, QueueBuilds, StopBuilds, DeleteBuildDefinition, EditBuildDefinition, ViewBuildDefinition, AdministerBuildPermissions" identity="[$$PROJECTNAME$$]\$$PROJECTADMINGROUP$$" />   
      <!-- Collection-level groups -->  
      <Permission allow="EditBuildQuality, ManageBuildQueue, OverrideBuildCheckInValidation, QueueBuilds, UpdateBuildInformation, ViewBuildDefinition, ViewBuilds" identity="$$PROJECTCOLLECTIONBUILDSERVICESGROUP$$" />  
      <Permission allow="ViewBuildDefinition, EditBuildDefinition, DeleteBuildDefinition, QueueBuilds, ManageBuildQueue, StopBuilds, ViewBuilds, EditBuildQuality, RetainIndefinitely, DeleteBuilds, ManageBuildQualities, DestroyBuilds, AdministerBuildPermissions" identity="$$PROJECTCOLLECTIONBUILDADMINSGROUP$$" />  
      <Permission allow="DeleteBuilds, DestroyBuilds, EditBuildQuality, ManageBuildQualities, RetainIndefinitely, ViewBuilds, ManageBuildQueue, QueueBuilds, StopBuilds, DeleteBuildDefinition, EditBuildDefinition, ViewBuildDefinition, AdministerBuildPermissions, OverrideBuildCheckInValidation" identity="$$PROJECTCOLLECTIONADMINGROUP$$" />  
    </taskXml>  
  </task>  
</tasks>