Bereitstellen des GitLab Merge Requests Server Microsoft 365 Copilot Connector

Der GitLab Merge Requests Server Microsoft 365 Copilot Connector integriert Mergeanforderungsmetadaten aus GitLab Self-Managed (Server) in Microsoft 365. Nach der Bereitstellung indiziert der Connector Mergeanforderungstitel, Beschreibungen, Bezeichnungen, Status, Zeitstempel, Autoren, Zugewiesene, Prüfer, Meilensteine und Projektkontext. Diese Indizierung ermöglicht Benutzern das Suchen, Zusammenfassen und Abrufen von Mergeanforderungserkenntnissen mithilfe von Microsoft 365 Copilot, Copilot Search und Microsoft Search.

In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des GitLab Merge Requests Server-Connectors beschrieben.

Voraussetzungen

Stellen Sie vor der Bereitstellung des GitLab Merge Requests Server-Connectors sicher, dass Ihr organization die folgenden Voraussetzungen erfüllt:

Vergewissern Sie sich, dass auf Ihre GitLab Server-instance über die GitLab-REST-API zugegriffen werden kann.
Generieren Sie eine Client-ID und einen geheimen Clientschlüssel aus GitLab für die OAuth 2.0-Authentifizierung.
Das Authentifizierungsbenutzerkonto muss Zugriff auf Repositorys, Issues, Mergeanforderungen, Wissensdateien und Wiki-Seiten haben.
Die Client-ID und der geheime Clientschlüssel müssen die folgenden Bereiche enthalten:
- read_api
- read_repository
- read_user
Benutzer, die auf indizierte GitLab-Daten zugreifen, müssen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung verfügen.
Konfigurieren Sie die entsprechende Umleitungs-URL beim Erstellen der GitLab OAuth-Anwendung:
- Microsoft 365 Enterprise:https://gcs.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback
Stellen Sie für selbstverwaltete GitLab-Umgebungen folgendes sicher:
- Sie verfügen über GitLab Version 17.7 oder höher.
- Der Microsoft Graph-Connector-Agent version 3.1.8.0 oder höher wird auf einem Server installiert, der eine Verbindung mit dem GitLab-instance herstellen kann.
- Das Authentifizierungskonto muss über Administratorrechte verfügen, um die Durchforstung der Zugriffssteuerungsliste (Access Control List, ACL) zu aktivieren.
Passen Sie die GitLab-Ratenlimits wie empfohlen an, um eine optimale Leistung zu erzielen:
- Grenzwerte für Benutzer- und IP-Rate: Deaktivieren Sie die Option Authentifizierte API-Anforderungsratenbegrenzung aktivieren und Grenzwert für authentifizierte Webanforderungsraten aktivieren.
- Api-Ratenlimits für Dateien: Deaktivieren Sie das Kontrollkästchen Authentifizierte API-Anforderungsratenbegrenzung aktivieren.
- Veraltete API-Ratenlimits: Deaktivieren Sie das Kontrollkästchen Authentifizierte API-Anforderungsratenbegrenzung aktivieren.
- Api-Ratenlimits für Benutzer: Legen Sie max. Anforderungen pro 10 Minuten pro Benutzer auf einen hohen Wert fest (z. B. 100000).
- Api-Ratenlimits für Gruppen und Projekte: Legen Sie alle Werte auf 0 fest, um Grenzwerte zu deaktivieren.
- Api-Ratenlimits für Mitglieder: Auf 0 festgelegt.

Empfehlungen zur Ratenbegrenzung

Verwenden Sie die Richtlinien in der folgenden Tabelle, um Einstellungen für die Ratenbegrenzung basierend auf der ungefähren Anzahl von GitLab-Mergeanforderungen auszuwählen.

Ungefähre Anzahl von Elementen	Empfohlene Ratenbegrenzungseinstellung	Ungefähre Zeit bis zum Abschluss der Erfassung
Bis zu 100.000	Standardeinstellungen für ratelimit verwenden (7200/Stunde)	Stunden bis 1 Tag
100.000 bis 1.000.000	Standardeinstellungen für ratelimit verwenden (7200/Stunde)	2 Tage bis 1 Woche
1.000.000 oder mehr	Standardeinstellungen für ratelimit verwenden (7200/Stunde)	1–2 Wochen (variiert je nach Umgebungslast)

Bereitstellen des Connectors

So fügen Sie den GitLab Merge Requests Server-Connector für Ihre organization hinzu:

Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors >aus.
Wechseln Sie zur Registerkarte Connectors , und wählen Sie Katalog aus.
Wählen Sie in der Liste der verfügbaren Connectors GitLab Merge Requests Server aus.

Festlegen des Anzeigenamens

Der Anzeigename identifiziert Verweise in Copilot-Antworten und hilft Benutzern, die zugeordnete Inhaltsquelle zu erkennen. Sie können den Standardmäßigen Anzeigenamen des GitLab Merge Requests-Servers übernehmen oder anpassen.

Weitere Informationen zu Anzeigenamen von Connectors finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.

Festlegen instance URL

Geben Sie die Basis-URL Ihrer GitLab Server-instance an. Diese URL wird vom Connector verwendet, um über die REST-APIs von GitLab auf Mergeanforderungsdaten zuzugreifen. Verwenden Sie das folgende Format:

https://<your-gitlab-server>/

Auswählen des Graph-Connector-Agents

Wählen Sie den Microsoft Graph-Connector-Agent aus, den Ihr organization zum Erfassen von GitLab-Inhalten verwendet. Der Agent muss auf einem Computer installiert sein, der Ihre GitLab Server-instance erreichen kann.

Auswählen des Authentifizierungstyps

Der GitLab Merge Requests Server-Connector unterstützt die OAuth 2.0-Authentifizierung . Geben Sie Ihre Client-ID und ihren geheimen Clientschlüssel ein, und wählen Sie dann Autorisieren aus, um den OAuth-Fluss abzuschließen.

Informationen zum Erstellen einer GitLab OAuth-App finden Sie unter Konfigurieren von GitLab als OAuth 2.0-Authentifizierungsidentitätsanbieter.

Rollout

Um den Connector für eine begrenzte Zielgruppe bereitzustellen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer oder Gruppen an. Weitere Informationen finden Sie unter Gestaffelter Rollout für Copilot-Connectors.

Der GitLab Merge Requests Server-Connector beginnt unmittelbar nach der Bereitstellung mit der Indizierung von Inhalten.

Um die Verbindung anzupassen, wählen Sie Benutzerdefiniertes Setup aus. Weitere Informationen finden Sie unter Anpassen von Einstellungen.

Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.

Anpassen von Einstellungen (optional)

Sie können die Standardwerte für die GitLab Merge Requests Server-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen von Einstellungen auf der Connectorseite Die Option Benutzerdefinierte Einrichtung aus.

Anpassen von Benutzereinstellungen

Zugriffsberechtigungen

Wählen Sie aus, ob indizierte Daten für Folgendes sichtbar sind:

Nur Personen mit Zugriff auf diese Datenquelle (Standard)
Jeder

Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden indizierte Daten in den Suchergebnissen für Benutzer angezeigt, die Zugriff darauf haben. Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt.

Zuordnen von Identitäten

Ordnen Sie GitLab-Benutzeridentitäten Microsoft Entra ID zu. Die folgenden Optionen stehen zur Verfügung:

Email: Ordnet GitLab-E-Mails Microsoft Entra ID Benutzereigenschaften zu.
Anmeldung: Ordnet GitLab-Anmeldungen Microsoft Entra ID Benutzereigenschaften zu.
Name: Ordnet GitLab-Name Microsoft Entra ID Benutzereigenschaften zu.

Wenn bei der direkten Zuordnung ein Fehler auftritt, verwenden Sie reguläre Ausdrücke (regex), um die Daten zu transformieren. Beispiel: [a-zA-Z0-9]+. Weitere Informationen finden Sie unter Zuordnen Microsoft Entra Identitäten.

Anpassen von Inhaltseinstellungen

Auf der Registerkarte Daten können Sie Eigenschaftenzuordnungen in den Beispieldaten für Metadaten wie Inhalt, Bezeichnungen, Beschreibung und Zeitstempel überprüfen.

Abfragezeichenfolge

Sie können einen Zeitbereichsfilter für den Connector konfigurieren. Die Standardeinstellung ist 365 Tage.

Eigenschaften verwalten

Sie können der Datenquelle verfügbare Eigenschaften hinzufügen oder daraus entfernen, der Eigenschaft ein Schema zuweisen (durchsuchbar, abfragbar, abrufbar oder verfeinernd), die semantische Bezeichnung ändern und der Eigenschaft einen Alias hinzufügen.

Anpassen von Synchronisierungsintervallen

Konfigurieren Sie vollständige und inkrementelle Durchforstungsintervalle. Dies wird jedoch nur für gesamtstrukturübergreifende Umgebungen empfohlen.

Inkrementelle Durchforstung: Alle 15 Minuten
Vollständige Durchforstung: Täglich

Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.

Last updated on 2026-01-24

Freigeben über