Festlegen von Git-Repositoryeinstellungen und -Richtlinien

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

Es gibt verschiedene Möglichkeiten, ihre Azure Repos Git-Repositorys mithilfe von Verzweigungs- und Repositoryeinstellungen und -richtlinien anzupassen. In diesem Artikel werden Einstellungen und Richtlinien auf Repositoryebene erläutert.

  • Repositoryeinstellungen und Richtlinien konfigurieren globale Optionen für alle Git-Repositorys für ein Projekt oder eine Organisation oder für einzelne Repositorys.

    In diesem Artikel werden serverseitige Repositoryeinstellungen und -richtlinien erläutert. Informationen zu clientseitigen Git-Einstellungen finden Sie unter Git-Einstellungen und -Einstellungen in Visual Studio.

  • Verzweigungsrichtlinien decken verzweigte Steuerelemente ab.

    Verzweigungsrichtlinien umfassen Optionen wie das Anfordern einer Pullanforderung, einen erfolgreichen Build oder eine Codeüberprüfung, bevor Änderungen in eine Verzweigung zusammengeführt werden können. Weitere Informationen finden Sie unter Branch-Richtlinien und -Einstellungen.

  • Repository- und Verzweigungsberechtigungen steuern Benutzerzuweisungen.

    Diese Berechtigungen steuern, wer Lese-, Schreib-, Mitwirkende zu Pullanforderungen und andere spezifische Aktionen ausführen kann. Weitere Informationen finden Sie unter Festlegen von Berechtigungen für ein Repository.

Hinweis

Das in diesem Artikel dokumentierte Feature erfordert TFS 2018 Update 2 oder höher.

Zusammenfassung aller Repository- und Verzweigungseinstellungen und -richtlinien

Sie können Einstellungen und Richtlinien für alle Repositorys in einem Projekt, für einzelne Repositorys und für Verzweigungen von Repositorys konfigurieren. Im Browser konfigurieren Sie alle diese Einstellungen und Richtlinien über ProjectsettingsRepositories>.

Hinweis

Sie können mehrere Verzweigungseinstellungen und Richtlinien mit der Azure CLI mithilfe der Az-Repos-Richtlinie festlegen.

In den folgenden Tabellen sind die Einstellungen und Richtlinien zusammengefasst, die Sie für Git-Repositorys und -Verzweigungen aktivieren und konfigurieren können.

Alle Repositorys Einstellungen

In der folgenden Tabelle werden die Einstellungen zusammengefasst, die Sie für alle neuen Git-Repositorys in einem Projekt oder in einer Organisation aktivieren und konfigurieren können.

Einstellung

Standard

Beschreibung


Aus

Initialisieren Sie neue Repositorys mit dem von Ihnen angegebenen Standardverzweigungsnamen. Sie können den Standardzweig für ein bestimmtes Repository jederzeit ändern. Wenn Sie dieses Feature nicht aktivieren, initialisieren Repositorys mit einem standardverzweigten Namen main.

Ein

Ermöglichen Sie Benutzern das Verwalten von Berechtigungen für ihre erstellten Zweigstellen in allen neuen Repositorys.

Repositoryeinstellungen

In der folgenden Tabelle werden die Einstellungen zusammengefasst, die Sie für jedes einzelne Git-Repository aktivieren oder konfigurieren können.

Einstellung

Standard

Beschreibung


Ein

Aktiviert oder deaktiviert die Verwendung von Gravatar-Bildern für Benutzer außerhalb Ihres Unternehmens. Diese Einstellung gilt für alle Repositorys im Projekt.

Ein

Zulassen, dass Benutzer Forks aus dem Repository erstellen können.

Ein

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

Ein

Zulassen von Erwähnungen in Commitkommentaren zum Schließen von Arbeitselementen. Erfordert Azure DevOps Server Version 2020.1 oder höher.

Ein

Denken Sie daran, dass Benutzereinstellungen zum Abschließen von Arbeitselementen mit Pullanforderungen verwendet werden.

Ein

Zulassen, dass Benutzer Berechtigungen für die von ihnen erstellten Verzweigungen verwalten können

Ein

Aktivieren Sie den strikten Abstimmungsmodus für das Repository, bei dem die Berechtigung "Mitwirken " für die Abstimmung über Pullanfragen erforderlich ist.

Ein

Deaktivieren Sie den Zugriff auf das Repository, einschließlich Builds und Pullanforderungen, aber behalten Sie das Repository mit einer Warnung auffindbar.

Ein

Geben Sie bis zu fünf weitere Verzweigungen an, um an der Codesuche teilzunehmen, die standardmäßig nur für die Standardverzweigung gilt. Erfordert, dass die Codesucheerweiterung installiert und aktiviert ist.

Repositoryrichtlinien oder -optionen

In der folgenden Tabelle werden die Richtlinien oder Optionen zusammengefasst, die Sie für alle oder einzelne Repositorys festlegen können. Richtlinien, die für alle Repositorys festgelegt sind, legen den Standardwert für einzelne Repositorys fest, die zu einem späteren Zeitpunkt hinzugefügt wurden.

Richtlinie oder Option

Standard

Beschreibung


Aus

Blockieren von Pushs mit einer Commitautor-E-Mail, die nicht mit den angegebenen Mustern übereinstimmt. Diese Einstellung erfordert Azure DevOps Server Version 2020.1 oder höher.

Aus

Blockieren von Pushs beim Einführen von Dateipfaden, die den angegebenen Mustern entsprechen. Diese Einstellung erfordert Azure DevOps Server Version 2020.1 oder höher.

Aus

Vermeiden Sie Groß-/Kleinschreibungskonflikte, indem Sie Pushs blockieren, die das Formatieren von Namen in Dateien, Ordnern, Verzweigungen und Tags ändern.

Aus

Blockieren Sie Pushs, die Dateien, Ordner oder Verzweigungsnamen einführen, die plattform reservierte Namen oder inkompatible Zeichen enthalten.

Aus

Blockieren Von Pushs, die Pfade einführen, die die angegebene Länge überschreiten.

Aus

Blockieren Sie Pushes, die neue oder aktualisierte Dateien enthalten, die größer als der ausgewählte Grenzwert sind.

Branchrichtlinien

In der folgenden Tabelle werden die Richtlinien zusammengefasst, die Sie zum Anpassen einer Verzweigung definieren können. Weitere Informationen zum Konfigurieren dieser Einstellungen finden Sie unter Verbessern der Codequalität mit Verzweigungsrichtlinien. Wenn Sie eine Richtlinie für eine Verzweigung festlegen, werden die folgenden Richtlinien automatisch erzwungen:

  • Pullanforderungen sind erforderlich, um den Zweig zu aktualisieren.
  • Der Zweig kann nicht gelöscht werden.

Richtlinie

Standard

Beschreibung


Aus

Erfordern Sie die Genehmigung von einer angegebenen Anzahl von Prüfern für Pullanforderungen.

Aus

Fördern Sie die Ablaufverfolgung, indem Sie nach verknüpften Arbeitselementen auf Pullanforderungen suchen.

Aus

Überprüfen Sie, ob alle Kommentare auf Pullanforderungen aufgelöst wurden.

Aus

Steuern Sie den Zweigverlauf, indem Sie die verfügbaren Seriendrucktypen einschränken, wenn Pullanforderungen abgeschlossen werden.

Aus

Fügen Sie einen oder mehrere Richtlinien hinzu, um Code zu überprüfen, indem Sie Änderungen an Pull-Anforderungsänderungen vorab zusammenführen, aktivieren oder deaktivieren.

Aus

Hinzufügen, Aktivieren oder Deaktivieren einer oder mehrerer Richtlinien, um andere Dienste zu benötigen, um den erfolgreichen Status zu veröffentlichen, um Pullanforderungen abzuschließen.

Aus

Fügen Sie eine oder mehrere Richtlinien hinzu, um Codeprüfer automatisch einzuschließen, wenn Pullanforderungen bestimmte Codebereiche ändern.

Voraussetzungen

  • Um Richtlinien zu konfigurieren, müssen Sie Mitglied der Sicherheitsgruppe Project Administratoren sein oder Über Berechtigungen auf Repositoryebene verfügen. Weitere Informationen finden Sie unter Festlegen von Git-Repositoryberechtigungen.

Anzeigen und Bearbeiten von Einstellungen und Richtlinien

Sie können Einstellungen für alle Repositorys in einer Organisation oder einem Projekt oder für einzelne Repositorys konfigurieren. Sie können Richtlinien für alle Repositorys, für einzelne Repositorys oder für bestimmte Verzweigungen über Repositorys konfigurieren. Informationen zum Festlegen von Zweigrichtlinien finden Sie unter Branch-Richtlinien.

Hinweis

Es ist am besten, Repositoryeinstellungen auf Projektebene oder für einzelne Repositorys zu konfigurieren, aber nicht beide. Wenn Sie Einstellungen auf mehr als einer Ebene konfigurieren, honoriert das System die restriktivste Einstellung. Die Konfiguration von Einstellungen auf nur einer Ebene reduziert Verwirrung und Git-Leistungsprobleme.

Um Repositoryeinstellungen und -richtlinien über das Webportal zu konfigurieren, öffnen Sie ProjectsettingsRepositories> aus Ihrem Webbrowser.

  1. Um Einstellungen oder Richtlinien für alle Git-Repositorys anzuzeigen oder zu ändern, öffnen Sie die Seite "Alle Repositorys", und wählen Sie Einstellungen oder Richtlinien aus.

    Screenshot that shows repository Settings for All Repositories

    Wenn Sie Einstellungen und Richtlinien für ein bestimmtes Repository konfigurieren möchten, wählen Sie die Registerkarte "Repository" aus, wählen Sie das Repository aus, und wählen Sie dann die Registerkarte "Einstellungen" oder "Richtlinien" aus.

    Screenshot that shows repository Settings for the Fabrikam repository.

  2. Der folgende Screenshot zeigt die ausgewählte Registerkarte Einstellungen. Sie können diese Einstellungen für alle Git-Repositorys oder für ein einzelnes Repository definieren.

    Screenshot that shows the repo project Settings tab selected.

  3. Im folgenden Screenshot wird die Registerkarte "Richtlinien " ausgewählt. Sie können diese Richtlinien für alle Git-Repositorys oder für ein einzelnes Repository definieren.

    Screenshot that shows the repo 'Policies' tab selected.

  1. Öffnen Sie im Webbrowser das Projekt, und wählen Sie Project Einstellungen, Repositorys und wählen Sie Ihr Repository aus.

    Screenshot of the 'Project Settings' for your repository.

  2. Wenn Sie Repositoryeinstellungen anzeigen und konfigurieren möchten, wählen Sie "Optionen " oder " Richtlinien" aus.

    Der folgende Screenshot zeigt Optionen für alle Repositorys:

    Screenshot of the Options for all repositories.

    Der folgende Screenshot zeigt Optionen für die Fabrikam-Repositorys:

    Screenshot of Options for the Fabrikam repository.

  1. Öffnen Sie im Webbrowser das Projekt, und wählen Sie das Zahnradsymbol, die Versionskontrolle und das Repository aus.

    Screenshot that shows the 'Version Control' options for your repository.

  2. Wählen Sie Optionen aus, um Ihre Repositoryeinstellungen anzuzeigen und zu konfigurieren.

    The options UI

Standardzweigname

Sie können einen Standard-Repository-Verzweigungsnamen auf Organisations- oder Projektebene festlegen. Die Einstellung auf Organisationsebene wirkt sich für alle neuen Repositorys in allen Projekten in der Organisation aus. Die Einstellung auf Projektebene wirkt sich auf alle neuen Repositorys in einem Projekt aus, und übergibt jeden Namen auf Organisationsebene.

Sie haben folgende Möglichkeiten:

  • Wählen Sie einen beliebigen Rechtszweignamen aus, der verwendet werden soll, wenn ein Repository initialisiert wird.
  • Ändern Sie den Standardnamen jederzeit, um alle zukünftigen Repositorys zu beeinflussen.
  • Ändern Sie den Standardzweignamen für jedes bestimmte Repository jederzeit.

Wenn Sie das Standardzweignamenfeature nicht aktivieren, initialisieren Repositorys mit dem Azure Repos Standardzweignamenmain.

So legen Sie einen Standardzweignamen auf Organisationsebene fest:

  1. Wählen Sie auf Ihrer Azure DevOps Organisationsseite die Einstellungen "Organisation" unten links aus, und wählen Sie dann "Repositorys" in der linken Navigation aus.
  2. Legen Sie auf der Seite "Alle Repositorys " den Standardzweignamen für neue Repositorys auf "On" fest, und geben Sie dann einen Standardzweignamen ein.

Screenshot that shows the organization-level setting for Default branch name for new repositories.

So legen Sie einen Standardzweignamen auf Projektebene fest:

  1. Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
  2. Legen Sie auf der Registerkarte Einstellungen "Alle Repositorys" auf der Seite "Alle Repositorys" den Standardzweignamen für neue Repositorys auf "On" fest, und geben Sie dann einen Standardzweignamen ein.

Screenshot that shows the project-level setting for Default branch name for new repositories.

Hinweis

Der Standardzweigname für neue Repositorys erfordert Azure DevOps Server 2020.1 oder höher.

Branch-Berechtigungsverwaltung

Sie können steuern, wer Berechtigungen für Repository-Verzweigungen verwalten kann, indem Sie eine Berechtigungsverwaltungseinstellung für alle Git-Repositorys oder für einzelne Repositorys festlegen. Wenn Sie benutzern das Verwalten von Berechtigungen für ihre erstellten Verzweigungen auf der Ebene "Alle Repositorys " ermöglichen, werden alle neuen Projektrepositorys konfiguriert, um Benutzern die Verwaltung von Berechtigungen für ihre erstellten Zweige zu ermöglichen.

So verwalten Sie diese Einstellung:

  1. Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
  2. Legen Sie auf der Registerkarte Einstellungen "Alle Repositorys" auf der Seite "Alle Repositorys" fest, dass Benutzer Berechtigungen für ihre erstellten Verzweigungen auf"Ein" oder "Aus" verwalten können.

Screenshot that shows the project-level Allow users to manage permissions for their created branches setting.

So aktivieren oder deaktivieren Sie diese Einstellung für einzelne Repositorys:

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
  2. Legen Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" die Berechtigungsverwaltung auf "Ein" oder "Aus" fest.

Screenshot that shows the Permissions management repository setting.

Gravatarbilder

Diese Einstellung aktiviert oder deaktiviert die Verwendung von Gravatar-Bildern für Benutzer außerhalb Ihres Unternehmens.

Gravatar-Bilder sind eine Einstellung auf Organisationsebene.

  1. Wählen Sie auf Ihrer Azure DevOps Organisationsseite die Einstellungen "Organisation" unten links aus, und wählen Sie dann "Repositorys" in der linken Navigation aus.
  2. Legen Sie auf der Seite "Alle Repositorys " Gravatar-Bilder auf "Ein " oder "Aus" fest.

Screenshot that shows the organization-level setting for Gravatar images.

Gravatar-Bilder sind eine Projektebeneneinstellung für alle Repositorys.

  1. Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
  2. Legen Sie auf der Registerkarte Einstellungen der Seite "Alle Repositorys" Gravatar-Bilder auf "Ein" oder "Aus" fest.

Gravatar-Bilder sind eine Projektebeneneinstellung für alle Repositorys.

  1. Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
  2. Legen Sie auf der Registerkarte Einstellungen der Seite "Alle Repositorys" Gravatar-Bilder auf "Ein" oder "Aus" fest.

Gravatar-Bilder sind eine einzelne Repositoryeinstellung.

Aktivieren von Forks

Diese Repositoryeinstellung steuert, ob Benutzer neue serverseitige Forks erstellen können. Das Deaktivieren dieser Einstellung entfernt keine vorhandenen Forks.

  1. Wählen Sie aus Project EinstellungenRepositorys in der linken Navigation aus.
  2. Wählen Sie auf der Registerkarte "Repositorys " auf der Seite "Alle Repositorys " ein Repository aus.
  3. Legen Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" Forks auf "Ein" oder "Aus" fest.

Screenshot that shows the Forks repository setting.

Verknüpfungseinstellungen für Arbeitselemente

Diese Repositoryeinstellungen verwalten die Verknüpfung von Arbeitselementen.

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
  2. Aktivieren oderDeaktivieren Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" die Einstellungen.

Screenshot that shows the work item linking repository settings.

Commit-Erwähnungsverknüpfung

Wenn aktiviert, binden Sie Nachrichten, die gefolgt von einer gültigen Arbeitselement-ID enthalten # , den Commit automatisch mit diesem Arbeitselement verknüpft. Deaktivieren Sie diese Einstellung, wenn das Repository zuvor ein anderes Konto oder einen anderen Dienst verwendet hat. Diese Repositorys verfügen möglicherweise über Commitnachrichten mit # Erwähnungen, die nicht mit den Arbeitselement-IDs im aktuellen Konto übereinstimmen.

Commit-Erwähnung der Arbeitselementauflösung

Aktivieren Sie diese Einstellung, um Arbeitselemente automatisch abzuschließen, wenn verknüpfte Pullanforderungen abgeschlossen sind. Diese Einstellung ermöglicht es auch, andere Übergangszustände für Arbeitselemente in Pull-Anforderungs-Commitnachrichten anzugeben. Weitere Informationen finden Sie unter "Automatisches Abschließen von Arbeitselementen mit Pullanforderungen".

Commit-Erwähnung der Arbeitselementauflösung

Aktivieren Sie diese Einstellung, um diese Arbeitselemente automatisch abzuschließen, wenn Sie die PR erfolgreich abschließen. Weitere Informationen finden Sie unter "Automatisches Abschließen von Arbeitselementen mit Pullanforderungen".

Einstellungen für den Übergang von Arbeitselementen

Standardmäßig erinnert sich die Option zum Abschließen verknüpfter Arbeitselemente während des Pullanforderungsabschlusses an die letzte Wahl jedes Benutzers. Teams, die Benutzer davon abhindern möchten, Arbeitselemente mit ihren Pullanforderungen abzuschließen, können diese Einstellung deaktivieren. Benutzer müssen sich dann bei jedem Abschluss einer Pull-Anforderung anmelden, um Arbeitselemente abzuschließen.

Einstellung "Strikter Abstimmungsmodus"

In bestimmten Situationen können Benutzer, die keine Mitwirkenden an ein Repository sind, eine Pullanforderung übermitteln und dazu führen, dass sie je nach Richtlinien zusammengeführt werden. Um diese Möglichkeit zu verhindern, aktivieren Sie den strikten Abstimmungsmodus , um die erforderliche Berechtigung für die Abstimmung auf Repository-Pullanforderungen für Mitwirken zu ändern. Das Aktivieren dieser Einstellung wird empfohlen, wenn Sie sich auf Benutzer-Forks in Azure Repos verlassen.

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
  2. Legen Sie auf der Registerkarte Einstellungen der Seite "Repositoryname>" den<"Strikten Abstimmungsmodus" auf "Ein" oder "Aus" fest.

Screenshot that shows the Strict Vote Mode repository setting.

Repositoryeinstellung deaktivieren

Durch Aktivieren dieser Einstellung wird der Zugriff auf das Repository deaktiviert, einschließlich Builds und Pullanforderungen, aber das Repository wird mit einer Warnung ermittelt.

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
  2. Legen Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" unter "Repository deaktivieren" das Repository auf "Ein" oder "Deaktivieren" fest.

Screenshot that shows the Disable Repository setting.

Einstellung für durchsuchbare Verzweigungen

Standardmäßig gilt die Codesuche in Dateien nur für den Standardzweig. Sie können bis zu fünf weitere Verzweigungen hinzufügen, um zu suchen.

Wichtig

Um Code in Repositorys zu durchsuchen, müssen Sie die Marketplace-Codesuche-Erweiterung installieren. Wenn im Repository Einstellungen Registerkarte "Suchbare Verzweigungen" nicht angezeigt werden, stellen Sie sicher, dass die Erweiterung installiert ist.

So fügen Sie Zweige für die Codesuche hinzu:

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
  2. Wählen Sie auf der Registerkarte "Einstellungen" der <Seite "Repositoryname>" die + Option in suchbaren Zweigen aus.
  3. Wählen Sie einen Zweig aus, der in die Suche einbezogen werden soll, und wählen Sie dann "Verzweigung hinzufügen" aus.

Screenshot that shows the Searchable Branches repository setting.

Hinweis

Die Einstellung "Suchbare Verzweigungen" erfordert Azure DevOps Server 2020.1 oder höher.

Verzweigungsrichtlinien

Sie können Richtlinien für einen bestimmten Verzweigungsnamen oder für den Standardzweig für alle Repositorys in einem Projekt festlegen. Sie können beispielsweise zwei Mindestüberprüfungen für alle Pullanforderungen in jedem main Zweig für alle Projektrepositorys benötigen.

So legen Sie Richtlinien fest, um bestimmte oder standardmäßige Verzweigungsnamen in einem Projekt zu schützen:

  1. Wählen Sie aus Project EinstellungenRepositorys in der linken Navigation aus.

  2. Wählen Sie auf der Seite "Alle Repositorys " die Registerkarte "Richtlinien " aus.

  3. Wählen Sie am unteren Rand der Seite die Pluszeichen-Anmelderichtlinien + aus.

  4. Wählen Sie auf dem Bildschirm " Verzweigungsschutz hinzufügen " die Standardzweige jedes Repositorys oder "Aktuelle und zukünftige Zweige schützen" aus, die einem angegebenen Muster entsprechen.

    Wenn Sie die zweite Option auswählen, geben Sie den Verzweigungsnamen ein, um zu schützen. Eine Informationsnachricht teilt Ihnen mit, wie viele aktuelle Zweigstellen betroffen sind. Der Zweig muss noch nicht vorhanden sein, um den Zweignamen zu schützen.

  5. Klicken Sie auf Erstellen.

    Screenshot that shows enabling cross-repo branch policies.

  6. Legen Sie auf der Seite "Verzweigungsnamen>" die gewünschten Richtlinien für < die geschützten Zweigstellen fest. Weitere Informationen zu Verzweigungsrichtlinien finden Sie unter Branch-Richtlinien.

    Screenshot that shows cross-repo branch policy settings.

Commit-E-Mail-Validierungsrichtlinie

Diese Richtlinie blockiert einen Commit an ein Repository durch Commitautoren, deren E-Mail-Adressen nicht mit einem Muster übereinstimmen.

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.

  2. Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die E-Mail-Überprüfung auf "Ein" oder<"Aus" fest.

  3. Wenn Sie die Richtlinie aktivieren, geben Sie die E-Mail-Adresse oder Adressen an, die übereinstimmen sollen.

    Sie können genaue E-Mail-Adressen angeben oder Wildcards verwenden. Verwenden Sie ; als Trennzeichen für mehrere E-Mail-Muster. E-Mail-Muster, die mit ! präfixiert sind, werden ausgeschlossen. Die Bestellung ist wichtig.

Screenshot that shows the Commit author email validation policy setting.

Dateipfadüberprüfungsrichtlinie

Sie können eine Richtlinie festlegen, die verhindert, dass ein Repository von Dateipfaden mit einem Muster übereinstimmt.

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.

  2. Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die Dateipfadüberprüfung auf "Ein" oder<"Aus" fest.

  3. Wenn Sie die Richtlinie aktivieren, geben Sie den Pfad oder Pfad an, der blockiert werden soll.

    Sie können genaue Pfade und Wildcards angeben. Genaue Pfade beginnen mit /. Sie können auch mehrere Pfade angeben, indem Sie als Trennzeichen verwenden ; . Pfade, die mit ! präfixiert sind, sind ausgeschlossen. Die Bestellung ist wichtig.

Screenshot that shows the File path validation policy setting.

Fallerzwingungsrichtlinie

Git ist groß-vertraulich, d. h. eine Datei mit dem Namen Foo.txt unterscheidet sich von einer Datei mit dem Namen foo.txt. Windows und macOS standardmäßig auf groß-insensitive Dateisysteme, d. h. Foo.txt und foo.txt sind der gleiche Name. Diese Diskrepanz kann Probleme verursachen, wenn jemand auf einem system mit Groß-/Kleinschreibung Dateien, Ordner, Zweigen oder Tags verschiebt, die nur durch Buchstabenfall unterscheiden. Weitere Informationen finden Sie unter Git-Plattformkompatibilität.

Wenn sich die meisten Ihrer Mitwirkenden auf Windows oder macOS befinden, empfiehlt es sich, die Fall-Durchsetzungsrichtlinie zu aktivieren. Bei der Groß- und Kleinschreibung wird der Server vom Standardmodus zwischen Groß- und Kleinschreibung wechselt, wobei File.txt und file.txt unterscheiden, auf einen Windows- und macOS-freundlichen Modus, in dem File.txt und file.txt als dieselbe Datei betrachtet werden. Diese Einstellung gilt für Dateien, Ordner, Branches und Tags.

Diese Einstellung verhindert, dass Mitwirkende nur Fallunterschiede einführen. Die Einstellung verhindert Groß-/Kleinschreibungskonflikte, indem Pushs blockiert werden, die den Namen für Dateien, Ordner, Verzweigungen und Tags ändern. Der Benutzer muss den fehlerlosen Verlauf neu schreiben, um das Problem zu beheben, und versuchen Sie es dann erneut.

Diese Einstellung wird kein Repository beheben, das bereits Objekte enthält, die sich nur nach Fall unterscheiden. Es ist am besten, solche Probleme zu beheben, bevor Sie die Richtlinie aktivieren. Benennen Sie Dateien und Ordner um, oder erstellen Sie Verzweigungen und Tags erneut, um nicht konfliktende Namen zu verwenden.

So legen Sie die Fallerzwingungsrichtlinie fest:

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
  2. Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die Fallerzwingung auf "Ein" oder<"Aus" fest.

Screenshot that shows the Case enforcement policy setting.

Hinweis

Die Richtlinie für die Falldurchsetzung erfordert TFS 2018.2 oder höher.

Richtlinie für reservierte Namen

Nicht alle Dateinamen sind für die drei wichtigsten Betriebssystemdateisysteme zulässig: Windows, macOS und Linux. Commits zu einem freigegebenen Repository enthalten möglicherweise Datei- oder Ordnernamen, die auf einer oder mehreren Plattformen ungültig sind. Wenn ungültige Dateien oder Ordner abgerufen und auf diesen Plattformen ausgecheckt werden, können Arbeitsverzeichnisse beschädigt werden. Weitere Informationen finden Sie unter Git-Plattformkompatibilität.

Sie können Richtlinien aktivieren oder deaktivieren, um Einschränkungen für Datei- und Ordnernamen zu platzieren. Die Einstellung "Reservierte Namen " blockiert Pushes an ein Repository, das Datei- oder Ordnernamen enthält, die auf allen Plattformen ungültig sind. Informationen dazu, welche Namen ungültig sind, finden Sie unter Git Cross-Platform-Kompatibilität.

So legen Sie die Richtlinie für reservierte Namen fest:

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
  2. Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" reservierte Namen auf "Ein" oder<"Aus" fest.

Screenshot that shows the Reserved names policy setting.

Maximale Pfadlängenrichtlinie

Nicht alle Pfadlängen sind für die drei wichtigsten Betriebssystemdateisysteme zulässig: Windows, macOS und Linux. Commits zu einem freigegebenen Repository enthalten möglicherweise Dateien oder Verzeichnisse mit Pfadlängen, die auf einer oder mehreren Plattformen ungültig sind. Wenn diese Dateien oder Verzeichnisse abgerufen und auf einer Plattform ausgecheckt werden, auf der sie ungültig sind, können Arbeitsverzeichnisse beschädigt werden. Weitere Informationen finden Sie unter Git-Plattformkompatibilität.

Die Einstellung "Maximale Pfadlänge " blockiert Pushes, die Dateien oder Verzeichnisse mit Pfadlängen enthalten, die auf jeder Plattform ungültig sind. Informationen dazu, welche Pfadlängen ungültig sind, finden Sie unter Git Cross-Platform-Kompatibilität. Wenn Sie diese Einstellung aktivieren, lautet 248der Standardwert , da die maximale Länge 100 % über alle drei Hauptplattformen unterstützt wird.

Sie können den maximalen Pfadwert ändern. Wenn Sie beispielsweise nur über macOS- oder Linux-Entwickler in Ihrer Organisation verfügen, können Sie die maximale Länge auf den Wert festlegen, der auf beiden Plattformen 1016unterstützt wird. Möglicherweise können Sie auch einen niedrigeren maximalen Pfadwert festlegen, um die Verzeichnisbenennungskonventionen Ihrer Organisation zu erzwingen.

So legen Sie die maximale Pfadlängenrichtlinie fest:

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
  2. Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die Maximale Pfadlänge auf "Ein" oder<"Aus" fest.
  3. Wenn Sie die Einstellung aktiviert haben, geben Sie eine maximale Pfadlänge ein.

Screenshot that shows the Maximum path length policy setting.

Maximale Dateigrößenrichtlinie

Große Dateien, die in Git eingecheckt wurden, bleiben unbefristet im Repository, und erhöhen die Klonzeiten und die Datenträgernutzung. Anleitungen zum Verwalten großer Dateien finden Sie unter Verwalten und Speichern großer Dateien in Git.

Die Einstellung "Maximale Dateigröße " blockiert Dateien über eine bestimmte Größe, indem sie das Repository eingeben. Wenn ein Push eine neue oder aktualisierte Datei enthält, die größer als der in dieser Einstellung konfigurierte Grenzwert ist, wird der Push blockiert. Der Benutzer muss seinen unbeschämten Verlauf erneut schreiben, um die große Datei zu entfernen und den Push erneut zu versuchen.

So konfigurieren Sie die Richtlinie für maximale Dateigröße :

  1. Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
  2. Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die maximale Dateigröße auf "Ein" oder<"Aus" fest.
  3. Wenn Sie die Einstellung aktiviert haben, wählen Sie eine maximale Dateigröße aus.

Screenshot that shows the Maximum file size policy setting.

Hinweis

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

Nächste Schritte