Erstelle eine Verbindung zu GitLab.com (Konsole)Stellen Sie eine Verbindung zu GitLab.com (CLI) her

GitLab.com Verbindungen

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.com Quellaktion hinzuzufügen CodePipeline, können Sie eine der folgenden Optionen wählen:

Verwenden Sie den Assistenten zum Erstellen einer Pipeline in der CodePipeline Konsole oder auf der Seite „Aktion bearbeiten“, um die GitLab Anbieteroption auszuwählen. Weitere Informationen finden Erstelle eine Verbindung zu GitLab.com (Konsole) Sie unter So fügen Sie die Aktion hinzu. Die Konsole hilft Ihnen beim Erstellen einer Verbindungsressource.
Verwenden Sie die CLI, um die Aktionskonfiguration für die CreateSourceConnection Aktion beim GitLab Anbieter wie folgt hinzuzufügen:
- Informationen zum Erstellen Ihrer Verbindungsressourcen finden Sie unter Stellen Sie eine Verbindung zu GitLab.com (CLI) her So erstellen Sie eine Verbindungsressource mit der CLI.
- Verwenden Sie das CreateSourceConnection Beispiel für eine Aktionskonfiguration CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server und GitLab.com GitLab selbstverwaltete Aktionen unter, um Ihre Aktion hinzuzufügen, wie unter gezeigtErstellen einer Pipeline (CLI).

Anmerkung

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

Anmerkung

Indem Sie diese Verbindungsinstallation in autorisieren GitLab.com, gewähren Sie unserem Dienst die Erlaubnis, Ihre Daten zu verarbeiten, indem Sie auf Ihr Konto zugreifen. Sie können die Berechtigungen jederzeit widerrufen, indem Sie die Anwendung deinstallieren.

Bevor Sie beginnen:

Sie müssen bereits ein Konto bei erstellt haben. GitLab.com

Anmerkung
Verbindungen bieten nur Zugriff auf Repositorys, die dem Konto gehören, das zum Erstellen und Autorisieren der Verbindung verwendet wurde.

Anmerkung
Sie können Verbindungen zu einem Repository herstellen GitLab, in dem Sie die Eigentümerrolle haben, und dann kann die Verbindung mit dem Repository mit Ressourcen wie verwendet werden CodePipeline. Bei Repositorys in Gruppen müssen Sie nicht der Gruppenbesitzer sein.
Um eine Quelle für deine Pipeline anzugeben, musst du bereits ein Repository auf gitlab.com erstellt haben.

Themen

Erstelle eine Verbindung zu GitLab.com (Konsole)
Stellen Sie eine Verbindung zu GitLab.com (CLI) her

Erstelle eine Verbindung zu GitLab.com (Konsole)

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

Um Ihre Pipeline zu erstellen oder zu bearbeiten

Melden Sie sich bei der CodePipeline Konsole an.
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 Source unter Source Provider die Option aus GitLab.
- 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 aus GitLab.
Führen Sie eine der folgenden Aktionen aus:
- Wählen Sie unter Verbindung die Option Verbinden mit aus, falls Sie noch keine Verbindung zu Ihrem Anbieter hergestellt haben GitLab. Fahren Sie mit Schritt 4 fort, um die Verbindung herzustellen.
- Wenn Sie bereits eine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie unter Verbindung die Verbindung aus. Fahren Sie mit Schritt 9 fort.
Anmerkung
Wenn Sie das Popup-Fenster schließen, bevor eine GitLab.com Verbindung hergestellt wird, müssen Sie die Seite aktualisieren.
Um eine Verbindung zu einem GitLab.com Repository herzustellen, wählen Sie unter Anbieter auswählen die Option GitLab. Geben Sie unter Connection name (Verbindungsname) den Namen für die Verbindung ein, die Sie erstellen möchten. Wählen Sie Verbinden mit GitLab.
Wenn die Anmeldeseite für GitLab.com angezeigt wird, melden Sie sich mit Ihren Anmeldeinformationen an und wählen Sie dann Anmelden.
Wenn Sie die Verbindung zum ersten Mal autorisieren, wird eine Autorisierungsseite mit einer Meldung angezeigt, in der Sie um die Autorisierung der Verbindung für den Zugriff auf Ihr GitLab.com Konto gebeten werden.

Klicken Sie auf Authorize.
Der Browser kehrt zur Seite der Verbindungskonsole zurück. Unter GitLab Verbindung erstellen wird die neue Verbindung unter Verbindungsname angezeigt.
Wählen Sie Verbinden mit GitLab.

Sie kehren zur CodePipeline Konsole zurück.

Anmerkung
Nachdem eine GitLab.com Verbindung erfolgreich hergestellt wurde, wird im Hauptfenster ein Erfolgsbanner angezeigt.
Wenn Sie sich noch nicht GitLab auf dem aktuellen Computer angemeldet haben, müssen Sie das Popup-Fenster manuell schließen.
Wählen Sie unter Repository-Name den Namen Ihres Projekts aus, GitLab indem Sie den Projektpfad mit dem Namespace angeben. Geben Sie beispielsweise für ein Repository auf Gruppenebene den Repository-Namen im folgenden Format ein:. group-name/repository-name Weitere Informationen über den Pfad und den Namespace finden Sie im path_with_namespace Feld in https://docs.gitlab.com/ee/api/projects.html #get -single-project. Weitere Hinweise zum Namespace in finden Sie unter. GitLab https://docs.gitlab.com/ee/user/namespace/

Anmerkung
Für Gruppen in GitLab müssen Sie den Projektpfad mit dem Namespace manuell angeben. Geben Sie beispielsweise für ein Repository, das myrepo in einer Gruppe benannt istmygroup, Folgendes ein:mygroup/myrepo. Den Projektpfad mit dem Namespace finden Sie in der URL unter. GitLab
Unter Pipeline-Trigger können Sie Trigger 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.
Wählen Sie unter Branch name (Name der Verzweigung die Verzweigung aus, in der die Pipeline Quelländerungen erkennen soll.

Anmerkung
Wenn der Branch-Name nicht automatisch ausgefüllt wird, haben Sie keinen Owner-Zugriff auf das Repository. Entweder ist der Projektname nicht gültig, oder die verwendete Verbindung hat keinen Zugriff auf project/repository.
Im Output artifact format (Format des Ausgabeartefakts) müssen Sie das Format für Ihre Artefakte auswählen.
- Um die Ausgabeartefakte der GitLab.com Aktion mit der Standardmethode zu speichern, wählen Sie CodePipeline Standard. Die Aktion greift auf die Dateien aus dem GitLab.com 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 nachgeschalteten Aktionen verwendet werden.
  
  Wenn Sie diese Option wählen, müssen Sie die Berechtigungen für Ihre CodeBuild Projektservice-Rolle aktualisieren, wie unter gezeigt. Füge CodeBuild GitClone Berechtigungen für Verbindungen zu Bitbucket, Enterprise Server oder hinzu GitHub GitHub GitLab.com Ein Tutorial, das Ihnen zeigt, wie Sie die Option „Vollständiger Klon“ verwenden, finden Sie unterTutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden.
Wählen Sie, ob Sie die Quellaktion speichern und fortfahren möchten.

Stellen Sie eine Verbindung zu GitLab.com (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.

So stellen Sie eine Verbindung her

Ö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 --provider-type und --connection-name für Ihre Verbindung an. In diesem Beispiel lautet der Name des Drittanbieters GitLab und der angegebene Verbindungsname MyConnection.
```
aws codestar-connections create-connection --provider-type GitLab --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-4d5d-8878-dfcab0bc441f"
}
```
Verwenden Sie die Konsole, um die Verbindung fertigzustellen. Weitere Informationen finden Sie unter Aktualisieren einer ausstehenden Verbindung.

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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

GitHub Enterprise Server-Verbindungen

Verbindungen für Selbstverwalter GitLab