View a markdown version of this page

Verbindungen für GitLab Selbstverwalter - AWS CodePipeline
Stellen Sie eine Verbindung zu GitLab Self-Managed (Konsole) herErstellen Sie einen Host und stellen Sie eine Verbindung zu GitLab Self-Managed (CLI) her

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.

Verbindungen für GitLab Selbstverwalter

Mithilfe von Verbindungen können Sie Konfigurationen autorisieren und einrichten, die Ihren Drittanbieter mit Ihren AWS Ressourcen verknüpfen. Um Ihr Drittanbieter-Repository als Quelle für Ihre Pipeline zu verknüpfen, verwenden Sie eine Verbindung.

Anmerkung

Anstatt eine bestehende Verbindung in deinem Konto herzustellen oder zu verwenden, kannst du eine gemeinsame Verbindung zwischen anderen verwenden AWS-Konto. Siehe Verwenden Sie eine Verbindung, die mit einem anderen Konto geteilt wird.

Anmerkung

Diese Funktion ist in den Regionen Asien-Pazifik (Hongkong), Asien-Pazifik (Hyderabad), Asien-Pazifik (Jakarta), Asien-Pazifik (Melbourne), Asien-Pazifik (Osaka), Afrika (Kapstadt), Naher Osten (Bahrain), Naher Osten (VAE), Europa (Spanien), Europa (Zürich), Israel (Tel Aviv) oder AWS GovCloud (US-West) nicht verfügbar. Informationen zu anderen verfügbaren Aktionen finden Sie unter. Produkt- und Serviceintegrationen mit CodePipeline Überlegungen zu dieser Aktion in der Region Europa (Mailand) finden Sie im Hinweis unterCodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server und GitLab.com GitLab selbstverwaltete Aktionen.

Um eine GitLab selbstverwaltete Quellaktion hinzuzufügen CodePipeline, können Sie eine der folgenden Optionen wählen:

Anmerkung

Sie können eine Verbindung auch mithilfe der Developer Tools-Konsole unter Einstellungen herstellen. Siehe Verbindung erstellen.

Bevor Sie beginnen:

  • Sie müssen bereits ein Konto bei GitLab Enterprise Edition oder GitLab Community Edition mit einer selbstverwalteten Installation erstellt haben GitLab und über diese verfügen. Weitere Informationen finden Sie unter https://docs.gitlab.com/ee/subscriptions/self_managed/.

    Anmerkung

    Verbindungen bieten nur Zugriff für das Konto, das zum Erstellen und Autorisieren der Verbindung verwendet wurde.

    Anmerkung

    Sie können Verbindungen zu einem Repository herstellen GitLab, in dem Sie die Rolle Besitzer haben, und dann kann die Verbindung mit Ressourcen wie CodePipeline verwendet werden. Bei Repositorys in Gruppen müssen Sie nicht der Gruppenbesitzer sein.

  • Sie müssen bereits ein GitLab persönliches Zugriffstoken (PAT) mit dem api Gültigkeitsbereich erstellt haben. Wenn der Admin-Modus auf Ihrer GitLab Instance aktiviert ist, muss die PAT auch den admin_mode Bereich enthalten. Weitere Informationen finden Sie auf der GitLab Website unter Persönliche Zugriffstoken und https://docs.gitlab.com/security/tokens/access_token_scopes/ Zugriffstoken-Bereiche. Sie müssen Administrator sein, um den PAT erstellen und verwenden zu können.

    Anmerkung

    Ihr PAT wird zur Autorisierung des Hosts verwendet und wird nicht anderweitig gespeichert oder von Verbindungen verwendet. Um einen Host einzurichten, können Sie ein temporäres PAT erstellen. Nachdem Sie den Host eingerichtet haben, können Sie das PAT löschen.

  • Sie können sich dafür entscheiden, Ihren Host im Voraus einzurichten. Sie können einen Host mit oder ohne VPC einrichten. Einzelheiten zur VPC-Konfiguration und zusätzliche Informationen zum Erstellen eines Hosts finden Sie unter Host erstellen.

Stellen Sie eine Verbindung zu GitLab Self-Managed (Konsole) her

Gehen Sie wie folgt vor, um mithilfe der CodePipeline Konsole eine Verbindungsaktion für Ihr GitLab selbstverwaltetes Repository hinzuzufügen.

Anmerkung

GitLab Selbstverwaltete Verbindungen bieten nur Zugriff auf Repositorys, die dem GitLab selbstverwalteten Konto gehören, mit dem die Verbindung hergestellt wurde.

Bevor Sie beginnen:

Damit eine Hostverbindung als GitLab Self-Managed verwendet werden kann, müssen Sie die Schritte zum Erstellen einer Hostressource für Ihre Verbindung abgeschlossen haben. Weitere Informationen zu Verbindungen finden Sie unter Hosts verwalten.

Schritt 1: Erstellen oder bearbeiten Sie Ihre Pipeline

Um Ihre Pipeline zu erstellen oder zu bearbeiten

  1. Melden Sie sich bei der CodePipeline Konsole an.

  2. Wählen Sie eine der folgenden Optionen aus.

    • Wählen Sie, ob Sie eine Pipeline erstellen möchten. Folgen Sie den Schritten unter Pipeline erstellen, um den ersten Bildschirm auszufüllen, und wählen Sie Weiter. Wählen Sie auf der Seite Quelle unter Quellanbieter die Option GitLab Selbstverwaltet aus.

    • Wählen Sie, ob Sie eine vorhandene Pipeline bearbeiten möchten. Wählen Sie „Bearbeiten“ und dann „Phase bearbeiten“. Wählen Sie, ob Sie Ihre Quellaktion hinzufügen oder bearbeiten möchten. Geben Sie auf der Seite Aktion bearbeiten unter Aktionsname den Namen für Ihre Aktion ein. Wählen Sie unter Aktionsanbieter die Option GitLab Selbstverwaltet aus.

  3. Führen Sie eine der folgenden Aktionen aus:

    • Wählen Sie unter Verbindung die Option Mit GitLab selbstverwaltetem Anbieter verbinden aus, falls Sie noch keine Verbindung zu Ihrem Anbieter hergestellt haben. Fahren Sie mit Schritt 2 fort: Eine Verbindung zu GitLab Self-Managed herstellen.

    • Wenn Sie bereits eine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie unter Verbindung die Verbindung aus, und fahren Sie dann mit Schritt 3: Speichern Sie Ihre GitLab selbstverwaltete Quelle fort.

Schritt 2: Stellen Sie eine Verbindung zu GitLab Selfmanaged her

Nachdem Sie sich entschieden haben, die Verbindung herzustellen, wird die Seite Mit GitLab selbstverwaltetem System verbinden angezeigt.

Um eine Verbindung zu einer selbstverwalteten Verbindung herzustellen GitLab

  1. Geben Sie unter Connection Name (Verbindungsname) den Namen für die Verbindung ein.

  2. Geben Sie unter URL den Endpunkt für Ihren Server ein.

    Anmerkung

    Wenn die angegebene URL bereits verwendet wurde, um einen Host für eine Verbindung einzurichten, werden Sie aufgefordert, den Hostressourcen-ARN auszuwählen, der zuvor für diesen Endpunkt erstellt wurde.

  3. Wenn Sie Ihren Server in einer Amazon-VPC gestartet haben und eine Verbindung mit Ihrer VPC herstellen möchten, wählen Sie Use a VPC aus und geben Sie die Informationen für die VPC ein.

  4. Wählen Sie Mit Self-Managed verbinden. GitLab Die erzeugte Verbindung wird mit dem Status Pending (Ausstehend) angezeigt. Für die Verbindung mit den von Ihnen angegebenen Serverinformationen wird eine Hostressource erstellt. Für den Hostnamen wird die URL verwendet.

  5. Wählen Sie Update pending connection (Ausstehende aktualisieren) aus.

  6. Wenn eine Seite mit einer Weiterleitungsnachricht geöffnet wird, in der bestätigt wird, dass Sie mit dem Anbieter fortfahren möchten, wählen Sie Weiter. Geben Sie die Autorisierung für den Anbieter ein.

  7. Eine host_name Einrichtungsseite wird angezeigt. Geben Sie unter Persönliches Zugriffstoken bereitstellen Ihren GitLab PAT mit dem api Geltungsbereich an. Wenn der Admin-Modus auf Ihrer GitLab Instance aktiviert ist, muss die PAT auch den admin_mode Bereich enthalten. Weitere Informationen finden Sie auf der GitLab Website unter Zugriffstoken-Bereiche.

    Anmerkung

    Nur ein Administrator kann den PAT erstellen und verwenden.

    Klicken Sie auf Weiter.

    Screenshot der Konsole, der den GitLab selbstverwalteten persönlichen Zugriffstokeneintrag für den neuen Host zeigt

  8. Die Verbindungsseite zeigt die erstellte Verbindung im Status Available (Verfügbar).

Schritt 3: Speichern Sie Ihre GitLab selbstverwaltete Quellaktion

Gehen Sie im Assistenten oder auf der Seite „Aktion bearbeiten“ wie folgt vor, um Ihre Quellaktion mit Ihren Verbindungsinformationen zu speichern.

Um Ihre Quellaktion mit Ihrer Verbindung abzuschließen und zu speichern

  1. Wählen Sie unter Repository name (Repository-Name) den Namen Ihres Drittanbieter-Repositorys aus.

  2. Unter Pipeline-Trigger können Sie Auslöser hinzufügen, wenn es sich bei Ihrer Aktion um eine CodeConnections Aktion handelt. Weitere Informationen zur Konfiguration der Pipeline-Trigger und zum optionalen Filtern nach Triggern finden Sie unterTrigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen.

  3. Im Output artifact format (Format des Ausgabeartefakts) müssen Sie das Format für Ihre Artefakte auswählen.

    • Um die Ausgabeartefakte der GitLab selbstverwalteten Aktion mit der Standardmethode zu speichern, wählen Sie CodePipeline Standard. Die Aktion greift auf die Dateien aus dem Repository zu und speichert die Artefakte in einer ZIP-Datei im Pipeline-Artefaktspeicher.

    • Um eine JSON-Datei zu speichern, die einen URL-Verweis auf das Repository enthält, damit Downstream-Aktionen Git-Befehle direkt ausführen können, wählen Sie Full clone (Vollständiger Klon). Diese Option kann nur von CodeBuild nachgelagerten Aktionen verwendet werden.

  4. Wählen Sie im Assistenten Weiter oder auf der Aktionsseite „Bearbeiten“ die Option Speichern.

Erstellen Sie einen Host und stellen Sie eine Verbindung zu GitLab Self-Managed (CLI) her

Sie können die AWS Command Line Interface (AWS CLI) verwenden, um eine Verbindung herzustellen.

Verwenden Sie dazu den Befehl create-connection.

Wichtig

Eine Verbindung, die über AWS CLI oder AWS CloudFormation erstellt wurde, hat standardmäßig PENDING den Status. Nachdem Sie eine Verbindung mit der CLI oder hergestellt haben CloudFormation, bearbeiten Sie die Verbindung mithilfe der Konsole, um ihren Status zu ermittelnAVAILABLE.

Sie können die AWS Command Line Interface (AWS CLI) verwenden, um einen Host für installierte Verbindungen zu erstellen.

Sie verwenden Sie einen Host, der den Endpunkt für die Infrastruktur darstellt, in der der Drittanbieter installiert ist. Nachdem Sie die Hosterstellung mit der CLI abgeschlossen haben, befindet sich der Host im Status Ausstehend. Anschließend richten Sie den Host ein oder registrieren ihn, um ihn in den Status Verfügbar zu versetzen. Sobald der Host verfügbar ist, führen Sie die Schritte zum Erstellen einer Verbindung aus.

Verwenden Sie dazu den Befehl create-host.

Wichtig

Ein über den erstellter Host AWS CLI befindet sich standardmäßig im Pending Status. Nachdem Sie einen Host mit der CLI erstellt haben, verwenden Sie die Konsole oder die CLI, um den Host so einzurichten, dass er seinen Status erhältAvailable.

So erstellen Sie einen Host

  1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den AWS CLI , um den create-host Befehl auszuführen, und geben Sie dabei die --name--provider-type, und --provider-endpoint für Ihre Verbindung an. In diesem Beispiel lautet der Name des Drittanbieters GitLabSelfManaged und der Endpunkt my-instance.dev.

    aws codestar-connections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"

    Wenn der Befehl erfolgreich ausgeführt wurde, gibt er die Amazon-Ressourcenname (ARN)-Informationen zum Host ähnlich der folgenden zurück.

    {
    "HostArn": "arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605"
}

    Nach diesem Schritt befindet sich der Host im Status PENDING (Ausstehend).

  2. Schließen Sie das Host-Setup mit der Konsole ab und ändern Sie den Host-Status zu Available (Verfügbar).

Um eine Verbindung zu GitLab Self-Managed herzustellen

  1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Linux, macOS oder Unix). Verwenden Sie den AWS CLI , um den create-connection Befehl auszuführen, und geben Sie dabei das --host-arn und --connection-name für Ihre Verbindung an.

    aws codestar-connections create-connection --host-arn arn:aws:codestar-connections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection

    Wenn der Befehl erfolgreich ausgeführt wurde, gibt er die ARN-Informationen der Verbindung ähnlich der folgenden zurück.

    {
    "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad"
}

  2. Verwenden Sie die Konsole, um die ausstehende Verbindung einzurichten.

  3. Die Pipeline erkennt standardmäßig Änderungen, wenn Code an das Verbindungsquellen-Repository übertragen wird. Gehen Sie wie folgt vor, um die Pipeline-Trigger-Konfiguration für die manuelle Freigabe oder für Git-Tags zu konfigurieren:

    • Um die Pipeline-Trigger-Konfiguration so zu konfigurieren, dass sie nur mit einer manuellen Version beginnt, fügen Sie der Konfiguration die folgende Zeile hinzu: 

      "DetectChanges": "false",

    • Weitere Informationen zur Konfiguration der Pipeline-Trigger-Konfiguration zum Filtern nach Triggern finden Sie unterTrigger mit Code-Push- oder Pull-Request-Ereignistypen hinzufügen. Das Folgende erweitert beispielsweise die Pipeline-Ebene der Pipeline-JSON-Definition. In diesem Beispiel release-v1 sind release-v0 und die einzuschließenden Git-Tags und release-v2 das auszuschließende Git-Tag.

      "triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ]
                }
            }
        ]