GitHub Enterprise Server-Verbindungen - AWS CodePipeline
Stellen Sie eine Verbindung zu GitHub Enterprise Server (Konsole) herErstellen Sie einen Host und eine Verbindung zum GitHub Enterprise Server (CLI)

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.

GitHub Enterprise Server-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 zuzuweisen, verwenden Sie eine Verbindung.

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 (UAE), Europa (Spanien), Europa (Zürich), Israel (Tel Aviv) oder AWS GovCloud (US-West) nicht verfügbar. Hinweise zu anderen verfügbaren Aktionen finden Sie unter. Produkt- und Serviceintegrationen mit CodePipeline Überlegungen zu dieser Aktion in der Region Europa (Mailand) finden Sie in der Anmerkung unterCodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com und GitLab selbstverwaltete Aktionen.

Um eine GitHub Enterprise Server-Quellaktion hinzuzufügen CodePipeline, können Sie eine der folgenden Optionen wählen:

Anmerkung

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

Bevor Sie beginnen:

  • Sie müssen ein Konto bei GitHub Enterprise Server erstellt und die GitHub Enterprise Server-Instanz in Ihrer Infrastruktur installiert haben.

    Anmerkung

    Jeder VPC kann jeweils nur einem Host (GitHub Enterprise Server-Instanz) zugeordnet werden.

  • Sie müssen bereits ein Code-Repository mit GitHub Enterprise Server erstellt haben.

Stellen Sie eine Verbindung zu GitHub Enterprise Server (Konsole) her

Gehen Sie wie folgt vor, um mithilfe der CodePipeline Konsole eine Verbindungsaktion für Ihr GitHub Enterprise Server-Repository hinzuzufügen.

Anmerkung

GitHub Enterprise Server-Verbindungen bieten nur Zugriff auf Repositorys, die dem GitHub Enterprise Server-Konto gehören, mit dem die Verbindung hergestellt wurde.

Bevor Sie beginnen:

Für eine Hostverbindung zu GitHub Enterprise Server müssen Sie die Schritte zum Erstellen einer Hostressource für Ihre Verbindung abgeschlossen haben. Siehe Hosts für Verbindungen 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 abzuschließen, und wählen Sie Weiter. Wählen Sie auf der Seite Quelle unter Quellanbieter die Option GitHub Enterprise Server aus.

    • Wählen Sie, ob Sie eine bestehende Pipeline bearbeiten möchten. Wählen Sie Bearbeiten und dann Phase bearbeiten aus. 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 GitHub Enterprise Server aus.

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

    • Wenn Sie noch keine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie unter Verbindung die Option Connect to GitHub Enterprise Server aus. Fahren Sie mit Schritt 2 fort: Verbindung zum GitHub Enterprise Server herstellen.

    • Wenn Sie unter Verbindung bereits eine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie die Verbindung aus. Fahren Sie mit Schritt 3 fort: Speichern Sie die Quellaktion für Ihre Verbindung.

Stellen Sie eine Verbindung zu GitHub Enterprise Server her

Nachdem Sie sich entschieden haben, die Verbindung herzustellen, wird die Seite Connect to GitHub Enterprise Server angezeigt.

Wichtig

AWS CodeConnections unterstützt GitHub Enterprise Server Version 2.22.0 aufgrund eines bekannten Problems in der Version nicht. Um eine Verbindung zu erstellen, aktualisieren Sie auf Version 2.22.1 bzw. die neueste verfügbare Version.

Um eine Verbindung zu Enterprise Server herzustellen GitHub

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

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

    Anmerkung

    Wenn der bereitgestellte URL Wert bereits verwendet wurde, um einen GitHub Enterprise Server für eine Verbindung einzurichten, werden Sie aufgefordert, die Hostressource auszuwählenARN, die zuvor für diesen Endpunkt erstellt wurde.

  3. Wenn Sie Ihren Server in einem Amazon gestartet haben VPC und eine Verbindung zu Ihrem herstellen möchtenVPC, wählen Sie Use a VPC und gehen Sie wie folgt vor.

    1. Wählen Sie unter VPCID Ihre VPC ID aus. Stellen Sie sicher, dass Sie die VPC für die Infrastruktur wählen, in der Ihre GitHub Enterprise Server-Instanz installiert ist, oder eine VPC mit Zugriff auf Ihre GitHub Enterprise Server-Instanz über VPN oder Direct Connect.

    2. Wählen Sie unter Subnetz-ID (Subnetz-ID) die Option Add (Hinzufügen) aus. Wählen Sie im Feld die Subnetz-ID aus, die Sie für Ihren Host verwenden möchten. Sie können bis zu 10 Subnetze wählen.

      Stellen Sie sicher, dass Sie das Subnetz für die Infrastruktur auswählen, in der Ihre GitHub Enterprise Server-Instanz installiert ist, oder ein Subnetz mit Zugriff auf Ihre installierte GitHub Enterprise Server-Instanz über VPN oder Direct Connect.

    3. Wählen Sie unter Sicherheitsgruppe die Option IDs Hinzufügen aus. Wählen Sie im Feld die Sicherheitsgruppe aus, die Sie für Ihren Host verwenden möchten. Sie können bis zu 10 Sicherheitsgruppen auswählen.

      Stellen Sie sicher, dass Sie die Sicherheitsgruppe für die Infrastruktur auswählen, in der Ihre GitHub Enterprise Server-Instanz installiert ist, oder eine Sicherheitsgruppe mit Zugriff auf Ihre installierte GitHub Enterprise Server-Instanz über VPN oder Direct Connect.

    4. Wenn Sie eine private Instanz VPC konfiguriert haben und Ihre GitHub Enterprise Server-Instanz so konfiguriert haben, dass sie die TLS Validierung mithilfe einer nicht öffentlichen Zertifizierungsstelle durchführt, geben Sie im Feld TLSZertifikat Ihre Zertifikat-ID ein. Der Wert des TLS Zertifikats sollte der öffentliche Schlüssel des Zertifikats sein.

      Screenshot der Konsole, auf der die Seite „ GitHub Enterprise Server-Verbindung erstellen“ mit VPC Optionen angezeigt wird.

  4. Wählen Sie Connect to GitHub Enterprise Server. 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 URL wird der verwendet.

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

  6. Wenn Sie dazu aufgefordert werden, melden Sie sich auf der GitHub Enterprise-Anmeldeseite mit Ihren GitHub Enterprise-Anmeldeinformationen an.

  7. Wählen Sie auf der Seite „ GitHub App erstellen“ einen Namen für Ihre App aus.

  8. <app-name>Wählen Sie auf der GitHub Autorisierungsseite die Option Autorisieren aus.

  9. Auf der App-Installationsseite wird in einer Meldung angezeigt, dass die Connector-App zur Installation bereit ist. Wenn Sie mehrere Organisationen haben, werden Sie möglicherweise aufgefordert, die Organisation auszuwählen, in der Sie die App installieren möchten.

    Wählen Sie in die Repository-Einstellungen aus, wo Sie die App installieren möchten. Wählen Sie Installieren aus.

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

Schritt 3: Speichern Sie Ihre GitHub Enterprise Server-Quellaktion

Verwenden Sie diese Schritte auf dem Assistenten oder auf der Aktionsseite „Aktion bearbeiten“, 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 mit Triggern finden Sie unterTrigger für Code-Push- oder Pull-Anfragen filtern.

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

    • Um Ausgabeartefakte aus der GitHub Enterprise Server-Aktion mit der Standardmethode zu speichern, wählen Sie CodePipelineStandard. Die Aktion greift auf die Dateien aus dem GitHub Enterprise Server-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, sodass nachgelagerte Aktionen Git-Befehle direkt ausführen können, wählen Sie Vollständiger Klon. Diese Option kann nur von CodeBuild Downstream-Aktionen verwendet werden.

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

Erstellen Sie einen Host und eine Verbindung zum GitHub Enterprise Server (CLI)

Sie können das 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 dem CLI Oder hergestellt haben AWS CloudFormation, bearbeiten Sie die Verbindung in der Konsole, um ihren Status festzulegenAVAILABLE.

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

Anmerkung

Sie erstellen einen Host nur einmal pro GitHub Enterprise Server-Konto. Alle Ihre Verbindungen zu einem bestimmten GitHub Enterprise Server-Konto verwenden denselben Host.

Sie verwenden Sie einen Host, der den Endpunkt für die Infrastruktur darstellt, in der der Drittanbieter installiert ist. Nachdem Sie die Hosterstellung mit dem abgeschlossen habenCLI, 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 dem erstellt habenCLI, verwenden Sie die Konsole oder die, CLI um den Host so einzurichten, dass er seinen Status festlegtAvailable.

Einen Host erstellen

  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 --name--provider-type, und --provider-endpoint für Ihre Verbindung an. In diesem Beispiel lautet der Name des Drittanbieters GitHubEnterpriseServer und der Endpunkt my-instance.dev.

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

    Bei Erfolg gibt dieser Befehl die Amazon Resource Name (ARN) -Hostinformationen zurück, die den folgenden ähneln.

    {
    "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 GitHub Enterprise Server 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 --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

    Bei Erfolg gibt dieser Befehl ARN Verbindungsinformationen zurück, die den folgenden ähneln.

    {
    "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 der Code an das Quell-Repository der Verbindung weitergeleitet wird. Gehen Sie wie folgt vor, um die Pipeline-Trigger-Konfiguration für die manuelle Veröffentlichung oder für Git-Tags zu konfigurieren:

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

      "DetectChanges": "false",

    • Weitere Informationen zur Konfiguration der Pipeline-Trigger zum Filtern mit Triggern finden Sie unterTrigger für Code-Push- oder Pull-Anfragen filtern. Im Folgenden wird beispielsweise die Pipeline-Ebene der JSON Pipeline-Definition erweitert. In diesem Beispiel release-v1 sind release-v0 und die Git-Tags, die eingeschlossen werden sollen, und release-v2 ist das Git-Tag, das ausgeschlossen werden soll.

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