Określanie ustawień i zasad repozytorium Git

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

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 albo 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 żądanie ściągnięcia, pomyślna kompilacja lub przegląd kodu przed scaleniem zmian 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.

Podsumowanie wszystkich ustawień i zasad 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ą repozytoriów ustawień>projektu.

Uwaga

Za pomocą interfejsu wiersza polecenia platformy Azure można ustawić kilka ustawień gałęzi i zasad przy użyciu 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

Wartość domyślna

Opis

---

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

Wyłączona

Zainicjuj nowe repozytoria przy użyciu określonej 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

Wartość domyślna

Opis

---

Rozwidlenia

Włączone

Zezwalaj użytkownikom na tworzenie rozwidlenia z repozytorium.

Zatwierdzanie linku wzmianki

Włączone

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

Zatwierdzanie rozpoznawania elementu roboczego wzmianki

Włączone

Zezwalaj na wzmianki w komentarzach zatwierdzeń w celu zamknięcia elementów roboczych. Wymaga aktualizacji programu 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

Zezwalanie 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, który wymaga uprawnienia Współtworzenie do głosowania nad żądaniami ś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

Wartość domyślna

Opis

---

Zatwierdzanie weryfikacji wiadomości e-mail autora

Wyłączona

Blokuj wypychanie za pomocą wiadomości e-mail autora zatwierdzeń, 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łączona

Blokuj wypychanie z wprowadzenia ścieżek plików, które są zgodne z określonymi wzorcami. To ustawienie wymaga programu Azure DevOps Server 2020.1 lub nowszej wersji.

Wymuszanie sprawy

Wyłączona

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

Nazwy zarezerwowane

Wyłączona

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łączona

Blokuj wypychania, które powodują wprowadzenie ścieżek przekraczających określoną długość.

Maksymalny rozmiar pliku

Wyłączona

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.

Uwaga

Zasady gałęzi są stosowane do żądań ściągnięcia na podstawie gałęzi docelowej żądania ściągnięcia. Zasady gałęzi nie powinny być ustawiane w gałęziach tymczasowych, które zostaną usunięte po żądaniu ściągnięcia. Dodanie zasad gałęzi do gałęzi tymczasowych spowoduje niepowodzenie automatycznego usuwania gałęzi.

Zasady

Wartość domyślna

Opis

---

Wymaganie minimalnej liczby recenzentów

Wyłączona

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

Sprawdzanie połączonych elementów roboczych

Wyłączona

Zachęcaj do śledzenia, sprawdzając połączone elementy robocze w żądaniach ściągnięcia.

Sprawdzanie rozwiązywania komentarzy

Wyłączona

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

Ograniczanie typów scalania lub wymuszanie strategii scalania

Wyłączona

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

Weryfikacja kompilacji

Wyłączona

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

Sprawdzanie stanu lub
Wymaganie zatwierdzenia z dodatkowych lub zewnętrznych usług

Wyłączona

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łączona

Dodaj, włącz lub wyłącz co najmniej jedną zasady, aby wyznaczyć recenzentów kodu do automatycznego uwzględnienia podczas żądań ściągnięcia zmiany niektórych obszarów kodu.

Wymagania wstępne

• Aby skonfigurować zasady, musisz być członkiem grupy zabezpieczeń Administratorzy projektu lub mieć uprawnienia do edycji zasad na poziomie repozytorium. Aby uzyskać więcej informacji, zobacz Ustawianie uprawnień repozytorium Git.

• Jeśli chcesz użyć poleceń az repos , wykonaj kroki opisane w temacie Rozpoczynanie pracy z interfejsem wiersza polecenia usługi Azure DevOps.

Wyświetlanie i edytowanie ustawień i zasad

Możesz 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 w repozytoriach. Aby uzyskać informacje o ustawianiu zasad gałęzi, zobacz Zasady gałęzi.

Uwaga

Najlepszym rozwiązaniem jest skonfigurowanie ustawień 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 nieporozumienie i problemy z wydajnością usługi Git.

Przeglądarka

Aby skonfigurować ustawienia i zasady repozytorium za pośrednictwem portalu internetowego, otwórz repozytoria ustawień>projektu 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 . Te ustawienia można zdefiniować 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.

   

Interfejs wiersza polecenia usługi Azure DevOps

Interfejs wiersza polecenia usługi Azure DevOps umożliwia wyświetlenie listy repozytoriów lub wyświetlenie lub zaktualizowanie repozytorium. Ponadto można wyświetlić, wyświetlić lub zaktualizować szczegóły zasad dla gałęzi lub repozytorium.

Wyświetlanie listy repozytoriów | szczegóły | repozytorium Lista aktualizacji lub zmiana nazwy repozytorium
Lista zasad | repozytorium Szczegóły | zasad listy Zasady aktualizacji repozytorium

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	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 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ć listę informacji 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	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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ższe 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 gałąź domyślną, która ma zostać ustawiona dla repozytorium. Przykład: "refs/heads/live" lub "live".
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
name	Nowa nazwa repozytorium.
org, organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 jako 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 ibranch, 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	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 do filtrowania wyników 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. Wymagany.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org, organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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

Aktualizowanie zasad

Aby zaktualizować zasady, możesz użyć polecenia 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 Configurations - Create (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. Wymagany.
id, policy-id	Identyfikator zasad do zaktualizowania. Wymagany.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org, organization	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 na plik 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

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 dowolną nazwę ustawioną na poziomie organizacji.

Masz następujące możliwości:

• 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 określonego repozytorium w dowolnym momencie.

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

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

1. Na stronie organizacji usługi Azure DevOps 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 usługi Azure DevOps wybierz pozycję Ustawienia projektu 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.

Zarządzanie uprawnieniami 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 są skonfigurowane tak, aby umożliwić użytkownikom zarządzanie uprawnieniami dla utworzonych gałęzi.

Aby zarządzać tym ustawieniem:

1. Na stronie projektu usługi Azure DevOps wybierz pozycję Ustawienia projektu 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ę Repozytoria ustawień>projektu, a następnie wybierz repozytorium.
2. Na karcie Ustawienia na stronie <Nazwa> repozytorium ustaw pozycję Zarządzanie uprawnieniami na Wartość Włączone lub Wyłączone.

Obrazy Gravatar

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

Gravatar images to ustawienie na poziomie organizacji.

1. Na stronie organizacji usługi Azure DevOps 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 Wartość Włączone lub Wyłączone.

Włącz 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 obszarze Ustawienia projektu 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 wartość Rozwidlenia na Wł. lub Wyłączone.

Ustawienia łączenia elementów roboczych

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

1. Wybierz pozycję Repozytoria ustawień>projektu, a następnie wybierz repozytorium.
2. Na karcie <Ustawienia strony Nazwa> repozytorium włącz lub wyłącz ustawienia.

Zatwierdzanie linku wzmianki

Po włączeniu zatwierdzenia komunikaty zawierające # prawidłowy identyfikator elementu roboczego automatycznie łączą 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 są zgodne z # identyfikatorami elementów roboczych na bieżącym koncie.

Zatwierdzanie rozpoznawania elementu roboczego wzmianki

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.

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. Zespoły, które chcą zniechęcić użytkowników do kończenia elementów roboczych przy użyciu żądań ściągnięcia, mogą wyłączyć to ustawienie. Użytkownicy muszą następnie wyrazić zgodę na ukończenie elementów roboczych przy każdym zakończeniu żądania ściągnięcia.

Ustawienie Tryb głosowania ścisłego

W niektórych sytuacjach użytkownicy, którzy nie są współautorami w repozytorium, mogą przesłać żądanie ściągnięcia i spowodować scalenie go w zależności od zasad. Aby zapobiec takiej możliwości, włącz tryb ścisłego głosowania, aby zmienić wymagane uprawnienie do głosowania nad żądaniami ściągnięcia repozytorium na współtworzenie. Włączenie tego ustawienia jest zalecane, jeśli korzystasz z rozwidlenia użytkowników w usłudze Azure Repos.

1. Wybierz pozycję Repozytoria ustawień>projektu, a następnie wybierz repozytorium.
2. Na karcie< Ustawienia strony Nazwa> repozytorium ustaw opcję Tryb głosowania ścisłego na Wartość Włączone lub Wyłączone.

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ę Repozytoria ustawień>projektu, a następnie wybierz repozytorium.
2. Na karcie <Ustawienia strony Nazwa> repozytorium w obszarze Wyłącz repozytorium ustaw opcję Wyłącz repozytorium na Wartość Włączone lub Wyłączone.

Zasady gałęzi między repozytoriami

Zasady można ustawić 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 obszarze Ustawienia projektu wybierz pozycję Repozytoria w obszarze nawigacji po lewej stronie.

2. Na stronie Wszystkie repozytoria wybierz kartę Zasady.

3. Wybierz pozycję plus sign + in Branch Policies (Zasady gałęzi plus) 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, która ma być chroniona. Komunikat informacyjny informuje o tylu bieżących gałęziach, których dotyczy problem. Pamiętaj, że w nazwie gałęzi (lub wprowadzonym wzorcu) jest uwzględniana wielkość liter. Gałąź nie musi jeszcze istnieć, aby chronić nazwę gałęzi.

5. Wybierz pozycję Utwórz.

   

6. Na stronie Zasady między repozytoriami dla <nazwy> gałęzi ustaw żądane 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 są zgodne ze wzorcem.

1. Wybierz pozycję Repozytoria ustawień>projektu 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 Wartość Włączone lub Wyłączone.

3. Jeśli włączysz zasady, określ adresy 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 sprawdzania poprawności ścieżki pliku

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

1. Wybierz pozycję Repozytoria ustawień>projektu 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ą wykluczone. 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 system Windows i macOS są domyślne dla systemów plików bez uwzględniania wielkości liter, co oznacza, że Foo.txt i foo.txt mają taką samą nazwę. 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 systemu Windows lub macOS, najlepiej włączyć zasady wymuszania przypadków. Wymuszanie przypadku przełącza serwer z domyślnego trybu uwzględniającego wielkość liter, w którym File.txt i file.txt są odrębne, do trybu przyjaznego 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, które zmienia wielkość 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 spowoduje naprawienia 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ę Repozytoria ustawień>projektu 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.

Interfejs wiersza polecenia usługi Azure DevOps

Możesz użyć polecenia interfejsu wiersza polecenia platformy Azure az repos policy case-enforcement create i az repos policy case-enforcement update , aby skonfigurować lub zaktualizować zasady wymuszania przypadków.

Tworzenie zasad wymuszania wielkości liter

Użyj polecenia az repos case-enforcement create , aby utworzyć zasady wymuszania przypadków.

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. Wymagany.
enabled	Włącz zasady. Zaakceptowane wartości: false, true. Wymagany.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady. Wymagany.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git.

Przykład

W poniższym przykładzie zaimplementowane są wymagane zasady wymuszania wielkości liter w Fabrikam repozytorium. Identyfikator repozytorium można uzyskać przy użyciu 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 wielkości liter

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

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. Wymagany.
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	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady.
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 zasady wymuszania wielkości liter w Fabrikam repozytorium nie są 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

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ą ulec uszkodzeniu. Aby uzyskać więcej informacji, zobacz Zgodność międzyplatformowa usługi Git.

Możesz 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ę Repozytoria ustawień>projektu 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 wartość Nazwy zarezerwowane na 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żek, 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ą stać się 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ę Repozytoria ustawień>projektu 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 Wartość 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 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. Użytkownik musi ponownie zapisać swoją niezauszaną historię, aby usunąć duży plik i ponowić próbę wypchnięcia.

Przeglądarka

Aby skonfigurować zasady maksymalnego rozmiaru pliku:

1. Wybierz pozycję Repozytoria ustawień>projektu 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 wartość Maksymalny rozmiar pliku na Wartość Włączone lub Wyłączone.
3. W przypadku włączenia ustawienia wybierz maksymalny rozmiar pliku.

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ć zasadami maksymalnego rozmiaru pliku.

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. Wymagany.
enabled	Włącz zasady. Zaakceptowane wartości: false, true. Wymagany.
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. Wymagany.
use-uncompressed-size	Czy używać nieskompresowanego rozmiaru. Zaakceptowane wartości: false, true. Wymagany.
detect	Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true.
org	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 przykład tworzy 1 GB blokujące zasady maksymalnego rozmiaru Fabrikam plików w repozytorium. Identyfikator repozytorium można uzyskać przy użyciu 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 pliku.

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. Wymagany.
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	Adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=<ORG_URL>. Wymagane , jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane 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 ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git.
repository-id	Identyfikator repozytorium, w którym mają być stosowane zasady.
subscription	Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować 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

Następne kroki

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

Powiązane 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