Git-Repositoryeinstellungen und -richtlinien


Aus

Wenn diese Option aktiviert ist, werden neue Repositorys mit dem Namen des von Ihnen angegebenen Branch initialisiert. Sie können den Standardverzweigung für ein bestimmtes Repository jederzeit ändern. Der Standardname des Branchs ist main .

Benutzern das Verwalten von Berechtigungen für ihre erstellten Branches erlauben

Ein

Neue Repositorys werden so konfiguriert, dass Benutzer Berechtigungen für ihre erstellten Branches verwalten können.

Einstellungen für einzelne Repositorys

In der folgenden Tabelle sind die Einstellungen zusammengefasst, die Sie aktivieren und konfigurieren können, um sie für jedes Git-Repository anzupassen.

Einstellung

Standard

Beschreibung


Ein

Benutzern das Erstellen von Forks aus dem Repository erlauben.

Ein

Automatisches Erstellen von Links für Arbeitselemente, die in einem Commitkommentar erwähnt werden.

Ein

Lassen Sie Erwähnungen in Commitkommentaren zu, um Arbeitselemente zu schließen.

Ein

Merken Sie sich die Benutzereinstellungen zum Abschließen von Arbeitselementen mit Pull Requests.

Berechtigungsverwaltung

Ein

Benutzern das Verwalten von Berechtigungen für die von ihnen erstellten Branches erlauben

Strict Vote-Modus

Ein

Aktivieren Sie den Strict Vote-Modus für das Repository, für das die Berechtigung "Beitragen" erforderlich ist, um in Pull Requests abstimmen zu können.

Deaktivieren des Repositorys

Ein

Deaktivieren Sie den Zugriff auf das Repository (einschließlich Builds, Pull Requests usw.), aber lassen Sie das Repository mit einer Warnung erkennbar.

Durchsuchbare Branches

Ein

Geben Sie bis zu fünf zusätzliche Verzweigungen für die Codesuche an, die standardmäßig nur für die Standardverzweigung gilt.

Repositoryrichtlinien

In der folgenden Tabelle sind die Richtlinien zusammengefasst, die Sie definieren können, um ein Repository anzupassen oder zu definieren, um alle neuen Repositorys mit diesen Einstellungen zu initialisieren.

Richtlinie

Standard

Beschreibung


Aus

Blockieren Sie Pushbenachrichtigungen mit einer Commitautor-E-Mail, die nicht mit den angegebenen Mustern übereinstimmen.

Aus

Blockieren Sie die Einführung von Dateipfaden, die mit den angegebenen Mustern übereinstimmen.

Aus

Vermeiden Sie Konflikte bei der Sensitivität der Klein-/Kleinigkeit, indem Sie Pushbenachrichtigungen blockieren, die die Namens-Casing für Dateien, Ordner, Verzweigungen und Tags ändern.

Aus

Blockieren Sie Pushbenachrichtigungen, die Dateien, Ordner oder Branchnamen einführen, die reservierte Plattformnamen oder inkompatible Zeichen enthalten.

Aus

Blockieren Sie Pushbenachrichtigungen, die Pfade einführen, die die angegebene Länge überschreiten.

Aus

Blockiert Pushbenachrichtigungen, die neue oder aktualisierte Dateien enthalten, die diesen Grenzwert überschreiten.

Branchrichtlinien

In der folgenden Tabelle sind die Richtlinien zusammengefasst, die Sie definieren können, um einen Branch anzupassen. Weitere Informationen zum Konfigurieren dieser Einstellungen finden Sie unter Verbessern der Codequalität mit Branchrichtlinien.

Richtlinie

Standard

Beschreibung


Aus

Genehmigung durch eine angegebene Anzahl von Prüfern bei Pull Requests erforderlich.

Aus

Fördern der Nachverfolgbarkeit durch Überprüfen auf verknüpfte Arbeitselemente bei Pull Requests

Aus

Überprüfen Sie, ob alle Kommentare für Pull Requests aufgelöst wurden.

Aus

Steuern Sie den Branchverlauf, indem Sie die verfügbaren Mergetypen einschränken, wenn Pull Requests abgeschlossen sind.

Aus

Fügen Sie eine oder mehrere Richtlinien hinzu, um Code durch Vorab zusammenführen und Pull Request-Änderungen zu erstellen. Kann auch Richtlinien aktivieren oder deaktivieren.

Aus

Fügen Sie eine oder mehrere Richtlinien hinzu, damit andere Dienste den Status "Erfolgreich" veröffentlichen müssen, um Pull Requests abschließen zu können. Kann auch Richtlinien aktivieren oder deaktivieren.

Aus

Fügen Sie eine oder mehrere Richtlinien hinzu, um Codere reviewer so zu bestimmen, dass sie automatisch enthalten, wenn Pull Requests bestimmte Codebereiche ändern. Kann auch Richtlinien aktivieren oder deaktivieren.

Voraussetzungen

  • Um Branchrichtlinien festlegen zu können, müssen Sie Mitglied der Sicherheitsgruppe Project-Administratoren sein oder die Berechtigungen auf Repositoryebene festgelegt haben: Richtlinien bearbeiten. Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen.
  • Wenn Sie zum ersten Mal Befehle az repos verwenden, finden Sie weitere Informationen unter az repos
  • Um Branchrichtlinien festlegen zu können, müssen Sie Mitglied der Sicherheitsgruppe Project-Administratoren sein oder die Berechtigungen auf Repositoryebene festgelegt haben: Richtlinien bearbeiten. Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen.

Anzeigen und Bearbeiten von Repositoryeinstellungen

  1. Öffnen Sie in Ihrem Webbrowser das Projekt für Ihre Organisation in Azure DevOps wählen Sie Project Einstellungen, Repositorysund Ihr Repository aus.

    Screenshot: Auswählen von

  2. Wählen Einstellungen aus, um Ihre Repositoryeinstellungen anzeigen und konfigurieren zu können.

    Screenshot, der das ausgewählte Repositoryprojekt

  3. Wählen Sie Richtlinien aus, um Richtlinien auf Projektebene und repositoryübergreifende Richtlinien anzeigen und konfigurieren zu können.

    Screenshot, der die ausgewählte Registerkarte

  1. Öffnen Sie in Ihrem Webbrowser das Projekt, wählen Sie Project ,Repositorysund Ihr Repository aus.

    Screenshot:

  2. Wählen Sie Optionen und Richtlinien aus, um Ihre Repositoryeinstellungen anzeigen und konfigurieren zu können.

    Unter Optionen für FabrikamFiber werden die Registerkarten Optionen und Richtlinien hervorgehoben und Optionen ausgewählt.

  1. Öffnen Sie in Ihrem Webbrowser das Projekt, wählen Sie das Zahnradsymbol Versionskontrolleaus, und wählen Sie Ihr Repository aus.

    Screenshot, der die Optionen für die Versionskontrolle für Ihr Repository zeigt.

  2. Wählen Sie Optionen zum Anzeigen und Konfigurieren Ihrer Repositoryeinstellungen aus.

    Die Optionsbenutzeroberfläche

  1. Öffnen Sie in Ihrem Webbrowser das Projekt, wählen Sie das Zahnradsymbol Versionskontrolleaus, und wählen Sie Ihr Repository aus.

    Screenshot, der die Optionen für die Versionskontrolle für Ihr Repository zeigt.

  2. Wählen Sie Optionen aus, um Ihre Repositoryeinstellungen anzeigen und konfigurieren zu können.

    Screenshot: Benutzeroberfläche für Optionen

Standardeinstellung für Branchnamen

Sie können einen beliebigen Legal Branch-Namen auswählen, der beim Initialisieren eines Repositorys verwendet werden soll, oder ihn bei Bedarf später ändern. Sie können auf zwei Arten auf die Einstellung zugreifen:

  • Organisationseinstellungen: Wählen Sie auf DevOps Seite Organisationseinstellungen Repositorys Ihr Projekt aus, aktivieren Sie den Standardverzweigungsnamen für neue Repositorys, und geben Sie ihren Standardbranchennamen ein.

    Screenshot:

  • Project: Wählen Sie auf der Projektseite die Option Project-Einstellungen RepositorysEinstellungen aus, aktivieren Sie standardbasierten Branchnamen für neue Repositorys,und geben Sie ihren Standard-Branchnamen ein.

    Screenshot:

Wenn Sie dieses Feature nicht aktivieren, werden Ihre Repositorys mit dem Azure Repos Standardnamen ( main) initialisiert.

Repositoryübergreifende Verwaltung von Branchrichtlinien

Sie können Richtlinien für einen bestimmten Branch oder standard branch für alle Repositorys in ihrem Projekt festlegen. Beispielsweise kann ein Administrator zwei Minimale Reviewer für alle Pull Requests anfordern, die in jedem Hauptzweig in jedem Repository in ihrem Projekt vorgenommen werden. Sie finden das Feature Branchschutz hinzufügen im Repos Project Einstellungen.

Screenshot:

Radgabeln

Steuert, ob Benutzer neue serverseitige Forks erstellen können. Wenn Sie diese Einstellung deaktivieren, werden vorhandene Forks nicht geändert.

Über Project Einstellungen Repository > Einstellungenkönnen Sie Forks aktivieren >

Repository, Einstellungen, Forks.

Verknüpfen von Arbeitselement

Über Project Einstellungen Repository > Einstellungenkönnen Sie Einstellungen konfigurieren, die die Verknüpfung von Arbeitselement verwalten.

Repository, Einstellungen, Arbeitselementkonfiguration.

Einstellung

Beschreibung


Verknüpfen von Commit-Erwähnungen

Wenn diese Option aktiviert ist, verknüpfen Commitnachrichten mit "#" gefolgt von einer gültigen Arbeitselement-ID den Commit automatisch mit dem angegebenen Arbeitselement. Deaktivieren Sie diese Einstellung beim Pushen eines Repositorys, das zuvor in einem anderen Konto oder Dienst enthalten war. Diese Repositorys verfügen möglicherweise #mentions über , die nicht mit den Arbeitselement-IDs im aktuellen Konto übereinstimmen.

Commit für die Auflösung von Arbeitselement erwähnt

Aktivieren Sie diese Einstellung, um diese Arbeitselemente automatisch zu vervollständigen, wenn Sie den PR erfolgreich abgeschlossen haben. Sie können auch den Workflowstatus angeben, in den das Arbeitselement beim Zusammenführen des PR übergehen soll. Weitere Informationen finden Sie unter Automatisches Abschließen von Arbeitselementen mit Pull Requests.

Commit für die Auflösung von Arbeitselement erwähnt

Aktivieren Sie diese Einstellung, um diese Arbeitselemente automatisch zu vervollständigen, wenn Sie den PR erfolgreich abgeschlossen haben. Weitere Informationen finden Sie unter Automatisches Abschließen von Arbeitselementen mit Pull Requests.

Einstellungen für den Übergang von Arbeitselement

Standardmäßig wird bei der Option zum Abschließen verknüpfter Arbeitselemente während des Abschlusses des Pull Requests die letzte Auswahl jedes Benutzers merken. Einige Teams verfügen möglicherweise über unterschiedliche Ansätze zum Schließen von Arbeitselementen, z. B. bei einer Standup-Besprechung, und möchten Benutzer möglicherweise davon abraten, Arbeitselemente mit ihren Pull Requests zu schließen. Durch Deaktivieren dieser Einstellung müssen Benutzer die Arbeitsaufgaben für jeden Pull Request abschließen.

Bestätigen der E-Mail-Überprüfung des Autors

Sie können eine Pushrichtlinie festlegen, um zu verhindern, dass Commits per Push an ein Repository gesendet werden, für das die Commitautor-E-Mail nicht dem bereitgestellten Muster entspricht.

Screenshot, der die ausgewählte Registerkarte

Über Project Einstellungen > Repositoryrichtlinienkönnen Sie commit author email validation aktivieren >

Repository, Richtlinien, E-Mail-Überprüfung des Autors commiten.

Sie können genaue E-Mails angeben oder Platzhalter verwenden. Mehrere E-Mail-Muster sollten ";" als Trennzeichen verwenden. E-Mail-Muster mit dem Präfix "!" werden ausgeschlossen. Die Reihenfolge ist wichtig.

Dateipfadüberprüfung

Sie können eine Richtlinie festlegen, um zu verhindern, dass Commits basierend auf Dateipfaden in ein Repository gepusht werden. Die Dateipfadüberprüfungsrichtlinie blockiert Pushs, die dem bereitgestellten Muster entsprechen.

Screenshot, der die ausgewählte Registerkarte

Erzwingung von Fällen

Bei Git wird die Groß-/Kleinschreibung beachtet, was bedeutet, dass sich eine Datei namens "Foo.txt" von einer Datei namens "foo.txt" unterscheidet. Windows und macOS verwenden standardmäßig Dateisysteme, bei denen die Groß-/Kleinschreibung nicht beachtet wird, was bedeutet, dass "Foo.txt" und "foo.txt" denselben Namen haben. Dies kann zu Problemen für Benutzer führen, wenn ein Benutzer in einem System, bei dem die Groß-/Kleinschreibung nicht beachtet wird, Dateien, Ordner, Branches oder Tags pusht, die sich nur nach Groß-/Kleinschreibung unterscheiden.

Wenn die meisten Benutzer Windows oder macOS verwenden, wird empfohlen, die Einstellung Für die Erzwingung von Fällen zu aktivieren. Bei der Groß-/Kleinschreibungserzwingung wechselt der Server vom Standardmodus für die Groß-/Kleinschreibung, bei dem sich "File.txt" und "file.txt" unterscheiden, zu einem Windows- und macOS-freundlichen Modus, in dem "File.txt" und "file.txt" dieselbe Datei sind. Diese Einstellung gilt für Dateien, Ordner, Branches und Tags. Außerdem wird dadurch verhindert, dass Mitwirkende versehentlich Unterschiede einführen, die nur auf die Groß- und Kleinschreibung bezogen sind. Es wird empfohlen, das Erzwingen der Groß- und Kleinschreibung zu aktivieren, wenn ein Großteil Ihrer Mitwirkenden mit Windows oder macOS arbeiten.

Dadurch wird die Einführung neuer Dateien, Ordner, Branches oder Tags blockiert, die einen solchen Konflikt verursachen würden. Der Benutzer muss den nicht gepushten Verlauf umschreiben, um das Problem zu beheben, und dann den Push erneut versuchen.

Durch diese Einstellung wird ein Repository, das bereits Objekte enthält, die sich nur nach Fall unterscheiden, nicht behoben. Es wird empfohlen, solche Probleme zu beheben, bevor Sie die Richtlinie aktivieren. Sie können Dateien und Ordner umbenennen oder Branches und Tags mithilfe neuer, nicht in Konflikt kommender Namen neu erstellen.

Über Project Einstellungen > Repositoryrichtlinienkönnen Sie die >von Fällen aktivieren oder deaktivieren.

Repository, Richtlinien, Erzwingungseinstellung für Die Anfrage.

Hinweis

Für die Erzwingungsrichtlinie für Fälle ist TFS 2018.2 oder höher erforderlich.

Reservierte Namen und maximale Pfadlänge

Nicht alle Dateinamen sind auf den drei wichtigsten Betriebssystemdateisystemen (Windows, macOS und Linux) zulässig. Entwickler können Commits per Push an ein freigegebenes Repository übertragen, das Dateien oder Ordner mit Namen enthalten kann, die auf einer oder mehreren Plattformen ungültig sind. Das Arbeitsverzeichnis kann beschädigt werden, wenn ungültige Dateien oder Ordner abgerufen und auf einer Plattform ausgecheckt werden.

In Project Einstellungen > Repositoryrichtlinienkönnen Sie zwei Richtlinien aktivieren oder deaktivieren, um Einschränkungen für Dateinamen und Dateipfade zu setzen: > und Maximale Pfadlänge.

Repository, Richtlinien, Reservierte Namen und Einstellungen für maximale Pfadlänge.

Die Einstellung Reservierte Namen blockiert Pushes an Ihr Repository, die Dateien oder Ordnernamen enthalten, die auf jeder Plattformungültig sind. Sehen Sie sich an, welche Namen ungültig sind.

Außerdem sind nicht alle Pfadlängen auf den drei wichtigen Betriebssystemdateisystemen (Windows, macOS und Linux) zulässig. Entwickler können Commits per Push an ein freigegebenes Repository übertragen, das Dateien oder Verzeichnisse mit Pfadlängen enthalten kann, die auf einer oder mehreren Plattformen ungültig sind. Wenn diese Dateien oder Verzeichnisse auf einer Plattform abgerufen und ausgecheckt werden, auf der sie ungültig sind, kann das Arbeitsverzeichnis beschädigt werden.

Die Einstellung Maximale Pfadlänge blockiert Pushes an Ihr Repository, die Dateien oder Verzeichnisse mit Pfadnamen enthalten, die auf jeder Plattformungültig sind. Sehen Sie sich an, welche Pfadlängen ungültig sind. Wenn diese Option aktiviert ist, wird der Standardwert 248 ausgewählt, da dies die höchste maximale Länge ist, die zu 100 % auf allen drei Hauptplattformen unterstützt wird.

Der maximale Pfadwert kann geändert werden. Wenn Sie beispielsweise nur macOS- oder Linux-Entwickler in Ihrer Organisation haben, können Sie optional den höchsten Wert festlegen, der auf beiden Plattformen () zu 100 % unterstützt 1016 wird. Optional können Sie auch einen niedrigeren maximalen Pfadwert festlegen, wenn Sie bestimmte & Verzeichnisnamenskonventionen für Ihre Organisation erzwingen möchten.

Maximale Dateigröße

Große Dateien, die in Git eingecheckt werden, verbleiben dauerhaft im Repository, ziehen Klonzeiten herunter und erhöhen die Datenträgernutzung. Wir haben Vorschläge, wie Sie große Dateien verwalten können.

Die Richtlinieneinstellung Maximale Dateigröße bietet Administratoren die Möglichkeit, Dateien über eine bestimmte Größe an der Eingabe des Repositorys zu hindern. Wenn ein Push eine neue oder aktualisierte Datei enthält, die den in dieser Einstellung konfigurierten Grenzwert überschreitet, wird dieser Push blockiert. Der Benutzer muss den nichtpushierten Verlauf umschreiben, um die große Datei zu entfernen und den Push erneut zu versuchen.

In Project Einstellungen > Repositoryrichtlinienkönnen Sie die > aktivieren oder deaktivieren und die maximale Größe festlegen.

Repository, Richtlinien, Einstellung maximale Dateigröße.

Hinweis

Die Richtlinie Maximale Dateigröße erfordert TFS 2018.2 oder höher.

Nächste Schritte

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

Sie können Ihre Azure DevOps Git-Repositorys mithilfe von Repository- und Richtlinieneinstellungen anpassen. Globale Optionen für ganze Repositorys werden durch Repositoryeinstellungen konfiguriert. Es gibt auch benutzerspezifische und branchspezifische Steuerelemente, die durch Berechtigungen bzw. Branchrichtlinien abgedeckt werden.

In diesem Artikel werden serverseitige Repositoryeinstellungen behandelt. Möglicherweise möchten Sie auch mehr über clientseitige Git-Einstellungenerfahren.

Hinweis

Für das in diesem Artikel dokumentierte Feature ist TFS 2018 Update 2 oder höher erforderlich.

Informationen zu branchspezifischen Einstellungen können Sie unter Branchrichtlinien lesen. Dazu gehören Optionen wie das Anfordern eines Pull Requests, eines erfolgreichen Builds oder einer Codeüberprüfung. Informationen zu benutzerspezifischen Einstellungen erhalten Sie unter Berechtigungen. Mit Berechtigungen können Sie steuern, wer Pull Requests und andere spezifische Aktionen lesen, schreiben, mitwirken kann.

Zusammenfassung aller Repository- und Brancheinstellungen

Sie können verschiedene Einstellungen und Richtlinien für alle Repositorys, für einzelne Repositorys und für einzelne Branches eines Repositorys konfigurieren. Diese werden alle über Project Einstellungenfestgelegt.

Hinweis

Es wird empfohlen, Repositoryeinstellungen entweder auf Projektebene oder für jedes einzelne Repository zu konfigurieren, aber nicht für beides. Wenn diese Einstellung auf beiden Ebenen festgelegt ist, berücksichtigt das System die restriktivste Einstellung. Wenn Sie diese Einstellungen nur auf einer Ebene konfigurieren, wird diese Komplexität beseitigt und eine Verringerung der Git-Leistung verhindert.

Alle Repositoryeinstellungen

In der folgenden Tabelle sind die Einstellungen zusammengefasst, die Sie für alle Git-Repositorys aktivieren und konfigurieren können, die für ein Projekt erstellt werden.

Einstellung

Standard

Beschreibung