Configurar definições e políticas do repositório do Git

Para definir as configurações e políticas do repositório por meio do portal da Web, abra Repositórios de configurações>do Project no navegador da Web.

1. Para visualizar ou modificar configurações ou políticas para todos os repositórios Git, abra a página Todos os repositórios e escolha Configurações ou Políticas.

   

   Para definir configurações e políticas para um repositório específico, selecione a guia Repositórios , escolha o repositório e, em seguida, escolha a guia Configurações ou Políticas .

   

2. A captura de tela a seguir mostra a guia Configurações selecionada. Você pode definir essas configurações para todos os repositórios Git ou para um repositório individual.

   

3. A captura de tela a seguir mostra a guia Políticas selecionada. Você pode definir essas políticas para todos os repositórios Git ou para um repositório individual.

   

1. No navegador da Web, abra o projeto e escolha Configurações do projeto, Repositórios e selecione seu repositório.

   

2. Para visualizar e definir as configurações do repositório, selecione Opções ou Políticas.

   A captura de tela a seguir mostra Opções para todos os repositórios:

   

   A captura de tela a seguir mostra Opções para os repositórios da Fabrikam:

   

Você pode usar a CLI do Azure DevOps para listar repositórios ou mostrar ou atualizar um repositório. Além disso, você pode listar, mostrar ou atualizar detalhes da política de uma filial ou repositório.

Listar repositórios | Listar detalhes | do repositório Atualizar ou renomear um repositório
Listar políticas | do repositório Listar detalhes | da política Atualizar política do repositório

Você pode usar a CLI do Azure para listar, mostrar e atualizar políticas para uma filial ou repositório, ou para todos os repositórios em um projeto.

Listar repositórios

Use az repos list para listar todos os repositórios de um projeto.

az repos list [--detect {false, true}]
              [--org]
              [--project]
              [--subscription]

Parâmetros

Exemplo

O comando a seguir retorna todos os repositórios Git para a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão.

az repos list --output table
ID                                    Name            Default Branch    Project
------------------------------------  --------------  ----------------  --------------
50a9df8e-5024-49d7-bf63-d3989139627e  Fabrikam Fiber  main              Fabrikam Fiber
ac228555-ea89-4881-9ace-dfa065baf7d3  Test 1-2-3      main              Fabrikam Fiber
0d58f562-4a10-495d-94d7-7ac61a22d7cc  Testing 1 2 3   main              Fabrikam Fiber
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO     main              Fabrikam Fiber

Listar detalhes do repositório

Use az repos show para listar informações sobre um repositório ou abri-lo em um navegador da Web.

az repos show --repository
              [--detect {false, true}]
              [--open]
              [--org]
              [--project]
              [--subscription]

Parâmetros

Exemplo

O comando a seguir lista os detalhes do contosoREPO para a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão.

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Para obter mais detalhes, digite o seguinte comando:

az repos show --repository contosoREPO
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoREPO",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikamprime/Fabrikam%20Fiber/contosoREPO",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO"
}

Atualizar um repositório

Você pode usar az repos update para atualizar a ramificação padrão ou renomear um repositório.

az repos show --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]
                [--subscription]

Parâmetros

Exemplo

O comando a seguir renomeia contosoREPO para contosoFabrikam para a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão.

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Para obter mais detalhes, digite o seguinte comando:

az repos update --repository contosoREPO --name contosoFabrikam
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoFabrikam",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/Fabrikam%20Fiber/contosoFabrikam",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam"
}

Políticas de lista

Use az repos policy list para listar todas as políticas de todos os repositórios e ramificações do projeto. Use os repository-id parâmetros e branch para listar políticas para repositórios e ramificações específicos.

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--repository-id]
                     [--subscription]

Parâmetros

Exemplo

O comando a seguir retorna todas as políticas em vigor no projeto padrão. Este exemplo usa a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão .

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

Mostrar detalhes da política

Para mostrar os detalhes de qualquer política, use az repos policy show. Você pode obter o ID da política executando az repos policy list.

az repos policy show --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--subscription]

Parâmetros

Exemplo

O exemplo a seguir mostra o nome e os detalhes da ID 1 da política no projeto padrão. Este exemplo usa a configuração padrão az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

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

Atualizar políticas

Você pode usar a atualização de política az repos da CLI do Azure com um arquivo de configuração de política para atualizar políticas. Um arquivo de configuração de política pode aplicar uma política em mais de um escopo de cada vez. Para obter mais informações, consulte Configurar políticas de repositório Git usando um arquivo de configuração. Para obter exemplos de arquivos de configuração de política, consulte Configurações - Criar.

az repos policy update --config
                       --id
                       [--detect {false, true}]
                       [--org]
                       [--project]
                       [--subscription]

Parâmetros

Exemplo

O arquivo de policy.json a seguir define a política de revisores mínimos para exigir três aprovações em todas as main ramificações em todos os repositórios no projeto padrão.

{
  "isEnabled": true,
  "isBlocking": false,
  "type": {
    "id": "fa4e907d-c16b-4a4c-9dfa-4906e5d171dd"
  },
  "settings": {
    "minimumApproverCount": 3,
    "creatorVoteCounts": false,
    "scope": [
      {
        "repositoryId": null,
        "refName": "refs/heads/main",
        "matchKind": "exact"
      }
    ]
  }
}

A az repos policy update linha de comando atualiza a política de revisores mínimos de acordo com o arquivo policy.json . Você pode encontrar o ID da política usando az repos policy list. O exemplo usa a configuração padrão az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy update --config C:\policies\policy.json --id 7 --output table

ID    Name                         Is Blocking    Is Enabled    Branch
----  ---------------------------  -------------  ------------  -----------------
7     Minimum number of reviewers  False          True          refs/heads/main

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Para definir a política de aplicação de casos:

1. Selecione Repositórios de configurações>do projeto e selecione um repositório se quiser configurar apenas esse repositório.
2. Na guia Políticas da página Todos os repositórios ou <Nome> do repositório, em Políticas do repositório, defina Imposição de maiúsculas e minúsculas como Ativado ou Desativado.

Você pode usar a política az repos do Azure CLI az repos case-enforcement create e az repos policy case-enforcement update para configurar ou atualizar a política de imposição de casos.

Criar política de aplicação de casos

Use az repos case-enforcement create para criar uma política de aplicação de casos.

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

Parâmetros

Exemplo

O exemplo a seguir implementa uma política de imposição de casos necessária no Fabrikam repositório. Você pode obter o ID do repositório usando az repos list. Este exemplo usa a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão .

az repos policy case-enforcement create --blocking true --enabled true --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Atualizar a política de aplicação de casos

Use az repos policy case-enforcement update para gerenciar a política de aplicação de casos.

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

Parâmetros

Exemplo

O exemplo a seguir atualiza a política de imposição de casos no Fabrikam repositório para não ser mais habilitada ou bloqueada. Este exemplo usa a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão .

az repos policy case-enforcement update --blocking false --enabled false --policy-id 40 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  False          False         d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.

Use az repos policy file-size create e az repos policy file-size update para gerenciar a política de tamanho máximo de arquivo.

Criar política de tamanho de arquivo

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

Parâmetros

Exemplo

O exemplo a seguir cria uma política de tamanho máximo de arquivo de bloqueio de 1 GB no Fabrikam repositório. Você pode obter o ID do repositório usando az repos list. Este exemplo usa a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão .

az repos policy file-size create --blocking true --enabled true --maximum-git-blob-size 10485760 --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --use-uncompressed-size true --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Atualizar a política de tamanho de arquivo

Use az repos policy file-size update para gerenciar a política de tamanho máximo de arquivo.

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

Parâmetros

Exemplo

O exemplo a seguir atualiza o tamanho máximo do Fabrikam arquivo no repositório. O exemplo usa a configuração az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"padrão .

az repos policy file-size update --id 45 --maximum-git-blob-size 20971520 --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Os comandos da CLI do Azure DevOps não são suportados para o Servidor de DevOps do Azure.