View a markdown version of this page

Verbindung herstellen GitLab - AWS DevOps Agentin
Registrierung GitLab (auf Kontoebene)Projekte mit einem Agentenbereich verbindenKonfiguration der Codeüberprüfung und des automatisierten TestensGitLab Verbindungen verwalten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verbindung herstellen GitLab

GitLab Die Integration ermöglicht es dem AWS DevOps Agenten, Einsätze von GitLab Pipelines aus zu überwachen, um im Rahmen der Reaktion auf Vorfälle ursächliche Untersuchungen zu ermöglichen. Diese Integration folgt einem zweistufigen Prozess: Registrierung von bestimmten Projekten auf Kontoebene GitLab, gefolgt von der Verknüpfung bestimmter Projekte mit einzelnen Agent Spaces.

Registrierung GitLab (auf Kontoebene)

GitLab wird auf AWS Kontoebene registriert und von allen Agent Spaces in diesem Konto gemeinsam genutzt. Jede Registrierung ist mit einem GitLab Benutzer oder einer GitLab Gruppe verknüpft.

Schritt 1: Navigieren Sie zu den Pipeline-Anbietern

  1. Melden Sie sich bei der AWS Management Console an

  2. Navigieren Sie zur AWS DevOps Agent-Konsole

  3. Gehen Sie zur Seite Capability Providers (zugänglich über die Seitennavigation)

  4. Suchen Sie GitLab im Abschnitt Verfügbare Anbieter unter Pipeline nach und wählen Sie Registrieren

Schritt 2: GitLab Verbindung konfigurieren

Konfigurieren Sie auf der GitLab Registrierungsseite Folgendes:

Verbindungstyp — Wählen Sie aus, ob Sie eine Verbindung als Person oder Gruppe herstellen:

  • Persönlich (Standard) — Ihr individuelles GitLab Benutzerkonto mit einem Benutzernamen und einem Profil

  • Gruppe — In verwenden Sie Gruppen GitLab, um ein oder mehrere verwandte Projekte gleichzeitig zu verwalten

GitLab Instanztyp — Wählen Sie aus, zu welchem GitLab Instanztyp Sie eine Verbindung herstellen möchten:

  • GitLab.com(Standard) — Der öffentliche GitLab Dienst

  • Öffentlich zugänglich, selbst gehostet GitLab — Markieren Sie das Kästchen GitLab Selbst gehosteten Endpunkt verwenden und geben Sie die URL zu Ihrer GitLab Instanz an

Anmerkung

Derzeit werden nur öffentlich zugängliche GitLab Instanzen unterstützt.

Zugriffstoken — Stellen Sie ein GitLab persönliches Zugriffstoken bereit:

  1. Loggen Sie sich in einem separaten Browser-Tab in Ihr GitLab Konto ein

  2. Navigieren Sie zu Ihren Benutzereinstellungen und wählen Sie Access Tokens

  3. Erstellen Sie ein neues persönliches Zugriffstoken mit den folgenden Berechtigungen:

    • read_repository— Erforderlich für den Zugriff auf Repository-Inhalte

    • read_virtual_registry— Erforderlich für den Zugriff auf virtuelle Registrierungsinformationen

    • read_registry— Erforderlich für den Zugriff auf Registrierungsinformationen

    • api— Erforderlich für den Lese- und Schreibzugriff auf die API

    • self_rotate- Erforderlich für rotierende Token. Diese Funktion wird derzeit vom AWS DevOps Agenten nicht unterstützt, wird aber zu einem späteren Zeitpunkt unterstützt. Wenn Sie jetzt hinzufügen, müssen Sie in Zukunft kein neues Token erstellen.

  4. Legen Sie den Gültigkeitszeitraum des Tokens auf maximal 365 Tage ab dem aktuellen Datum fest

  5. Kopieren Sie das generierte Token

  6. Kehren Sie zur AWS DevOps Agentenkonsole zurück

  7. Fügen Sie das Token in das Feld „Zugriffstoken“ ein

Schritt 3: Registrierung abschließen

(Optional) Schlagworte — Fügen Sie der GitLab Registrierung aus organisatorischen Gründen AWS Stichwörter hinzu.

Wählen Sie Weiter, um Ihre Konfiguration zu überprüfen, und klicken Sie dann auf Senden, um den GitLab Registrierungsvorgang abzuschließen. Das System validiert Ihr Zugriffstoken und stellt die Verbindung her.

Projekte mit einem Agentenbereich verbinden

Nachdem Sie sich auf GitLab Kontoebene registriert haben, können Sie bestimmte Projekte mit einzelnen Agent Spaces verbinden:

  1. Wählen Sie in der AWS DevOps Agent-Konsole Ihren Agent Space aus

  2. Gehen Sie zur Registerkarte „Funktionen“

  3. Wählen Sie im Abschnitt Pipeline die Option Hinzufügen

  4. Wählen Sie GitLab aus der Liste der verfügbaren Anbieter

  5. Wählen Sie die GitLab Registrierung aus, die die Projekte enthält, die Sie verwenden möchten

  6. Wählen Sie die GitLab Projekte aus, die für Ihren Agent Space relevant sind

  7. Wählen Sie Speichern aus.

AWS DevOps Der Agent überwacht diese Projekte im Hinblick auf Bereitstellungen von GitLab Pipelines aus, um Ursachenuntersuchungen durchführen zu können. Ein einziger Agent Space kann Projekte aus mehreren Registrierungen verwenden. Um Projekte aus einer anderen Registrierung hinzuzufügen, wiederholen Sie diese Schritte.

Konfiguration der Codeüberprüfung und des automatisierten Testens

Wenn Sie im GitLab Verbindungsschritt Projekte auswählen, werden sie automatisch zum Abschnitt Codeüberprüfung und automatisiertes Testen hinzugefügt. In diesem Abschnitt wird konfiguriert, welche Projekte automatisch eine Überprüfung des Bereitschaftscodes für die Freigabe und automatische Testfunktionen auslösen.

Die Konfiguration für Codeüberprüfung und automatisiertes Testen umfasst:

  • Funktionen — Wählen Sie für jedes Projekt Funktionen zur Codeüberprüfung und zum automatisierten Testen aus. Der Abschnitt enthält zwei Einstellungen pro Projekt:

    • Automatisches Auslösen der Änderungsprüfung — Wenn diese Option für ein Projekt aktiviert ist, wird der DevOps Agent automatisch Überprüfung des Bereitschaftscodes für die Freigabe jedes Mal ausgeführt, wenn eine Zusammenführungsanforderung geöffnet oder aktualisiert wird. Die Ergebnisse der Überprüfung werden in Form von Kommentaren in der Zusammenführungsanfrage angezeigt. Dies ist standardmäßig für alle verbundenen Projekte aktiviert.

    • Automatisierter Verifizierungstest — Wenn der DevOps Agent für ein Projekt aktiviert ist, erstellt, führt und testet er Ihre Codeänderungen während der Codeüberprüfungen in einer verwalteten Überprüfungsumgebung. Dies ermöglicht eine Funktionsvalidierung, die über die statische Analyse hinausgeht. Weitere Informationen finden Sie unter Automatisierte Verifizierungstests. Dies ist standardmäßig für alle verbundenen Projekte aktiviert.

  • Projektliste — Zeigt alle Projekte an, die Sie während des Verbindungsschritts ausgewählt haben. Verwenden Sie das Suchfeld, um Projekte nach Namen zu filtern. Jedes Projekt hat unabhängige Kontrollkästchen für beide Funktionen.

  • Runtime-Rolle (optional) — Wählen Sie die IAM-Rolle aus, die der DevOps Agent annimmt, um automatisierte Funktionen für Ihre ausgewählten Projekte auszuführen. Diese Rolle wird verwendet, wenn Sie auf interne Dienste zugreifen, die während der Erstellung benötigt werden, z. B. private Paketregistrierungen und Artefakt-Speichersysteme. Wir empfehlen, eine andere Rolle als Ihre primäre Agentenrolle zu verwenden.

So konfigurieren Sie automatische Bewertungen:

  1. Nachdem Sie Ihre Projekte verbunden haben, navigieren Sie in Ihren GitLab Integrationseinstellungen zum Abschnitt Codeüberprüfung und automatisiertes Testen.

  2. Aktiviere oder deaktiviere für jedes Projekt die Funktion zum automatischen Auslösen von Change-Reviews, je nachdem, ob du automatische Prüfungen von Merge-Requests möchtest.

  3. Aktivieren oder deaktivieren Sie für jedes Projekt die Funktion für automatische Verifizierungstests, je nachdem, ob Sie automatisierte Verifizierungstests in einer verwalteten Überprüfungsumgebung wünschen.

  4. Wählen Sie optional eine IAM-Rolle aus dem Drop-down-Menü für die Runtime-Rolle aus, die der DevOps Agent übernimmt, wenn er automatisierte Funktionen für Ihre ausgewählten Projekte ausführt.

  5. Wählen Sie Speichern, um Ihre Konfiguration zu übernehmen.

Nach der Konfiguration löst jede neue Merge-Anfrage in einem Projekt, bei dem die automatische Trigger-Change-Überprüfung aktiviert ist, automatisch eine Codeüberprüfung der Release-Readiness aus. Wenn auch automatische Verifizierungstests aktiviert sind, umfasst die Überprüfung die Funktionsvalidierung in einer Verifizierungsumgebung. Weitere Informationen zu Codeüberprüfungen finden Sie unterÜberprüfung des Bereitschaftscodes für die Freigabe.

GitLab Verbindungen verwalten

  • Zugriffstoken aktualisieren — Wenn Ihr Zugriffstoken abläuft oder aktualisiert werden muss, können Sie es rotieren, ohne sich abzumelden. Wählen Sie auf der Seite „Capability Providers“ Ihre GitLab Registrierung aus, wählen Sie im Menü „Aktionen“ die Option „Aktualisieren“ und geben Sie das neue Token ein. Ihre Agent Space-Zuordnungen und Projektverbindungen bleiben erhalten.

  • Verbundene Projekte anzeigen — Wählen Sie in der AWS DevOps Agentenkonsole Ihren Agentenbereich aus und wechseln Sie zur Registerkarte Funktionen, um die verbundenen Projekte im Abschnitt Pipeline anzuzeigen.

  • GitLab Verbindung entfernen — Um GitLab Projekte von einem Agentenbereich zu trennen, wählen Sie die Verbindung im Abschnitt Pipeline aus und klicken Sie auf Entfernen. Um die GitLab Registrierung vollständig zu entfernen, entfernen Sie sie zuerst aus allen Agent Spaces und löschen Sie dann die Registrierung auf Kontoebene.