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: Stellen Sie eine Verbindung her 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 die auf der Github-App basierende 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 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. 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 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 für den Zugriff auf Ihr Repository CodePipeline keine OAuth-Apps oder persönlichen Zugriffstoken mehr erforderlich. Wenn Sie eine Verbindung herstellen, installieren Sie eine GitHub App, die die Authentifizierung für Ihr GitHub Repository verwaltet und Berechtigungen auf Organisationsebene gewährt. Sie müssen OAuth-Token als Benutzer autorisieren, um auf das Repository zuzugreifen. Weitere Informationen 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 GitHub (per GitHub App) Aktionen in der CLI oder verwalten CloudFormation, müssen Sie Ihr persönliches Zugriffstoken nicht mehr als Geheimnis 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 Sie eine Verbindungsressource erstellen, die Sie mit Ihrer Aktion GitHub (über GitHub App) in verwenden möchten CodePipeline, können Sie dieselbe Verbindungsressource verwenden, um Ihrem Repository andere unterstützte Dienste wie CodeGuru Reviewer zuzuordnen.

  • In Github (über GitHub App) kannst du Repositorys klonen, um bei 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 keine OAuth-Token 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 nach unten abgegrenzte 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 GitHub (über GitHub App) Quellaktion von der Konsole aus 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. Melden Sie sich bei der Konsole an CodePipeline .

  2. Wählen Sie Ihre Pipeline und dann Bearbeiten aus. Wählen Sie in Ihrer Quellstufe die Option Phase 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:

    • 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 bereits eine Verbindung zu Ihrem Anbieter hergestellt haben, wählen Sie unter Verbindung die Verbindung aus. Fahren Sie mit Schritt 3 fort: Speichern Sie die Quellaktion für Ihre Verbindung.

Schritt 2: Stellen Sie eine Verbindung her zu GitHub

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

Um eine Verbindung herzustellen zu GitHub

  1. Unter GitHub Verbindungseinstellungen wird Ihr Verbindungsname unter Verbindungsname angezeigt.

    Wählen Sie unter GitHub Apps eine App-Installation aus oder wählen Sie 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, ob Sie fortfahren möchten.

  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 Connect 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 owner-name/repository-name wie in diesem Beispiel gezeigt ein: 

    my-account/my-repository

  2. Wählen Sie unter Ausgabeartefaktformat das Format für Ihre Artefakte aus.

  3. Unter Ausgabeartefakte können Sie den Namen des Ausgabeartefakts für diese Aktion beibehalten, z. B. SourceArtifact Wählen Sie Fertig, um die Aktionsseite 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.