Ustawianie ustawień i zasad repozytorium Git

| usługi Azure DevOps Services Azure DevOps Server 2020 | Usługa Azure DevOps Server 2019 | TFS 2018

Istnieje kilka sposobów dostosowywania repozytoriów Git usługi Azure Repos przy użyciu ustawień i zasad gałęzi i repozytorium. W tym artykule omówiono ustawienia i zasady na poziomie repozytorium.

• Ustawienia i zasady repozytorium konfigurują globalne opcje dla wszystkich repozytoriów Git dla projektu lub organizacji lub dla poszczególnych repozytoriów.

  W tym artykule omówiono ustawienia i zasady repozytorium po stronie serwera. Aby dowiedzieć się więcej o preferencjach usługi Git po stronie klienta, zobacz Preferencje i ustawienia usługi Git w programie Visual Studio.

• Zasady gałęzi obejmują kontrolki specyficzne dla gałęzi.

  Zasady gałęzi obejmują opcje, takie jak wymaganie żądania ściągnięcia, pomyślna kompilacja lub przegląd kodu, zanim zmiany zostaną scalone z gałęzią. Aby uzyskać więcej informacji, zobacz Zasady i ustawienia gałęzi.

• Uprawnienia zabezpieczeń repozytorium i gałęzi kontrolują przypisania użytkowników.

  Te uprawnienia kontrolują, kto może odczytywać, zapisywać, współtworzyć żądania ściągnięcia i podejmować inne konkretne akcje. Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień dla repozytorium.

Uwaga

Funkcja udokumentowana w tym artykule wymaga serwera TFS 2018 Update 2 lub nowszej wersji.

Podsumowanie wszystkich ustawień i zasad dotyczących repozytorium i gałęzi

Można skonfigurować ustawienia i zasady dla wszystkich repozytoriów w projekcie, dla poszczególnych repozytoriów i dla gałęzi repozytoriów. W przeglądarce skonfigurujesz wszystkie te ustawienia i zasady za pomocą pozycji ProjectsettingsRepositories>.

Uwaga

Za pomocą interfejsu wiersza polecenia platformy Azure można ustawić kilka ustawień gałęzi i zasad za pomocą polecenia az repos policy.

W poniższych tabelach podsumowano ustawienia i zasady, które można włączyć i skonfigurować dla repozytoriów i gałęzi Git.

Wszystkie ustawienia repozytoriów

Poniższa tabela zawiera podsumowanie ustawień, które można włączyć i skonfigurować dla wszystkich nowych repozytoriów Git w projekcie lub w organizacji.

Ustawienie

Domyślny

Opis

---

Domyślna nazwa gałęzi dla nowych repozytoriów

Wyłączone

Zainicjuj nowe repozytoria przy użyciu podanej domyślnej nazwy gałęzi. Możesz zmienić gałąź domyślną dla określonego repozytorium w dowolnym momencie. Jeśli ta funkcja nie zostanie włączona, repozytoria zainicjują się przy użyciu gałęzi domyślnej o nazwie main.

Zezwalaj użytkownikom na zarządzanie uprawnieniami dla utworzonych gałęzi

Włączone

Zezwalaj użytkownikom na zarządzanie uprawnieniami dla utworzonych gałęzi we wszystkich nowych repozytoriach.

Ustawienia repozytoriów

Poniższa tabela zawiera podsumowanie ustawień, które można włączyć lub skonfigurować dla każdego repozytorium Git.

Ustawienie

Domyślny

Opis

---

Obrazy Gravatar

Włączone

Włącza lub wyłącza korzystanie z obrazów Gravatar dla użytkowników spoza przedsiębiorstwa. To ustawienie dotyczy wszystkich repozytoriów w projekcie.

Widelce

Włączone

Zezwalaj użytkownikom na tworzenie rozwidlenia z repozytorium.

Zatwierdź łączenie wzmianki

Włączone

Automatycznie twórz łącza dla elementów roboczych wymienionych w komentarzu zatwierdzenia.

Zatwierdzanie rozpoznawania wzmianki o elemencie roboczym

Włączone

Zezwalaj na wzmianek w komentarzach zatwierdzeń w celu zamknięcia elementów roboczych. Wymaga aktualizacji usługi Azure DevOps Server 2020.1 lub nowszej.

Preferencje przejścia elementu roboczego

Włączone

Pamiętaj preferencje użytkownika dotyczące kończenia elementów roboczych za pomocą żądań ściągnięcia.

Zarządzanie uprawnieniami

Włączone

Zezwalaj użytkownikom na zarządzanie uprawnieniami dla utworzonych gałęzi

Tryb ścisłego głosowania

Włączone

Włącz tryb ścisłego głosowania dla repozytorium, co wymaga uprawnienia Współtworzenie do głosowania na żądaniach ściągnięcia.

Wyłączanie repozytorium

Włączone

Wyłącz dostęp do repozytorium, w tym kompilacji i żądań ściągnięcia, ale zachowaj możliwość odnajdywania repozytorium z ostrzeżeniem.

Gałęzie z możliwością wyszukiwania

Włączone

Określ maksymalnie pięć kolejnych gałęzi do udziału w wyszukiwaniu kodu, które domyślnie ma zastosowanie tylko do gałęzi domyślnej. Wymaga zainstalowanego i włączonego rozszerzenia wyszukiwania kodu .

Zasady lub opcje repozytorium

Poniższa tabela zawiera podsumowanie zasad lub opcji, które można ustawić dla wszystkich lub poszczególnych repozytoriów. Zasady ustawione dla wszystkich repozytoriów ustawiają wartość domyślną dla poszczególnych repozytoriów dodanych w późniejszym terminie.

Zasady lub opcja

Domyślny

Opis

---

Zatwierdzanie weryfikacji wiadomości e-mail autora

Wyłączone

Blokuj wypychanie przy użyciu wiadomości e-mail autora zatwierdzenia, która nie jest zgodna z określonymi wzorcami. To ustawienie wymaga programu Azure DevOps Server 2020.1 lub nowszej wersji.

Walidacja ścieżki pliku

Wyłączone

Blokuj wypychanie przed wprowadzeniem ścieżek plików pasujących do określonych wzorców. To ustawienie wymaga programu Azure DevOps Server 2020.1 lub nowszej wersji.

Wymuszanie sprawy

Wyłączone

Unikaj konfliktów poufności liter, blokując wypychanie, które zmienia wielkość liter w plikach, folderach, gałęziach i tagach.

Nazwy zarezerwowane

Wyłączone

Blokuj wypychania, które wprowadzają pliki, foldery lub nazwy gałęzi, które zawierają nazwy zarezerwowane platformy lub niezgodne znaki.

Maksymalna długość ścieżki

Wyłączone

Blokuj wypychania, które wprowadzają ścieżki przekraczające określoną długość.

Maksymalna wielkość pliku

Wyłączone

Blokuj wypychania zawierające nowe lub zaktualizowane pliki większe niż wybrany limit.

Zasady gałęzi

Poniższa tabela zawiera podsumowanie zasad, które można zdefiniować w celu dostosowania gałęzi. Aby uzyskać więcej informacji na temat konfigurowania tych ustawień, zobacz Poprawianie jakości kodu przy użyciu zasad gałęzi. Po ustawieniu jakichkolwiek zasad w gałęzi następujące zasady są automatycznie wymuszane:

• Żądania ściągnięcia są wymagane do zaktualizowania gałęzi.
• Nie można usunąć gałęzi.

Zasada

Domyślny

Opis

---

Wymagaj minimalnej liczby recenzentów

Wyłączone

Wymagaj zatwierdzenia od określonej liczby recenzentów żądań ściągnięcia.

Sprawdzanie połączonych elementów roboczych

Wyłączone

Zachęcaj do śledzenia, sprawdzając połączone elementy robocze dotyczące żądań ściągnięcia.

Sprawdzanie rozwiązywania komentarzy

Wyłączone

Sprawdź, czy wszystkie komentarze zostały rozwiązane w żądaniach ściągnięcia.

Ograniczanie typów scalania lub wymuszanie strategii scalania

Wyłączone

Kontrolowanie historii gałęzi przez ograniczenie dostępnych typów scalania po zakończeniu żądań ściągnięcia.

Weryfikacja kompilacji

Wyłączone

Dodaj, włącz lub wyłącz co najmniej jedną zasady, aby zweryfikować kod przez wstępne scalanie i kompilowanie zmian żądań ściągnięcia.

Sprawdzanie stanu lub
Wymagaj zatwierdzenia od dodatkowych lub zewnętrznych usług

Wyłączone

Dodaj, włącz lub wyłącz co najmniej jedną zasady, aby wymagać od innych usług publikowania stanu pomyślnego ukończenia żądań ściągnięcia.

Automatycznie dołączane recenzentów

Wyłączone

Dodaj, włącz lub wyłącz co najmniej jedną zasady, aby wyznaczyć recenzentów kodu w celu automatycznego uwzględnienia żądań ściągnięcia, gdy żądania ściągnięcia zmieniają niektóre obszary kodu.

Wymagania wstępne

• Aby skonfigurować zasady, musisz być członkiem grupy zabezpieczeń administratorzy Project lub mieć uprawnienia do edycji zasad na poziomie repozytorium. Aby dowiedzieć się więcej, zobacz Ustawianie uprawnień repozytorium Git.
• Jeśli chcesz użyć poleceń az repos, wykonaj kroki opisane w Wprowadzenie za pomocą interfejsu wiersza polecenia Azure DevOps.

• Aby skonfigurować zasady, musisz być członkiem grupy zabezpieczeń administratorzy Project lub mieć uprawnienia do edycji zasad na poziomie repozytorium. Aby dowiedzieć się więcej, zobacz Ustawianie uprawnień repozytorium Git.

Wyświetlanie i edytowanie ustawień i zasad

Można skonfigurować ustawienia dla wszystkich repozytoriów w organizacji lub projekcie albo dla poszczególnych repozytoriów. Można skonfigurować zasady dla wszystkich repozytoriów, dla poszczególnych repozytoriów lub dla określonych gałęzi między repozytoriami. Aby uzyskać informacje na temat ustawiania zasad gałęzi, zobacz Zasady gałęzi.

Uwaga

Najlepiej skonfigurować ustawienia repozytorium na poziomie projektu lub dla poszczególnych repozytoriów, ale nie dla obu tych repozytoriów. Jeśli skonfigurujesz ustawienia na więcej niż jednym poziomie, system będzie przestrzegać najbardziej restrykcyjnego ustawienia. Konfigurowanie ustawień na jednym poziomie zmniejsza pomyłek i problemy z wydajnością usługi Git.

Przeglądarka

Aby skonfigurować ustawienia i zasady repozytorium za pośrednictwem portalu internetowego, otwórz ProjectustawieniaRepositories> w przeglądarce internetowej.

1. Aby wyświetlić lub zmodyfikować ustawienia lub zasady dla wszystkich repozytoriów Git, otwórz stronę Wszystkie repozytoria i wybierz pozycję Ustawienia lub zasady.

   

   Aby skonfigurować ustawienia i zasady dla określonego repozytorium, wybierz kartę Repozytoria, wybierz repozytorium, a następnie wybierz kartę Ustawienia lub Zasady.

   

2. Poniższy zrzut ekranu przedstawia wybraną kartę Ustawienia. Możesz zdefiniować te ustawienia dla wszystkich repozytoriów Git lub dla pojedynczego repozytorium.

   

3. Poniższy zrzut ekranu przedstawia wybraną kartę Zasady . Te zasady można zdefiniować dla wszystkich repozytoriów Git lub dla pojedynczego repozytorium.

   

1. W przeglądarce internetowej otwórz projekt i wybierz Project ustawienia, repozytoria i wybierz repozytorium.

   

2. Aby wyświetlić i skonfigurować ustawienia repozytorium, wybierz pozycję Opcje lub Zasady.

   Poniższy zrzut ekranu przedstawia opcje dla wszystkich repozytoriów:

   

   Poniższy zrzut ekranu przedstawia opcje repozytoriów firmy Fabrikam:

   

1. W przeglądarce internetowej otwórz projekt i wybierz ikonę koła zębatego, kontrolę wersji i wybierz repozytorium.

   

2. Wybierz pozycję Opcje , aby wyświetlić i skonfigurować ustawienia repozytorium.

   

Interfejs wiersza polecenia usługi Azure DevOps

Za pomocą interfejsu wiersza polecenia Azure DevOps można wyświetlić listę repozytoriów lub wyświetlić lub zaktualizować repozytorium. Ponadto możesz wyświetlić listę, wyświetlić lub zaktualizować szczegóły zasad dla gałęzi lub repozytorium.

Wyświetlanie listy repozytoriów | Szczegóły | repozytorium listyAktualizowanie lub zmienianie nazwy repozytorium
Wyświetlanie listy zasad | repozytorium Szczegóły zasad | listy Aktualizowanie zasad respository

Interfejs wiersza polecenia platformy Azure umożliwia wyświetlanie, wyświetlanie i aktualizowanie zasad dla gałęzi lub repozytorium albo wszystkich repozytoriów w projekcie.

Tworzenie listy repozytoriów

Użyj polecenia az repos list , aby wyświetlić listę wszystkich repozytoriów dla projektu.

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

Parametry

Parametr	Opis
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org, organization	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.
subscription	Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Następujące polecenie zwraca wszystkie repozytoria Git dla konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Szczegóły repozytorium listy

Użyj polecenia az repos show , aby wyświetlić informacje o repozytorium lub otworzyć je w przeglądarce internetowej.

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

Parametry

Parametr	Opis
repository	Nazwa lub identyfikator repozytorium.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
open	Otwórz stronę repozytorium w przeglądarce internetowej.
org, organization	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git.
subscription	Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Następujące polecenie wyświetla szczegóły obiektu contosoREPO dla konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Aby uzyskać więcej informacji, wprowadź następujące polecenie:

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"
}

Aktualizowanie repozytorium

Możesz użyć polecenia az repos update , aby zaktualizować gałąź domyślną lub zmienić nazwę repozytorium.

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

Parametry

Parametr	Opis
repository	Nazwa lub identyfikator repozytorium.
default-branch	Określ domyślną gałąź do ustawienia dla repozytorium. Przykład: "refs/heads/live" lub "live".
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
name	Nowa nazwa repozytorium.
org, organization	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git.
subscription	Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Następujące polecenie zmienia nazwę obiektu contosoREPO na contosoFabrikam na domyślną konfigurację az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

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

Aby uzyskać więcej informacji, wprowadź następujące polecenie:

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"
}

Wyświetlanie listy zasad

Użyj polecenia az repos policy list , aby wyświetlić listę wszystkich zasad dla wszystkich repozytoriów projektów i gałęzi. repository-id Użyj parametrów i branch , aby wyświetlić listę zasad dla określonych repozytoriów i gałęzi.

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

Parametry

Parametr	Opis
branch	Nazwa gałęzi, aby filtrować wyniki według dokładnego dopasowania. Parametr --repository-id jest wymagany do używania filtru gałęzi. Na przykład: --branch main.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org, organization	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git.
query-examples	Zalecany ciąg JMESPath. Możesz skopiować jedno z zapytań i wkleić je po parametrze --query w podwójnym cudzysłowie, aby wyświetlić wyniki. Możesz dodać co najmniej jedno słowo kluczowe pozycyjne, aby sugestie były oparte na tych słowach kluczowych.
repository-id	Identyfikator repozytorium, aby filtrować wyniki według dokładnego dopasowania. Na przykład --repository-id e556f204-53c9-4153-9cd9-ef41a11e3345.
subscription	Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Następujące polecenie zwraca wszystkie zasady obowiązujące w projekcie domyślnym. W tym przykładzie użyto konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Pokaż szczegóły zasad

Aby wyświetlić szczegóły dowolnych zasad, użyj polecenia az repos policy show. Identyfikator zasad można uzyskać, uruchamiając polecenie az repos policy list.

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

Parametry

Parametr	Opis
id, policy-id	Identyfikator zasad. Wymagane.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org, organization	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git.
query-examples	Zalecany ciąg JMESPath. Możesz skopiować jedno z zapytań i wkleić je po parametrze --query w podwójnym cudzysłowie, aby wyświetlić wyniki. Możesz dodać co najmniej jedno słowo kluczowe pozycyjne, aby sugestie były oparte na tych słowach kluczowych.
subscription	Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

W poniższym przykładzie przedstawiono nazwę i szczegóły identyfikatora 1 zasad w projekcie domyślnym. W tym przykładzie użyto konfiguracji domyślnej 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

Zasady aktualizacji

Aby zaktualizować zasady, możesz użyć polecenia platformy Azure az repos policy update z plikiem konfiguracji zasad. Plik konfiguracji zasad może stosować zasady w więcej niż jednym zakresie jednocześnie. Aby uzyskać więcej informacji, zobacz Konfigurowanie zasad repozytorium Git przy użyciu pliku konfiguracji. Przykłady plików konfiguracji zasad można znaleźć w temacie Konfiguracje — tworzenie.

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

Parametry

Parametr	Opis
--config, --policy-configuration	Ścieżka pliku lokalnego dla pliku konfiguracji zasad. Użyj ukośnika odwrotnego \ podczas wprowadzania ścieżki katalogu. Wymagane.
id, policy-id	Identyfikator zasad do zaktualizowania. Wymagane.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org, organization	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git.
subscription	Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Poniższy plik policy.json ustawia minimalne zasady recenzentów, aby wymagać trzech zatwierdzeń we wszystkich main gałęziach we wszystkich repozytoriach w projekcie domyślnym.

{
  "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"
      }
    ]
  }
}

Wiersz az repos policy update polecenia aktualizuje minimalne zasady recenzentów dla pliku policy.json . Identyfikator zasad można znaleźć za pomocą polecenia az repos policy list. W przykładzie użyto konfiguracji domyślnej 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

Azure DevOps polecenia interfejsu wiersza polecenia nie są obsługiwane w środowisku lokalnym Azure DevOps Server.

Domyślna nazwa gałęzi

Możesz ustawić domyślną nazwę gałęzi repozytorium na poziomie organizacji lub projektu. Ustawienie na poziomie organizacji ma zastosowanie dla wszystkich nowych repozytoriów we wszystkich projektach w organizacji. Ustawienie na poziomie projektu wpływa na wszystkie nowe repozytoria w projekcie i zastępuje wszystkie nazwy ustawione na poziomie organizacji.

Oto co możesz zrobić:

• Wybierz dowolną nazwę gałęzi prawnej, która ma być używana podczas inicjowania repozytorium.
• Zmień nazwę domyślną w dowolnym momencie, aby wpłynąć na wszystkie przyszłe repozytoria.
• Zmień domyślną nazwę gałęzi dla dowolnego konkretnego repozytorium w dowolnym momencie.

Jeśli nie włączysz domyślnej funkcji nazwy gałęzi, repozytoria zainicjują się przy użyciu domyślnej nazwy maingałęzi Azure Repos .

Aby ustawić domyślną nazwę gałęzi na poziomie organizacji:

1. Na stronie Azure DevOps organizacji wybierz pozycję Ustawienia organizacji w lewym dolnym rogu, a następnie wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na stronie Wszystkie repozytoria ustaw domyślną nazwę gałęzi dla nowych repozytoriów na Wł., a następnie wprowadź domyślną nazwę gałęzi.

Aby ustawić domyślną nazwę gałęzi na poziomie projektu:

1. Na stronie projektu Azure DevOps wybierz pozycję Project ustawienia w lewym dolnym rogu, a następnie wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na karcie Ustawienia na stronie Wszystkie repozytoria ustaw domyślną nazwę gałęzi dla nowych repozytoriów na Wł., a następnie wprowadź domyślną nazwę gałęzi.

Uwaga

Ustawienie Domyślna nazwa gałęzi dla nowych repozytoriów wymaga Azure DevOps Server wersji 2020.1 lub nowszej.

Zarządzanie uprawnieniami do gałęzi

Możesz kontrolować, kto może zarządzać uprawnieniami dla gałęzi repozytoriów, ustawiając ustawienie zarządzania uprawnieniami dla wszystkich repozytoriów Git lub dla poszczególnych repozytoriów. Jeśli włączysz ustawienie Zezwalaj użytkownikom na zarządzanie uprawnieniami dla utworzonych gałęzi na poziomie Wszystkie repozytoria , wszystkie nowe repozytoria projektów zostaną skonfigurowane tak, aby umożliwić użytkownikom zarządzanie uprawnieniami dla utworzonych gałęzi.

Aby zarządzać tym ustawieniem:

1. Na stronie projektu Azure DevOps wybierz pozycję Project ustawienia w lewym dolnym rogu, a następnie wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na karcie Ustawienia na stronie Wszystkie repozytoria ustaw opcję Zezwalaj użytkownikom na zarządzanie uprawnieniami dla utworzonych gałęzi na wartość Włączone lub Wyłączone.

Aby włączyć lub wyłączyć to ustawienie dla poszczególnych repozytoriów:

1. Wybierz pozycję Project Ustawienia>Popositories, a następnie wybierz repozytorium.
2. Na karcie<Ustawienia na stronie Nazwa> repozytorium ustaw pozycję Zarządzanie uprawnieniami na Wł. lub Wył.

Obrazy Gravatar

To ustawienie włącza lub wyłącza korzystanie z obrazów Gravatar dla użytkowników spoza przedsiębiorstwa.

Obrazy Gravatar to ustawienie na poziomie organizacji.

1. Na stronie Azure DevOps organizacji wybierz pozycję Ustawienia organizacji w lewym dolnym rogu, a następnie wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na stronie Wszystkie repozytoria ustaw opcję Obrazy Gravatar na Wł . lub Wył.

Gravatar images to ustawienie na poziomie projektu dla wszystkich repozytoriów.

1. Na stronie projektu Azure DevOps wybierz pozycję Project ustawienia w lewym dolnym rogu, a następnie wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na karcie Ustawienia na stronie Wszystkie repozytoria ustaw opcję Obrazy Gravatar na Wł. lub Wył.

Gravatar images to ustawienie na poziomie projektu dla wszystkich repozytoriów.

1. Na stronie projektu Azure DevOps wybierz pozycję Project ustawienia w lewym dolnym rogu, a następnie wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na karcie Ustawienia na stronie Wszystkie repozytoria ustaw opcję Obrazy Gravatar na Wł. lub Wył.

Gravatar images to indywidualne ustawienie repozytorium.

Włączanie rozwidlenia

To ustawienie repozytorium określa, czy użytkownicy mogą tworzyć nowe rozwidlenia po stronie serwera. Wyłączenie tego ustawienia nie powoduje usunięcia istniejących rozwidleń.

1. W Project Ustawienia wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.
2. Na karcie Repozytoria na stronie Wszystkie repozytoria wybierz repozytorium.
3. Na karcie <Ustawienia na stronie Nazwa> repozytorium ustaw opcję Rozwidlenia na Wł. lub Wył.

Ustawienia łączenia elementów roboczych

Te ustawienia repozytorium zarządzają łączeniem elementów roboczych.

1. Wybierz pozycję Project Ustawienia>Popositories, a następnie wybierz repozytorium.
2. Na karcie <Ustawienia na stronie Nazwa> repozytorium włącz lub wyłącz ustawienia.

Zatwierdź łączenie wzmianki

Po włączeniu zatwierdzanie # komunikatów zawierających prawidłowy identyfikator elementu roboczego automatycznie łączy zatwierdzenie z tym elementem roboczym. Wyłącz to ustawienie, jeśli repozytorium wcześniej używało innego konta lub usługi. Te repozytoria mogą zawierać komunikaty zatwierdzenia z wzmiankami # , które nie pasują do identyfikatorów elementów roboczych na bieżącym koncie.

Zatwierdzanie rozpoznawania wzmianki o elemencie roboczym

Włącz to ustawienie, aby automatycznie wykonywać elementy robocze po zakończeniu połączonych żądań ściągnięcia. To ustawienie umożliwia również określanie innych stanów przejścia elementów roboczych w komunikatach zatwierdzenia żądania ściągnięcia. Aby uzyskać więcej informacji, zobacz Autouzupełnianie elementów roboczych z żądaniami ściągnięcia.

Zatwierdzanie rozpoznawania wzmianki o elemencie roboczym

Włącz to ustawienie, aby automatycznie ukończyć te elementy robocze po pomyślnym ukończeniu żądania ściągnięcia. Aby dowiedzieć się więcej, zobacz Autouzupełnianie elementów roboczych za pomocą żądań ściągnięcia.

Preferencje przejścia elementu roboczego

Domyślnie opcja ukończenia połączonych elementów roboczych podczas kończenia żądania ściągnięcia zapamiętuje ostatni wybór każdego użytkownika. Teams, które chcą zniechęcać użytkowników do kończenia elementów roboczych za pomocą żądań ściągnięcia, mogą wyłączyć to ustawienie. Użytkownicy muszą następnie wyrazić zgodę na ukończenie elementów roboczych za każdym razem, gdy ukończą żądanie ściągnięcia.

Ustawienie Tryb głosowania ścisłego

W niektórych sytuacjach użytkownicy, którzy nie są współautorami repozytorium, mogą przesłać żądanie ściągnięcia i spowodować scalenie go w zależności od zasad. Aby temu zapobiec, włącz tryb ścisłego głosowania , aby zmienić wymagane uprawnienie do głosowania na żądania ściągnięcia repozytorium na współtworzenie. Włączenie tego ustawienia jest zalecane, jeśli polegasz na rozwidleniu użytkownika w Azure Repos.

1. Wybierz pozycję Project Ustawienia>Popositories, a następnie wybierz repozytorium.
2. Na karcie <Ustawienia na stronie Nazwa> repozytorium ustaw opcję Tryb głosowania ścisłego na Wł. lub Wył.

Wyłącz ustawienie repozytorium

Włączenie tego ustawienia wyłącza dostęp do repozytorium, w tym kompilacji i żądań ściągnięcia, ale zachowuje możliwość odnajdywania repozytorium z ostrzeżeniem.

1. Wybierz pozycję Project Ustawienia>Popositories, a następnie wybierz repozytorium.
2. Na karcie <Ustawienia na stronie Nazwa> repozytorium w obszarze Wyłącz repozytorium ustaw opcję Wyłącz repozytorium na wartość Włączone lub Wyłączone.

Ustawienie gałęzi z możliwością wyszukiwania

Domyślnie wyszukiwanie kodu w plikach ma zastosowanie tylko do gałęzi domyślnej. Możesz dodać maksymalnie pięć kolejnych gałęzi do wyszukiwania.

Ważne

Aby wyszukać kod w repozytoriach, musisz zainstalować rozszerzenie wyszukiwania kodu w witrynie Marketplace. Jeśli nie widzisz gałęzi z możliwością wyszukiwania na karcie Ustawienia repozytorium, upewnij się, że masz zainstalowane rozszerzenie.

Aby dodać gałęzie do wyszukiwania kodu:

1. Wybierz pozycję Project Ustawienia>Popositories, a następnie wybierz repozytorium.
2. Na karcie Ustawienia na <stronie Nazwa> repozytorium wybierz pozycję +Gałęzie z możliwością wyszukiwania.
3. Wybierz gałąź do uwzględnienia w wyszukiwaniu, a następnie wybierz pozycję Dodaj gałąź.

Uwaga

Ustawienie Gałęzie z możliwością wyszukiwania wymaga wersji Azure DevOps Server 2020.1 lub nowszej.

Zasady między gałęziami repozytorium

Można ustawić zasady dla określonej nazwy gałęzi lub w gałęzi domyślnej we wszystkich repozytoriach w projekcie. Można na przykład wymagać dwóch minimalnych recenzentów dla wszystkich żądań ściągnięcia w każdej main gałęzi dla wszystkich repozytoriów projektów.

Aby ustawić zasady ochrony określonych lub domyślnych nazw gałęzi w projekcie:

1. W Project Ustawienia wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.

2. Na stronie Wszystkie repozytoria wybierz kartę Zasady .

3. Wybierz znak + plusa Zasady gałęzi w dolnej części strony.

4. Na ekranie Dodawanie ochrony gałęzi wybierz pozycję Chroń domyślną gałąź każdego repozytorium lub Chroń bieżące i przyszłe gałęzie zgodne z określonym wzorcem.

   Jeśli wybierzesz drugą opcję, wprowadź nazwę gałęzi do ochrony. Komunikat informacyjny informuje o tylu bieżących gałęziach, których dotyczy problem. Gałąź nie musi jeszcze istnieć, aby chronić nazwę gałęzi.

5. Wybierz przycisk Utwórz.

   

6. Na stronie Zasady między repozytoriami dla <nazwy> gałęzi ustaw zasady dla chronionych gałęzi. Aby uzyskać więcej informacji na temat zasad gałęzi, zobacz Zasady gałęzi.

   

Zatwierdzanie zasad weryfikacji wiadomości e-mail autora

Te zasady blokują zatwierdzenia w repozytorium przez autorów zatwierdzeń, których adresy e-mail nie pasują do wzorca.

1. Wybierz pozycję Project Ustawienia>Repositories i wybierz repozytorium, jeśli chcesz skonfigurować tylko to repozytorium.

2. Na karcie Zasady na stronie Wszystkie repozytoria lub <nazwa> repozytorium w obszarze Zasady repozytorium ustaw opcję Zatwierdź weryfikację wiadomości e-mail autora na Wł. lub Wył.

3. Jeśli włączysz zasady, określ adres lub adresy e-mail, które mają być zgodne.

   Możesz określić dokładne adresy e-mail lub użyć symboli wieloznacznych. Użyj ; jako separatora dla wielu wzorców poczty e-mail. Wzorce poczty e-mail z prefiksem ! są wykluczane. Kolejność jest ważna.

Zasady weryfikacji ścieżki pliku

Możesz ustawić zasady, które uniemożliwiają zatwierdzanie w repozytorium ze ścieżek plików pasujących do wzorca.

1. Wybierz pozycję Project Ustawienia>Repositories i wybierz repozytorium, jeśli chcesz skonfigurować tylko to repozytorium.

2. Na karcie Zasady na stronie Wszystkie repozytoria lub <nazwa> repozytorium w obszarze Zasady repozytorium ustaw opcję Walidacja ścieżki pliku na Wł. lub Wył.

3. Jeśli włączysz zasady, określ ścieżkę lub ścieżki do zablokowania.

   Można określić dokładne ścieżki i symbole wieloznaczne. Dokładne ścieżki zaczynają się od /. Można również określić wiele ścieżek przy użyciu jako ; separatora. Ścieżki poprzedzone prefiksem ! są wykluczane. Kolejność jest ważna.

Zasady wymuszania wielkości liter

W usłudze Git jest rozróżniana wielkość liter, co oznacza, że plik o nazwie Foo.txt różni się od pliku o nazwie foo.txt. Jednak Windows i macOS domyślne systemy plików bez uwzględniania wielkości liter, co oznacza, że Foo.txt i foo.txt są takie same. Ta rozbieżność może powodować problemy, jeśli ktoś w systemie bez uwzględniania wielkości liter wypycha pliki, foldery, gałęzie lub tagi, które różnią się tylko literą. Aby uzyskać więcej informacji, zobacz zgodność międzyplatformowa usługi Git.

Jeśli większość współautorów korzysta z Windows lub macOS, najlepiej włączyć zasady wymuszania przypadków. Wymuszanie wielkości liter przełącza serwer z domyślnego trybu uwzględniającego wielkość liter, w którym File.txt i file.txt są odrębne, na tryb przyjazny dla systemu Windows i macOS, w którym File.txt i file.txt są traktowane jako ten sam plik. To ustawienie wpływa na pliki, foldery, gałęzie i tagi.

To ustawienie uniemożliwia współautorom wprowadzanie różnic tylko w przypadku. To ustawienie pozwala uniknąć konfliktów poufności liter, blokując wypychanie zmiany wielkości liter w plikach, folderach, gałęziach i tagach. Aby rozwiązać ten problem, użytkownik musi ponownie napisać swoją niezauszaną historię, a następnie ponowić próbę wypchnięcia.

To ustawienie nie naprawi repozytorium, które zawiera już obiekty, które różnią się tylko wielkością liter. Najlepiej rozwiązać takie problemy przed włączeniem zasad. Zmień nazwy plików i folderów lub utwórz ponownie gałęzie i tagi , aby używać nazw niezwiązanych z konfliktami.

Przeglądarka

Aby ustawić zasady wymuszania wielkości liter:

1. Wybierz pozycję Project Ustawienia>Repositories i wybierz repozytorium, jeśli chcesz skonfigurować tylko to repozytorium.
2. Na karcie Zasady na stronie Wszystkie repozytoria lub <nazwa> repozytorium w obszarze Zasady repozytorium ustaw wymuszanie wielkości liter na Włączone lub Wyłączone.

Uwaga

Zasady wymuszania przypadków wymagają wersji TFS 2018.2 lub nowszej.

Interfejs wiersza polecenia usługi Azure DevOps

Aby skonfigurować lub zaktualizować zasady wymuszania przypadków, możesz użyć interfejsu wiersza polecenia platformy Azure az repos policy case-enforcementupdate .

Tworzenie zasad wymuszania wielkości liter

Użyj polecenia az repos case-enforcement create , aby utworzyć zasady wymuszania wielkości liter.

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

Parametry

Parametr	Opis
blocking	Blokuj, jeśli zasady nie są spełnione. Zaakceptowane wartości: false, true. Wymagane.
enabled	Włącz zasady. Zaakceptowane wartości: false, true. Wymagane.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady. Wymagane.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli nie skonfigurowano go jako domyślnego lub pobranego za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.

Przykład

Poniższy przykład implementuje wymagane zasady wymuszania przypadku w Fabrikam repozytorium. Identyfikator repozytorium można uzyskać za pomocą polecenia az repos list. W tym przykładzie użyto konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Aktualizowanie zasad wymuszania przypadków

Użyj polecenia az repos policy case-enforcement update , aby zarządzać zasadami wymuszania przypadku .

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

Parametry

Parametr	Opis
id, policy-id	Identyfikator zasad do zaktualizowania. Wymagane.
blocking	Blokuj, jeśli zasady nie są spełnione. Zaakceptowane wartości: false, true.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
enabled	Włącz zasady. Zaakceptowane wartości: false, true.
org	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady.
subscription	Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Poniższy przykład aktualizuje zasady wymuszania przypadków w Fabrikam repozytorium, aby nie było już włączone ani blokowane. W tym przykładzie użyto konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Azure DevOps polecenia interfejsu wiersza polecenia nie są obsługiwane w przypadku Azure DevOps Server lokalnie.

Zasady nazw zarezerwowanych

Nie wszystkie nazwy plików są dozwolone w trzech głównych systemach plików systemu operacyjnego: Windows, macOS i Linux. Zatwierdzenia w udostępnionym repozytorium mogą zawierać nazwy plików lub folderów, które są nieprawidłowe na co najmniej jednej platformie. Jeśli pobierane są nieprawidłowe pliki lub foldery i wyewidencjonowane na tych platformach, katalogi robocze mogą zostać uszkodzone. Aby uzyskać więcej informacji, zobacz zgodność międzyplatformowa usługi Git.

Można włączyć lub wyłączyć zasady w celu umieszczenia ograniczeń dotyczących nazw plików i folderów. Ustawienie Nazwy zarezerwowane blokuje wypychanie do repozytorium zawierającego nazwy plików lub folderów, które są nieprawidłowe na wszystkich platformach. Aby zobaczyć, jakie nazwy są nieprawidłowe, zobacz zgodność międzyplatformowa usługi Git.

Aby ustawić zasady nazw zarezerwowanych:

1. Wybierz pozycję Project Ustawienia>Repositories i wybierz repozytorium, jeśli chcesz skonfigurować tylko to repozytorium.
2. Na karcie Zasady na stronie Wszystkie repozytoria lub <nazwa> repozytorium w obszarze Zasady repozytorium ustaw nazwy zarezerwowanena Włączone lub Wyłączone.

Zasady maksymalnej długości ścieżki

Nie wszystkie długości ścieżek są dozwolone w trzech głównych systemach plików systemu operacyjnego: Windows, macOS i Linux. Zatwierdzenia w udostępnionym repozytorium mogą zawierać pliki lub katalogi o długości ścieżki, które są nieprawidłowe na co najmniej jednej platformie. Jeśli te pliki lub katalogi są pobierane i wyewidencjonowane na platformie, na której są nieprawidłowe, katalogi robocze mogą zostać uszkodzone. Aby uzyskać więcej informacji, zobacz zgodność międzyplatformowa usługi Git.

Ustawienie Maksymalna długość ścieżki blokuje wypychanie plików lub katalogów o długości ścieżki, które są nieprawidłowe na dowolnej platformie. Aby zobaczyć, jakie długości ścieżek są nieprawidłowe, zobacz zgodność międzyplatformowa usługi Git. Po włączeniu tego ustawienia domyślna wartość maksymalna to 248, ponieważ maksymalna długość wynosi 100% obsługiwana na wszystkich trzech głównych platformach.

Możesz zmodyfikować maksymalną wartość ścieżki. Jeśli na przykład masz tylko deweloperów systemu macOS lub Linux w organizacji, możesz ustawić maksymalną długość na wartość obsługiwaną na obu platformach. 1016 Możesz również ustawić niższą maksymalną wartość ścieżki, aby wymusić konwencje nazewnictwa katalogów w organizacji.

Aby ustawić zasady maksymalnej długości ścieżki:

1. Wybierz pozycję Project Ustawienia>Repositories i wybierz repozytorium, jeśli chcesz skonfigurować tylko to repozytorium.
2. Na karcie Zasady na stronie Wszystkie repozytoria lub <nazwa> repozytorium w obszarze Zasady repozytorium ustaw maksymalną długość ścieżki na Włączone lub Wyłączone.
3. Jeśli ustawienie jest włączone, wprowadź maksymalną długość ścieżki.

Zasady maksymalnego rozmiaru pliku

Duże pliki zaewidencjonowane w usłudze Git pozostają w repozytorium na czas nieokreślony, co zwiększa czas klonowania i użycie dysku. Aby uzyskać wskazówki dotyczące zarządzania dużymi plikami, zobacz Zarządzanie dużymi plikami i przechowywanie ich w usłudze Git.

Ustawienie zasad Maksymalny rozmiar pliku blokuje wprowadzanie do repozytorium plików o określonym rozmiarze. Jeśli wypychanie zawiera nowy lub zaktualizowany plik większy niż limit skonfigurowany w tym ustawieniu, wypychanie zostanie zablokowane. Aby usunąć duży plik, użytkownik musi ponownie napisać historię niezauszaną, a następnie ponowić próbę wypchnięcia.

Przeglądarka

Aby skonfigurować zasady maksymalnego rozmiaru pliku :

1. Wybierz pozycję Project Ustawienia>Repositories i wybierz repozytorium, jeśli chcesz skonfigurować tylko to repozytorium.
2. Na karcie Zasady na stronie Wszystkie repozytoria lub <nazwa> repozytorium w obszarze Zasady repozytorium ustaw maksymalny rozmiar pliku na Włączone lub Wyłączone.
3. Jeśli to ustawienie zostanie włączone, wybierz maksymalny rozmiar pliku.

Uwaga

Zasady maksymalnego rozmiaru pliku wymagają serwera TFS 2018.2 lub nowszego.

Interfejs wiersza polecenia usługi Azure DevOps

Użyj polecenia az repos policy file-size create i az repos policy file-size update , aby zarządzać maksymalnymi zasadami rozmiaru plików.

Tworzenie zasad rozmiaru pliku

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]

Parametry

Parametr	Opis
blocking	Blokuj, jeśli zasady nie są spełnione. Zaakceptowane wartości: false, true. Wymagane.
enabled	Włącz zasady. Zaakceptowane wartości: false, true. Wymagane.
maximum-git-blob-size	Maksymalny rozmiar obiektu blob usługi Git w bajtach. Aby na przykład określić limit 10 bajtów, --maximum-git-blob-size 10.wymagany.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady. Wymagane.
use-uncompressed-size	Czy używać nieskompresowanego rozmiaru. Zaakceptowane wartości: false, true. Wymagane.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.
subscription	Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s <NAME_OR_ID>.

Przykład

Poniższy przykład tworzy 1 GB blokujących zasady maksymalnego rozmiaru Fabrikam plików w repozytorium. Identyfikator repozytorium można uzyskać za pomocą polecenia az repos list. W tym przykładzie użyto konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Aktualizowanie zasad rozmiaru pliku

Użyj polecenia az repos policy file-size update , aby zarządzać zasadami maksymalnego rozmiaru plików.

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}]

Parametry

Parametr	Opis
id, policy-id	Identyfikator zasad do zaktualizowania. Wymagane.
blocking	Blokuj, jeśli zasady nie są spełnione. Zaakceptowane wartości: false, true.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
enabled	Włącz zasady. Zaakceptowane wartości: false, true.
maximum-git-blob-size	Maksymalny rozmiar obiektu blob usługi Git w bajtach.
org	Azure DevOps adres URL organizacji. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
project, p	Nazwa lub identyfikator projektu. Domyślny projekt można skonfigurować przy użyciu polecenia az devops configure -d project=<NAME_OR_ID>. Wymagana , jeśli nie została skonfigurowana jako domyślna lub odebrana za pośrednictwem konfiguracji usługi Git.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady.
subscription	Nazwa lub identyfikator subskrypcji. Możesz skonfigurować domyślną subskrypcję przy użyciu polecenia az account set -s <NAME_OR_ID>.
use-uncompressed-size	Czy używać nieskompresowanego rozmiaru. Zaakceptowane wartości: false, true.

Przykład

Poniższy przykład aktualizuje maksymalny rozmiar pliku w Fabrikam repozytorium. W przykładzie użyto konfiguracji az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"domyślnej .

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

Azure DevOps polecenia interfejsu wiersza polecenia nie są obsługiwane w przypadku Azure DevOps Server lokalnie.

Następne kroki

Ulepszanie jakości kodu za pomocą zasad gałęzi

Pokrewne artykuły:

• Konfigurowanie zasad repozytorium Git przy użyciu pliku konfiguracji
• Domyślne uprawnienia usługi Git (zabezpieczenia)
• Ustawianie uprawnień (zabezpieczenia)
• Omówienie integracji między usługami