GitHub Verbindungen

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 Quellseite unter Quellanbieter die Option GitHub (Version 2) 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 (Version 2) 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 aus GitHub. Fahren Sie mit Schritt 2 fort: Verbindung herstellen zu GitHub.

   • 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.

Um eine Verbindung herzustellen zu GitHub

1. Unter GitHub Verbindungseinstellungen wird Ihr Verbindungsname unter Verbindungsname angezeigt. Wählen Sie Connect GitHub. Die Seite für die Zugriffsanforderung wird angezeigt.

2. Wählen Sie AWS Connector autorisieren für GitHub. Auf der Verbindungsseite wird das Feld GitHub Apps angezeigt und angezeigt.

   

3. Wählen Sie unter GitHub Apps eine App-Installation aus oder wählen Sie Neue App installieren, um eine zu erstellen.

   Sie installieren eine App für alle Verbindungen mit einem bestimmten Anbieter. Wenn Sie den AWS Connector für GitHub App bereits installiert haben, wählen Sie ihn aus und überspringen Sie diesen Schritt.

   Anmerkung

   Wenn Sie ein Benutzerzugriffstoken erstellen möchten, stellen Sie sicher, dass Sie den AWS Connector für die GitHub App bereits installiert haben, und lassen Sie dann das Feld App-Installation leer. CodeConnections verwendet das Benutzerzugriffstoken für die Verbindung.

4. Wählen Sie auf der GitHub Seite AWS Connector installieren für das Konto aus, in dem Sie die App installieren möchten.

   Anmerkung

   Sie installieren die App nur einmal für jedes GitHub Konto. Wenn Sie die App schon einmal installiert haben, können Sie Configure (Konfiguration) wählen und mit einer Änderungsseite für die App-Installation fortfahren. Alternativ kommen Sie über die Schaltfläche „Back“ (Zurück) zur Konsole zurück.

5. Behalten Sie auf der GitHub Seite „ AWS Connector installieren für“ die Standardeinstellungen bei und wählen Sie Installieren aus.

6. Auf der GitHub Seite Connect wird die Verbindungs-ID für Ihre neue Installation unter GitHub Apps angezeigt. Wählen Sie Connect aus.

Um Ihre GitHub Quellaktion 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 die Ausgabeartefakte der GitHub Aktion mit der Standardmethode zu speichern, wählen Sie CodePipeline Standard. Die Aktion greift auf die Dateien aus dem GitHub 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.

     Wenn Sie diese Option wählen, müssen Sie die Berechtigungen für Ihre CodeBuild Projektservice-Rolle aktualisieren, wie unter beschriebenFügen Sie CodeBuild GitClone Berechtigungen für Verbindungen zu Bitbucket, Enterprise Server oder .com GitHub hinzu GitHub GitLab. Ein Tutorial, das Ihnen zeigt, wie Sie die Option Vollständiges Klonen verwenden, finden Sie unterTutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden.

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

So stellen Sie eine Verbindung her

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 --provider-type und --connection-name für Ihre Verbindung an. In diesem Beispiel lautet der Name des Drittanbieters GitHub und der angegebene Verbindungsname MyConnection.

   aws codestar-connections create-connection --provider-type GitHub --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-4d5d-8878-dfcab0bc441f"
   }

2. Verwenden Sie die Konsole, um die Verbindung fertigzustellen. Weitere Informationen finden Sie unter Aktualisieren einer ausstehenden Verbindung.

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