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.
- Wenn Sie az repos-Befehle verwenden möchten, müssen Sie die Schritte in Erste Schritte mit Azure DevOps CLI ausführen.
- 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.
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.
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.
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.
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.
Öffnen Sie im Webbrowser das Projekt, und wählen Sie Project Einstellungen, Repositorys und wählen Sie Ihr Repository aus.
Wenn Sie Repositoryeinstellungen anzeigen und konfigurieren möchten, wählen Sie "Optionen " oder " Richtlinien" aus.
Der folgende Screenshot zeigt Optionen für alle Repositorys:
Der folgende Screenshot zeigt Optionen für die Fabrikam-Repositorys:
Öffnen Sie im Webbrowser das Projekt, und wählen Sie das Zahnradsymbol, die Versionskontrolle und das Repository aus.
Wählen Sie Optionen aus, um Ihre Repositoryeinstellungen anzuzeigen und zu konfigurieren.
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:
- 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.
- Legen Sie auf der Seite "Alle Repositorys " den Standardzweignamen für neue Repositorys auf "On" fest, und geben Sie dann einen Standardzweignamen ein.
So legen Sie einen Standardzweignamen auf Projektebene fest:
- Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
- 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.
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:
- Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
- 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.
So aktivieren oder deaktivieren Sie diese Einstellung für einzelne Repositorys:
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
- Legen Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" die Berechtigungsverwaltung auf "Ein" oder "Aus" fest.
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.
- 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.
- Legen Sie auf der Seite "Alle Repositorys " Gravatar-Bilder auf "Ein " oder "Aus" fest.
Gravatar-Bilder sind eine Projektebeneneinstellung für alle Repositorys.
- Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
- 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.
- Wählen Sie auf der Azure DevOps Projektseite Project Einstellungen unten links aus, und wählen Sie dann Repositorys in der linken Navigation aus.
- 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.
- Wählen Sie aus Project EinstellungenRepositorys in der linken Navigation aus.
- Wählen Sie auf der Registerkarte "Repositorys " auf der Seite "Alle Repositorys " ein Repository aus.
- Legen Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" Forks auf "Ein" oder "Aus" fest.
Verknüpfungseinstellungen für Arbeitselemente
Diese Repositoryeinstellungen verwalten die Verknüpfung von Arbeitselementen.
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
- Aktivieren oderDeaktivieren Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" die Einstellungen.
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.
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
- Legen Sie auf der Registerkarte Einstellungen der Seite "Repositoryname>" den<"Strikten Abstimmungsmodus" auf "Ein" oder "Aus" fest.
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.
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
- Legen Sie auf der Registerkarte Einstellungen der <Seite "Repositoryname>" unter "Repository deaktivieren" das Repository auf "Ein" oder "Deaktivieren" fest.
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:
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie dann ein Repository aus.
- Wählen Sie auf der Registerkarte "Einstellungen" der <Seite "Repositoryname>" die + Option in suchbaren Zweigen aus.
- Wählen Sie einen Zweig aus, der in die Suche einbezogen werden soll, und wählen Sie dann "Verzweigung hinzufügen" aus.
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:
Wählen Sie aus Project EinstellungenRepositorys in der linken Navigation aus.
Wählen Sie auf der Seite "Alle Repositorys " die Registerkarte "Richtlinien " aus.
Wählen Sie am unteren Rand der Seite die Pluszeichen-Anmelderichtlinien + aus.
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.
Klicken Sie auf Erstellen.
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.
Commit-E-Mail-Validierungsrichtlinie
Diese Richtlinie blockiert einen Commit an ein Repository durch Commitautoren, deren E-Mail-Adressen nicht mit einem Muster übereinstimmen.
Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die E-Mail-Überprüfung auf "Ein" oder<"Aus" fest.
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.
Dateipfadüberprüfungsrichtlinie
Sie können eine Richtlinie festlegen, die verhindert, dass ein Repository von Dateipfaden mit einem Muster übereinstimmt.
Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die Dateipfadüberprüfung auf "Ein" oder<"Aus" fest.
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.
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:
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
- Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die Fallerzwingung auf "Ein" oder<"Aus" fest.
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:
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
- Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" reservierte Namen auf "Ein" oder<"Aus" fest.
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:
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
- Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die Maximale Pfadlänge auf "Ein" oder<"Aus" fest.
- Wenn Sie die Einstellung aktiviert haben, geben Sie eine maximale Pfadlänge ein.
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 :
- Wählen Sie Project Einstellungen>Repositories aus, und wählen Sie ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.
- Legen Sie auf der Registerkarte "Richtlinien" der Seite "Alle Repositorys" oder "Repositoryname>" unter "Repositoryrichtlinien" die maximale Dateigröße auf "Ein" oder<"Aus" fest.
- Wenn Sie die Einstellung aktiviert haben, wählen Sie eine maximale Dateigröße aus.
Hinweis
Die Richtlinie "Maximale Dateigröße " erfordert TFS 2018.2 oder höher.