View a markdown version of this page

Aktualisieren Sie eine Quellaktion GitHub (über die OAuth-App) auf eine Quellaktion GitHub (über die GitHub App) - AWS CodePipeline
Schritt 1: Ersetzen Sie Ihre Aktion (über die OAuth-App) GitHubSchritt 2: Erstellen Sie eine Verbindung zu GitHubSchritt 3: Speichern Sie Ihre GitHub Quellaktion

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.

Aktualisieren Sie eine Quellaktion GitHub (über die OAuth-App) auf eine Quellaktion GitHub (über die GitHub App)

AWS CodePipeline In gibt es zwei unterstützte Versionen der GitHub Quellaktion:

  • Empfohlen: Die Aktion GitHub (via GitHub App) verwendet eine GitHub App-basierte Authentifizierung, die von einer CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server und GitLab.com GitLab selbstverwaltete Aktionen Ressource unterstützt wird. Sie installiert eine AWS CodeStar Connections-Anwendung in Ihrer GitHub Organisation, sodass Sie den Zugriff darin verwalten können. GitHub

  • Nicht empfohlen: Die Aktion GitHub (über die OAuth-App) verwendet OAuth-Token zur Authentifizierung GitHub und verwendet einen separaten Webhook, um Änderungen zu erkennen. Dies ist nicht mehr die empfohlene Methode.

Anmerkung

Verbindungen sind 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. Weitere verfügbare 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.

Die Verwendung der Aktion GitHub (über GitHub App) anstelle der Aktion (über die GitHub OAuth-App) bietet einige wichtige Vorteile:

  • Bei Verbindungen sind CodePipeline keine OAuth-Apps oder persönlichen Zugriffstoken mehr erforderlich, um auf dein Repository zuzugreifen. Wenn du eine Verbindung herstellst, installierst du eine GitHub App, die die Authentifizierung für dein GitHub Repository verwaltet und Berechtigungen auf Organisationsebene gewährt. Du musst OAuth-Tokens als Benutzer autorisieren, um auf das Repository zuzugreifen. Weitere Hinweise zum OAuth-based GitHub Zugriff im Gegensatz zum Zugriff finden Sie App-based GitHub unter. https://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps

  • Wenn Sie Aktionen GitHub (per GitHub App) in der CLI oder verwalten CloudFormation, müssen Sie Ihr persönliches Zugriffstoken nicht mehr als geheim in Secrets Manager speichern. Sie müssen in Ihrer CodePipeline Aktionskonfiguration nicht mehr dynamisch auf das gespeicherte Geheimnis verweisen. Stattdessen fügen Sie den Verbindungs-ARN zu Ihrer Aktionskonfiguration hinzu. Ein Beispiel für eine Aktionskonfiguration finden Sie unterCodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server und GitLab.com GitLab selbstverwaltete Aktionen.

  • Wenn du eine Verbindungsressource erstellst, die du zusammen mit deiner Aktion GitHub (per GitHub App) verwenden möchtest CodePipeline, kannst du dieselbe Verbindungsressource verwenden, um andere unterstützte Dienste, wie CodeGuru Reviewer, mit deinem Repository zu verknüpfen.

  • In GitHub (via GitHub App) kannst du Repositorys klonen, um in nachfolgenden CodeBuild Aktionen auf Git-Metadaten zuzugreifen, während du in GitHub (über die OAuth-App) nur die Quelle herunterladen kannst.

  • Ein Administrator installiert die App für die Repositorys Ihrer Organisation. Sie müssen OAuth-Token nicht mehr nachverfolgen, die von der Person abhängen, die das Token erstellt hat.

Alle in einer Organisation installierten Apps haben Zugriff auf dieselben Repositorys. Um zu ändern, wer auf jedes Repository zugreifen kann, ändern Sie die IAM-Richtlinie für jede Verbindung. Ein Beispiel finden Sie unter Beispiel: Eine Scoped-Down-Richtlinie für die Verwendung von Verbindungen mit einem bestimmten Repository.

Sie können die Schritte in diesem Thema verwenden, um Ihre Quellaktion GitHub (über die OAuth-App) zu löschen und eine Quellaktion GitHub (über die GitHub App) aus der Konsole hinzuzufügen. CodePipeline

Schritt 1: Ersetzen Sie Ihre Aktion (über die OAuth-App) GitHub

Verwenden Sie die Pipeline-Bearbeitungsseite, um Ihre Aktion (über die OAuth-App) durch eine GitHub Aktion GitHub (über GitHub die App) zu ersetzen.

Um Ihre Aktion (über die OAuth-App) zu ersetzen GitHub

  1. Loggen Sie sich in die CodePipeline Konsole ein.

  2. Wählen Sie Ihre Pipeline aus und klicken Sie auf Bearbeiten. Wählen Sie auf Ihrer Quellstufe Stufe bearbeiten aus. Es wird eine Meldung angezeigt, in der empfohlen wird, Ihre Aktion zu aktualisieren.

  3. Wählen Sie unter Aktionsanbieter die Option GitHub (über GitHub App) aus.

  4. 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 GitHub. Fahren Sie mit Schritt 2 fort: Erstellen Sie eine Verbindung zu GitHub.

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

Schritt 2: Erstellen Sie eine Verbindung zu GitHub

Nachdem Sie sich entschieden haben, die Verbindung herzustellen, wird die GitHub Seite Verbinden mit angezeigt.

Um eine Verbindung herzustellen zu GitHub

  1. Unter GitHub Verbindungseinstellungen wird Ihr Verbindungsname im Feld Verbindungsname angezeigt.

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

    Anmerkung

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

  2. Wenn die Autorisierungsseite für GitHub angezeigt wird, melden Sie sich mit Ihren Anmeldeinformationen an und wählen Sie dann, um fortzufahren.

  3. Auf der App-Installationsseite wird eine Meldung angezeigt, dass die AWS CodeStar App versucht, eine Verbindung zu Ihrem GitHub Konto herzustellen.

    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.

  4. Wählen Sie auf der AWS CodeStar Seite „Installieren“ die Option „Installieren“.

  5. Auf der GitHub Seite Verbinden mit wird die Verbindungs-ID für Ihre neue Installation angezeigt. Wählen Sie Connect aus.

Schritt 3: Speichern Sie Ihre GitHub Quellaktion

Vervollständigen Sie Ihre Aktualisierungen auf der Seite „Aktion bearbeiten“, um Ihre neue Quellaktion zu speichern.

Um Ihre GitHub Quellaktion zu speichern

  1. Geben Sie unter Repository den Namen Ihres Drittanbieter-Repositorys ein. Geben Sie im Feld Branch den Branch ein, in dem Ihre Pipeline Quelländerungen erkennen soll.

    Anmerkung

    Geben Sie im Feld Repository Folgendes ein, owner-name/repository-name wie in diesem Beispiel gezeigt: 

    my-account/my-repository

  2. Wählen Sie im Ausgabe-Artefaktformat das Format für Ihre Artefakte aus.

  3. Unter Ausgabeartefakte können Sie den Namen des Ausgabe-Artefakts für diese Aktion beibehalten, z. B. SourceArtifact Wählen Sie Fertig, um die Seite „Aktion bearbeiten“ zu schließen.

  4. Wählen Sie „Fertig“, um die Seite zur Bearbeitung der Phase zu schließen. Wählen Sie Speichern, um die Seite zur Bearbeitung der Pipeline zu schließen.