Configuración y directivas del repositorio de Git

Artículo
11/24/2021
22 minutos para leer

Nombre de rama predeterminado para los nuevos repositorios

Desactivado

Cuando se habilita, los nuevos repositorios se inicializan con el nombre de la rama que especifique. Puede cambiar la rama predeterminada de un repositorio determinado en cualquier momento. El nombre de rama predeterminado es main .

Permitir a los usuarios administrar permisos para sus ramas creadas

Activado

Los nuevos repositorios están configurados para permitir a los usuarios administrar permisos para sus ramas creadas.

Configuración de repositorio individual

En la tabla siguiente se resumen las opciones que puede habilitar y configurar para personalizar para cada repositorio de Git.

Configuración

Valor predeterminado

Descripción

Horquillas

Activado

Permitir a los usuarios crear bifurcaciones desde el repositorio.

Vinculación de menciones de confirmación

Activado

Cree automáticamente vínculos para los elementos de trabajo mencionados en un comentario de confirmación.

Confirmación de la resolución de elementos de trabajo de mención

Activado

Permitir menciones en los comentarios de confirmación para cerrar elementos de trabajo.

Preferencias de transición de elementos de trabajo

Activado

Recuerde las preferencias del usuario para completar elementos de trabajo con solicitudes de extracción.

Administración de permisos

Activado

Permitir a los usuarios administrar permisos para las ramas que crearon

Modo de voto estricto

Activado

Habilite el modo de voto estricto para el repositorio, que requiere el permiso Contribuir para votar en las solicitudes de extracción.

Deshabilitar repositorio

Activado

Deshabilite el acceso al repositorio (incluidas las compilaciones, las solicitudes de extracción, etc.), pero mantenga el repositorio reconocible con una advertencia.

Ramas en las que se pueden buscar

Activado

Especifique hasta 5 ramas adicionales para participar en la búsqueda de código, que de forma predeterminada solo se aplica a la rama predeterminada.

Directivas de repositorio

En la tabla siguiente se resumen las directivas que puede definir para personalizar un repositorio o definir para inicializar todos los repositorios nuevos con esta configuración.

Directiva

Valor predeterminado

Descripción

Confirmación de la validación del correo electrónico del autor

Desactivado

Bloquear inserciones con un correo electrónico de autor de confirmación que no coincida con los patrones especificados.

Validación de ruta de acceso de archivo

Desactivado

Impedir que las inserciones introduzcan rutas de acceso de archivo que coincidan con los patrones especificados.

Aplicación de casos

Desactivado

Evite conflictos de confidencialidad de mayúsculas y minúsculas mediante el bloqueo de inserciones que cambian el uso de mayúsculas y minúsculas en archivos, carpetas, ramas y etiquetas.

Nombres reservados

Desactivado

Bloquear inserciones que introducen archivos, carpetas o nombres de rama que incluyen nombres reservados de plataforma o caracteres incompatibles.

Longitud máxima de la ruta de acceso

Desactivado

Bloquear inserciones que introducen rutas de acceso que superan la longitud especificada.

Tamaño máximo de archivo

Desactivado

Bloquee las inserciones que contienen archivos nuevos o actualizados mayores que este límite.

Directivas de rama

En la tabla siguiente se resumen las directivas que puede definir para personalizar una rama. Para obtener más información sobre cómo configurar estas opciones, vea Mejorar la calidad del código con directivas de rama.

Directiva

Valor predeterminado

Descripción

Requerir un número mínimo de revisores

Desactivado

Requerir la aprobación de un número especificado de revisores en las solicitudes de extracción.

Buscar elementos de trabajo vinculados

Desactivado

Fomentar la rastreabilidad mediante la comprobación de elementos de trabajo vinculados en las solicitudes de extracción

Comprobación de la resolución de comentarios

Desactivado

Compruebe que todos los comentarios se han resuelto en las solicitudes de extracción.

Limitar tipos de combinación

Desactivado

Controlar el historial de ramas limitando los tipos disponibles de combinación cuando se completan las solicitudes de extracción.

Agregar directivas de validación de compilación

Desactivado

Agregue una o varias directivas para validar el código mediante la combinación previa y la creación de cambios en la solicitud de extracción. También puede habilitar o deshabilitar directivas.

Agregar directivas de comprobación de estado

Desactivado

Agregue una o varias directivas para requerir que otros servicios publiquen el estado correcto para completar las solicitudes de extracción. También puede habilitar o deshabilitar directivas.

Revisores incluidos automáticamente

Desactivado

Agregue una o varias directivas para designar revisores de código que incluyan automáticamente cuando las solicitudes de extracción cambien determinadas áreas de código. También puede habilitar o deshabilitar directivas.

Requisitos previos

Para establecer directivas de rama, debe ser miembro del grupo de seguridad Project Administrators o tener los permisos de nivel de repositorio establecidos: Editar directivas. Para más información, consulte Set Git repository permissions (Establecerpermisos de repositorio de Git).
Si es la primera vez que usa comandos, consulte Introducción a Azure DevOps az reposaz repos.

Para establecer directivas de rama, debe ser miembro del grupo de seguridad Project Administrators o tener los permisos de nivel de repositorio establecidos: Editar directivas. Para más información, consulte Set Git repository permissions (Establecerpermisos de repositorio de Git).

Visualización y edición de la configuración del repositorio

Browser
CLI de Azure DevOps

En el explorador web, abra el proyecto de su organización en Azure DevOps, elija Project configuración,Repositorios y seleccione el repositorio.
Seleccione Configuración para ver y configurar los valores del repositorio.
Seleccione Directivas para ver y configurar directivas de nivel de proyecto y entre repositorios.

En el explorador web, abra el proyecto y elija Project ,Repositoriosy seleccione el repositorio.
Seleccione Opciones y directivas para ver y configurar los valores del repositorio.

En el explorador web, abra el proyecto, elija el icono de engranaje Control de versionesy seleccione el repositorio.
Seleccione las opciones para ver y configurar los valores del repositorio.

En el explorador web, abra el proyecto, elija el icono de engranaje Control de versionesy seleccione el repositorio.
Seleccione Opciones para ver y configurar los valores del repositorio.

Puede usar CLI de Azure para enumerar y mostrar directivas para una rama o repositorio.

Enumeración de directivas de repositorio Mostrar directiva

Repos de directivas

Use az repos policy list para enumerar directivas.

az repos policy List [--branch]
                     [--query-examples]
                     [--repository-id]
                     [--subscription]

Parámetros

Parámetro	Description
`branch`	(Opcional) Nombre de rama para filtrar los resultados por coincidencia exacta del nombre de la rama. El parámetro --repository-id es necesario para usar el filtro de rama. Por ejemplo: `--branch master`.
`query-examples`	(Opcional) Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después entre `--query parameter` comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.
`repository-id`	(Opcional) Identificador del repositorio para filtrar los resultados por coincidencia exacta del identificador del repositorio. Por ejemplo, `--repository-ID e556f204-53c9-4153-9cd9-ef41a11e3345`.

Ejemplo

En el ejemplo siguiente se recupera el identificador de directiva y el nombre de todas las directivas creadas para todos los repositorios y ramas para el proyecto configurado predeterminado mediante az repos policy list . En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"

>az repos policy list --output table
ID    Name                         Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------------  -------------  ------------  ------------------------------------  ---------------------
1     Git repository settings      True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches
3     Work item linking            True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
5     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
6     Comment requirements         False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
7     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
8     Work item linking            False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
9     Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
10    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
11    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
12    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
13    Required reviewers           False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Muestra de directiva

Use az repos case-enforcement update para administrar la directiva de cumplimiento de az repos case-enforcement update

az repos policy az repos policy show --id policy-id
                     [--query-examples]

Parámetros

Parámetro	Description
`id policy-id`	(Obligatorio) Identificador de la directiva. Puede recuperar el identificador de directiva mediante `az repos policy list` .
`query-examples`	(Opcional) Se recomienda la cadena JMESPath. Puede copiar una de las consultas y pegarla después entre `--query parameter` comillas dobles para ver los resultados. Puede agregar una o varias palabras clave posicionales para que podamos proporcionar sugerencias basadas en estas palabras clave.

Ejemplo

En el ejemplo siguiente se recuperan los iD de las directivas existentes mediante y, a continuación, se actualiza la directiva de aplicación de az repos policy list casos en FabrikamFiber el repositorio. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

>az repos policy show --id 1 --output table
ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
1     Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.

Preferencia de nombre de rama predeterminada

Puede elegir cualquier nombre de rama legal que se usará cuando se inicialice un repositorio o cambiarlo más adelante si es necesario. Puede acceder a la configuración de dos maneras:

Configuración de la organización: en la DevOps, seleccione el proyecto Repositorios de configuración de la organización, active Nombre de rama predeterminado para los nuevos repositorios y escriba el nombre de la rama predeterminada.
Project configuración: en la página del proyecto, seleccione configuraciónde Project RepositoriosConfiguración,active Nombre de rama predeterminado para los nuevos repositorios y escriba el nombre de rama predeterminado.

Si no habilita esta característica, los repositorios se inicializarán con el nombre Azure Repos predeterminado, main.

Administración de directivas entre repositorios

Puede establecer directivas en una rama específica o en la rama predeterminada en todos los repositorios de su proyecto. Por ejemplo, un administrador podría requerir dos revisores mínimos para todas las solicitudes de extracción realizadas en cada rama principal de cada repositorio de su proyecto. Puede encontrar la característica Agregar protección de rama en el Repos Project Configuración.

Captura de pantalla que muestra la opción

Horquillas

Controla si los usuarios pueden crear nuevas bifurcaciones del lado servidor. Deshabilitar esta configuración no modificará las bifurcaciones existentes.

Desde Project Configuración repositorio Configuración >, puede habilitar o deshabilitar >.

Repositorio, Configuración, bifurcaciones.

Vinculación de elementos de trabajo

Desde Project Configuración repositorio > Configuración, puede configurar opciones que administren la vinculación de elementos de trabajo.

Repositorio, Configuración, Configuración de elementos de trabajo.

Configuración

Descripción

Vinculación de menciones de confirmación

Cuando se habilita, los mensajes de confirmación que contienen "#" seguidos de un identificador de elemento de trabajo válido vincularán automáticamente la confirmación al elemento de trabajo mencionado. Deshabilite esta configuración al insertar un repositorio contenido previamente en otra cuenta o servicio. Es posible que esos repositorios no coincidan con los de los elementos de #mentions trabajo de la cuenta actual.

Confirmación de la resolución de elementos de trabajo de mención

Habilite esta opción para completar automáticamente esos elementos de trabajo cuando complete correctamente la pr. O bien, puede especificar el estado del flujo de trabajo al que se va a realizar la transición del elemento de trabajo al combinar la PR. Para más información, consulte Autocompletar elementos de trabajo con solicitudes de extracción.

Confirmación de la resolución de elementos de trabajo de mención

Habilite esta opción para completar automáticamente esos elementos de trabajo cuando complete correctamente la pr. Para más información, consulte Autocompletar elementos de trabajo con solicitudes de extracción.

Preferencias de transición de elementos de trabajo

De forma predeterminada, la opción de completar elementos de trabajo vinculados durante la finalización de la solicitud de extracción recordará la última opción de cada usuario. Algunos equipos pueden tener distintos enfoques para cerrar elementos de trabajo, como en una reunión de standup, y es posible que desaconseja que los usuarios completen elementos de trabajo con sus solicitudes de extracción. Al deshabilitar esta configuración, los usuarios deben participar en la finalización de elementos de trabajo para cada solicitud de extracción.

Confirmación de la validación del correo electrónico del autor

Puede establecer una directiva de inserción para evitar que las confirmaciones se insertan en un repositorio para el que el correo electrónico del autor de la confirmación no coincide con el patrón proporcionado.

Captura de pantalla que muestra la pestaña

Desde Project Configuración de repositorio, >puede habilitar o deshabilitar confirmar la validación de correo electrónico del >

Repositorio, Directivas, Confirmar validación de correo electrónico del autor.

Puede especificar correos electrónicos exactos o usar caracteres comodín. Varios patrones de correo electrónico deben usar ";" como separador. Se excluyen los patrones de correo electrónico con el prefijo "!". El orden es importante.

Validación de ruta de acceso de archivo

Puede establecer una directiva para evitar que las confirmaciones se insertan en un repositorio en función de las rutas de acceso de archivo. La directiva de validación de rutas de acceso de archivo bloqueará las inserciones que coincidan con el patrón proporcionado.

Captura de pantalla que muestra la pestaña

Aplicación de casos

Git distingue mayúsculas de minúsculas, lo que significa que un archivo denominado "Foo.txt" es diferente de un archivo denominado "foo.txt". Windows y macOS tienen como valor predeterminado sistemas de archivos que no tienen en cuenta mayúsculas de minúsculas, lo que significa que "Foo.txt" y "foo.txt" tienen el mismo nombre. Esto puede causar problemas a los usuarios si alguien en un sistema que no distingue mayúsculas de minúsculas inserta archivos, carpetas, ramas o etiquetas que solo difieren por mayúsculas y minúsculas.

Si la mayoría de los usuarios están en Windows o macOS, se recomienda activar la configuración de cumplimiento de casos. La aplicación de mayúsculas y minúsculas cambia el servidor de su modo predeterminado con distinción entre mayúsculas y minúsculas, donde "File.txt" y "file.txt" son distintos, a un modo descriptivo de Windows y macOS donde "File.txt" y "file.txt" son el mismo archivo. Esta opción afecta a archivos, carpetas, ramas y etiquetas. También evita que los colaboradores especifiquen diferencias de solo mayúsculas y minúsculas de forma accidental. La habilitación del cumplimiento de mayúsculas y minúsculas se recomienda siempre que la mayoría de los colaboradores trabajen con Windows o macOS.

Bloqueará la introducción de nuevos archivos, carpetas, ramas o etiquetas que provocarían este conflicto. El usuario tendrá que volver a escribir su historial sin insertar para corregir el problema y, después, volver a intentar la inserción.

Esta configuración no corregirá un repositorio que ya contiene objetos que solo difieren en mayúsculas y minúsculas. Se recomienda corregir estos problemas antes de activar la directiva. Puede cambiar el nombre de archivos y carpetas o volver a crear ramas y etiquetas con nombres nuevos que no entren en conflicto.

Browser
CLI de Azure DevOps

Desde Project Configuración directivas de repositorio, >puede habilitar o deshabilitar la aplicación de >

Repositorio, Directivas, Configuración de cumplimiento de casos.

Nota

La directiva de cumplimiento de casos requiere TFS 2018.2 o una versión posterior.

Puede usar CLI de Azure para configurar o actualizar el cumplimiento de case.

Creación de una directiva de aplicación de casos Actualización de la directiva de aplicación de casos

Creación de una directiva de aplicación de casos

Use az repos case-enforcement create para administrar la directiva de cumplimiento de az repos case-enforcement create

az repos policy case-enforcement create --blocking {false, true}
                                        --enabled {false, true}
                                        --repository-id
                                        [--detect {false, true}]
                                        [--org]
                                        [--project]

Parámetros

blocking: (obligatorio) Indica si la directiva debe estar bloqueando o no. Valores aceptados: false, true
enabled: (obligatorio) Si la directiva está habilitada o no. Valores aceptados: false, true
repository-id:identificador (obligatorio) del repositorio en el que se va a aplicar la directiva.
detect:detecte automáticamente la organización. Valores aceptados: false, true
organización u organización:Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git. 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 . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git.

Ejemplo

En el ejemplo siguiente se recuperan los iD de los repositorios existentes mediante y, a continuación, se crea una directiva de aplicación de casos az repos list de bloqueo en el FabrikamFiber repositorio. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az repos list --output table
ID                                    Name           Default Branch    Project
------------------------------------  -------------  ----------------  -------------
6589f9e0-082b-4b96-9dfd-8141b7da409c  FabrikamFiber  master            FabrikamFiber

az repos policy case-enforcement create --blocking true --enabled true --repository-id 6589f9e0-082b-4b96-9dfd-8141b7da409c
{

  <Some properties omitted for space>

  },
  "createdDate": "2019-11-19T15:34:38.854450",
  "id": 4,
  "isBlocking": true,
  "isDeleted": false,
  "isEnabled": true,

  <Some properties omitted for space>

}

Actualización de la directiva de aplicación de casos

Use az repos case-enforcement update para administrar la directiva de cumplimiento de az repos case-enforcement update

az repos policy case-enforcement update --id
                                        [--blocking {false, true}]
                                        [--detect {false, true}]
                                        [--enabled {false, true}]
                                        [--org]
                                        [--project]
                                        [--repository-id]

Parámetros

id o policy-id:identificador (obligatorio) de la directiva.
blocking:indica si la directiva debe estar bloqueando o no. Valores aceptados: false, true
detect:detecte automáticamente la organización. Valores aceptados: false, true
enabled:indica si la directiva está habilitada o no. Valores aceptados: false, true
organización u organización:Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git. 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 . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git.
repository-id:identificador (obligatorio) del repositorio en el que se va a aplicar la directiva.

Ejemplo

az repos policy list --output table
ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
2     File size restriction    True           False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches
3     Git repository settings  True           True          6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches
4     Work item linking        False          False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches
5     Path Length restriction  True           False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches

az repos policy case-enforcement update --blocking false --enabled false --policy-id 4 --output table
ID    Name               Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------  -------------  ------------  ------------------------------------  ------------
4     Work item linking  False          False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches

Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.

Nombres reservados y Longitud máxima de la ruta de acceso

No todos los nombres de archivos se permiten en los tres sistemas de archivos principales del sistema operativo (Windows, macOS y Linux). Los desarrolladores pueden insertar confirmaciones en un repositorio compartido que puede contener archivos o carpetas con nombres que no son válidos en una o varias plataformas. El directorio de trabajo puede dañarse si se capturan y desproteen archivos o carpetas no válidos en una plataforma.

Desde Project Configuración de >repositorio, puede habilitar o deshabilitar dos directivas para establecer restricciones en los nombres de archivo y las rutas de acceso de > Nombres reservados y Longitud máxima de la ruta de acceso.

Repositorio, Directivas, Nombres reservados y Configuración de longitud máxima de ruta de acceso.

La configuración Nombres reservados bloqueará las inserciones en el repositorio que contienen archivos o carpetas que no son válidos en cualquier plataforma. Ver qué nombres no son válidos

Además, no todas las longitudes de ruta de acceso se permiten en los tres sistemas de archivos principales del sistema operativo (Windows, macOS y Linux). Los desarrolladores pueden insertar confirmaciones en un repositorio compartido que puede contener archivos o directorios con longitudes de ruta de acceso no válidas en una o varias plataformas. Si estos archivos o directorios se capturan y desproteen en una plataforma en la que no son válidos, el directorio de trabajo puede dañarse.

La configuración Longitud máxima de la ruta de acceso bloqueará las inserciones en el repositorio que contienen archivos o directorios con nombres de ruta de acceso que no son válidos en cualquier plataforma. Vea qué longitudes de ruta de acceso no son válidas. Cuando se habilita, se selecciona un valor predeterminado de porque es la longitud máxima más alta que se admite 248 al 100 % en las tres plataformas principales.

Se puede modificar el valor máximo de la ruta de acceso. Por ejemplo, si solo tiene desarrolladores de macOS o Linux en su organización, puede optar por establecerlo en el valor más alto que se admite al 100 % en ambas plataformas 1016 (). También puede optar por establecer un valor de ruta de acceso máximo inferior si desea aplicar determinadas convenciones de nomenclatura de & directorios para su organización.

Tamaño de archivo máximo

Los archivos grandes registrados en Git permanecen indefinidamente en el repositorio, arrastrando los tiempos de clonación y aumentando el uso del disco. Tenemos sugerencias para ayudarle a administrar archivos de gran tamaño.

La configuración de directiva Tamaño máximo de archivo ofrece a los administradores una manera de impedir que los archivos de un tamaño determinado entren en el repositorio. Si una inserción contiene un archivo nuevo o actualizado mayor que el límite configurado en esta configuración, esa inserción se bloqueará. El usuario tendrá que volver a escribir su historial sin insertar para quitar el archivo grande y volver a intentar la inserción.

Browser
CLI de Azure DevOps

Desde Project Configuración de repositorio, >puede habilitar o deshabilitar tamaño máximo de > y establecer el máximo.

Repositorio, Directivas, Configuración de tamaño máximo de archivo.

Nota

La directiva Tamaño máximo de archivo requiere TFS 2018.2 o una versión posterior.

Creación de una directiva de tamaño de archivo

Use az repos policy file-size create para administrar la directiva tamaño máximo az repos policy file-size create archivo.

az repos policy file-size create --blocking {false, true}
                                 --enabled {false, true}
                                 --maximum-git-blob-size
                                 --repository-id
                                 --use-uncompressed-size {false, true}

Parámetros

blocking: (obligatorio) Indica si la directiva debe estar bloqueando o no. Valores aceptados: false, true
enabled: (obligatorio) Si la directiva está habilitada o no. Valores aceptados: false, true
maximum-git-blob-size: (obligatorio) Tamaño máximo de blob de Git en bytes. Por ejemplo, para especificar un límite de 10bytes, --maximum-git-blob-size 10.
repository-id:identificador (obligatorio) del repositorio en el que se va a aplicar la directiva.
use-uncompressed-size: (obligatorio) Si se debe usar el tamaño sin comprimir. Valores aceptados: false, true

Ejemplo

En el ejemplo siguiente se recuperan los iD de los repositorios existentes mediante y, a continuación, se crea una directiva de tamaño máximo de archivo de 1 GB de az repos list bloqueo en el FabrikamFiber repositorio. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az repos list --output table
ID                                    Name           Default Branch    Project
------------------------------------  -------------  ----------------  -------------
6589f9e0-082b-4b96-9dfd-8141b7da409c  FabrikamFiber  master            FabrikamFiber

az repos policy file-size create --blocking true --enabled true --maximum-git-blob-size 10485760 --repository-id 6589f9e0-082b-4b96-9dfd-8141b7da409c --use-uncompressed-size true
{

  <Some properties omitted for space>

  },
  "createdDate": "2019-11-19T15:34:38.854450",
  "id": 2,
  "isBlocking": true,
  "isDeleted": false,
  "isEnabled": true,

  <Some properties omitted for space>

}

Actualización de la directiva de tamaño de archivo

Use az repos policy file-size update para administrar la directiva tamaño máximo az repos policy file-size update archivo.

az repos policy file-size update --id
                                 [--blocking {false, true}]
                                 [--detect {false, true}]
                                 [--enabled {false, true}]
                                 [--maximum-git-blob-size]
                                 [--org]
                                 [--project]
                                 [--repository-id]
                                 [--use-uncompressed-size {false, true}]

Parámetros

id o policy-id:identificador (obligatorio) de la directiva.
blocking:indica si la directiva debe estar bloqueando o no. Valores aceptados: false, true
detect:detecte automáticamente la organización. Valores aceptados: false, true
enabled:indica si la directiva está habilitada o no. Valores aceptados: false, true
maximum-git-blob-size:tamaño máximo de blob de Git en bytes. Por ejemplo, para especificar un límite de 10bytes, --maximum-git-blob-size 10.
organización u organización:Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git. 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 . Obligatorio si no está configurado como predeterminado o se selecciona a través de la configuración de Git.
repository-id:identificador (obligatorio) del repositorio en el que se va a aplicar la directiva.
use-uncompressed-size: (obligatorio) Si se debe usar el tamaño sin comprimir. Valores aceptados: false, true

Ejemplo

En el ejemplo siguiente se recuperan los iD de las directivas existentes mediante y, a continuación, se actualiza el tamaño máximo de la directiva de tamaño máximo de az repos policy list archivo en FabrikamFiber el repositorio. En este ejemplo se usa la siguiente configuración predeterminada: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az repos policy list --output table
ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
2     File size restriction    True           False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches
3     Git repository settings  True           True          6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches
4     Work item linking        False          False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches
5     Path Length restriction  True           False         6589f9e0-082b-4b96-9dfd-8141b7da409c  All Branches

az repos policy file-size update --id 2 --maximum-git-blob-size 20971520
{

  <Some properties omitted for space>

  "createdDate": "2019-11-19T16:09:32.960070+00:00",
  "id": 2,
  "isBlocking": true,
  "isDeleted": false,
  "isEnabled": true,
  "revision": 5,
  "settings": {
    "maximumGitBlobSizeInBytes": 20971520,
    "scope": [
      {
        "repositoryId": "6589f9e0-082b-4b96-9dfd-8141b7da409c"
      }
    ],
    "useUncompressedSize": true
  },

   <Some properties omitted for space>

}

Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.

Pasos siguientes

Mejora de la calidad del código con directivas de ramas

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Puede personalizar los repositorios Azure DevOps Git mediante la configuración de repositorios y directivas. Las opciones globales de repositorios completos se configuran mediante la configuración del repositorio. También hay controles específicos del usuario y específicos de la rama, cubiertos por permisos y directivas de rama, respectivamente.

En este artículo se trata la configuración del repositorio del lado servidor. También puede que quiera obtener información sobre las preferencias de Git del lado cliente.

Nota

La característica documentada en este artículo requiere TFS 2018 Update 2 o una versión posterior.

Para la configuración específica de la rama, revise las directivas de rama. Estas incluyen opciones como requerir una solicitud de extracción, una compilación correcta o una revisión de código. Para la configuración específica del usuario, revise los permisos. Los permisos permiten controlar quién puede leer, escribir, contribuir a las solicitudes de extracción y otras acciones específicas.

Resumen de todas las configuraciones de repositorio y rama

Puede configurar varias configuraciones y directivas para todos los repositorios, para repositorios individuales y para ramas individuales de un repositorio. Todos se establecen a través de Project Configuración.

Nota

Se recomienda configurar los valores del repositorio en el nivel de proyecto o para cada repositorio individual, pero no ambos. Si se establece en ambos niveles, el sistema respeta la configuración más restrictiva. La configuración de estos valores en un solo nivel elimina esta complejidad y evita una disminución del rendimiento de Git.

Toda la configuración del repositorio

En la tabla siguiente se resumen los valores que puede habilitar y configurar para todos los repositorios de Git creados para un proyecto.

Configuración

Valor predeterminado

Descripción

Configuración y directivas del repositorio de Git

Valore su experiencia

Configuración de repositorio individual

Directivas de repositorio

Directivas de rama

Requisitos previos

Visualización y edición de la configuración del repositorio

Preferencia de nombre de rama predeterminada

Administración de directivas entre repositorios

Horquillas

Vinculación de elementos de trabajo

Confirmación de la validación del correo electrónico del autor

Validación de ruta de acceso de archivo

Aplicación de casos

Nombres reservados y Longitud máxima de la ruta de acceso

Tamaño de archivo máximo

Pasos siguientes

Artículos relacionados

Resumen de todas las configuraciones de repositorio y rama

Toda la configuración del repositorio