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 GitHub (über OAuth App) Quellaktion auf eine GitHub (über GitHub App) Quellaktion
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, GitLab .com und GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md) 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 (per 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](integrations.md) Überlegungen zu dieser Aktion in der Region Europa (Mailand) finden Sie in der Anmerkung unter[CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com und GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md).
Die Verwendung der Aktion GitHub (per GitHub App) anstelle der Aktion GitHub (per OAuth App) bietet einige wichtige Vorteile:
+ Bei Verbindungen sind CodePipeline keine OAuth Apps oder persönlichen Zugriffstoken mehr erforderlich, um auf Ihr 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. Sie müssen OAuth Token als Benutzer autorisieren, um auf das Repository zuzugreifen. Weitere Informationen zum OAuth basierten GitHub Zugriff im Gegensatz zum App-basierten GitHub Zugriff finden Sie unter. [https://docs.github.com/en/developers/apps/differences-between-github-apps-and-oauth-apps](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 unter[CodeStarSourceConnection für Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com und GitLab selbstverwaltete Aktionen](action-reference-CodestarConnectionSource.md).
+ 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 (per OAuth App) nur die Quelle herunterladen kannst.
+ Ein Administrator installiert die App für die Repositorys deiner Organisation. Sie müssen keine OAuth Tokens 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](https://docs.aws.amazon.com/dtconsole/latest/userguide/security_iam_id-based-policy-examples-connections.html#security_iam_id-based-policy-examples-connections-reposcope).
Sie können die Schritte in diesem Thema verwenden, um Ihre Quellaktion GitHub (per OAuth App) zu löschen und eine GitHub (über GitHub App) Quellaktion von der Konsole aus hinzuzufügen. CodePipeline
**Topics**
+ [Schritt 1: Ersetzen Sie Ihre GitHub Aktion (per OAuth App)](#connections-pipelines-github-action)
+ [Schritt 2: Stellen Sie eine Verbindung her zu GitHub](#connections-pipelines-github-create)
+ [Schritt 3: Speichern Sie Ihre GitHub Quellaktion](#connections-pipelines-github-save)
## Schritt 1: Ersetzen Sie Ihre GitHub Aktion (per OAuth App)
Verwenden Sie die Pipeline-Bearbeitungsseite, um Ihre Aktion (per OAuth App) durch eine GitHub Aktion GitHub (per GitHub App) zu ersetzen.
**Um deine GitHub Aktion (per OAuth App) zu ersetzen**
1. Melden Sie sich bei der CodePipeline Konsole an.
1. 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.
1. Wählen Sie **unter Aktionsanbieter** die Option **GitHub (über GitHub App)** aus.
1. 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.
1. 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.
1. 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.
1. Wählen Sie auf der ** AWS CodeStar Installationsseite** die Option **Installieren** aus.
1. 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
```
1. Wählen Sie unter **Ausgabeartefaktformat** das Format für Ihre Artefakte aus.
+ 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, 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 beschrieben. [Fügen Sie CodeBuild GitClone Berechtigungen für Verbindungen zu Bitbucket, Enterprise Server oder .com GitHub hinzu GitHub GitLab](troubleshooting.md#codebuild-role-connections) Ein Tutorial, das Ihnen zeigt, wie Sie die Option **Vollständiges Klonen** verwenden, finden Sie unter[Tutorial: Vollständigen Klon mit einer GitHub Pipeline-Quelle verwenden](tutorials-github-gitclone.md).
1. 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.
1. 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.