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.
Sie können die GitHub App verwenden, um eine Verbindung herzustellen CodeBuild. GitHub App-Verbindungen werden unterstützt durch AWS CodeConnections.
Der Quellanbieterzugriff ermöglicht es Ihnen, einen Build auszulösen CreateWebhook, indem Sie die GitHub Webhook-Ereignisse Nutzung von oder die Verwendung Tutorial: Einen CodeBuild -gehosteten GitHub Actions-Runner konfigurieren in CodeBuild abonnieren.
Anmerkung
CodeConnections ist in weniger Regionen verfügbar als CodeBuild. Sie können regionsübergreifende Verbindungen in CodeBuild verwenden. Verbindungen, die in Opt-in-Regionen erstellt wurden, können in anderen Regionen nicht verwendet werden. Weitere Informationen finden Sie unter AWS CodeConnections Endpunkte und -Kontingente.
Themen
Schritt 1: Stellen Sie eine Verbindung zur GitHub App (Konsole) her
Gehen Sie wie folgt vor, um CodeBuild über die Konsole eine Verbindung für Ihr Projekt in hinzuzufügen GitHub.
Um eine Verbindung herzustellen zu GitHub
-
Folgen Sie den Anweisungen im Developer Tools-Benutzerhandbuch für Herstellen einer Verbindung zu GitHub.
Schritt 2: Gewähren Sie der CodeBuild IAM Projektrolle Zugriff, um die Verbindung zu verwenden
Sie können Zugriff auf CodeBuild IAM Projektrollen gewähren, um die über Ihre Verbindung angebotenen GitHub Token zu verwenden.
Um Zugriff auf CodeBuild IAM Projektrollen zu gewähren
-
Erstellen Sie eine IAM Rolle für Ihr CodeBuild Projekt, indem Sie den Anweisungen Erlaube CodeBuild die Interaktion mit anderen AWS Diensten für Ihr CodeBuild Projekt folgen.
-
Folgen Sie den Anweisungen und fügen Sie Ihrer CodeBuild Projektrolle die folgende IAM Richtlinie hinzu, um Zugriff auf die Verbindung zu gewähren.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "codeconnections:GetConnectionToken", "codeconnections:GetConnection" ], "Resource": [
<connection-arn>
] } ] }
Schritt 3: Konfigurieren Sie CodeBuild , um die neue Verbindung zu verwenden
Sie können eine Verbindung als Anmeldeinformationen auf Kontoebene konfigurieren und sie in einem Projekt verwenden.
Um eine Verbindung als Anmeldeinformationen auf Kontoebene zu konfigurieren, finden Sie im AWS Management Console
-
Wählen Sie als Quellanbieter die Option GitHub.
-
Führen Sie für Credential einen der folgenden Schritte aus:
-
Wählen Sie Standard-Quellanmeldedaten, um die Standard-Quellanmeldedaten Ihres Kontos für alle Projekte zu verwenden.
-
Wenn Sie nicht verbunden sind GitHub, wählen Sie Standard-Quellanmeldedaten verwalten aus.
-
Wählen Sie als Anmeldeinformationstyp die Option App ausGitHub .
-
Wählen Sie unter Verbindung aus, ob Sie eine bestehende Verbindung verwenden oder eine neue Verbindung erstellen möchten.
-
-
Wählen Sie Benutzerdefinierte Quellanmeldedaten, um benutzerdefinierte Quellanmeldedaten zu verwenden, um die Standardeinstellungen Ihres Kontos zu überschreiben.
-
Wählen Sie als Anmeldeinformationstyp die Option App aus. GitHub
-
Wählen Sie unter Verbindung aus, ob Sie eine bestehende Verbindung verwenden oder eine neue Verbindung erstellen möchten.
-
-
Sie können auch mehrere Token für Ihre CodeBuild Projekte einrichten. Weitere Informationen finden Sie unter Konfigurieren Sie mehrere Token als Anmeldeinformationen auf Quellenebene.
Behebung von Problemen mit der GitHub App
Die folgenden Informationen können Ihnen helfen, häufig auftretende Probleme mit der GitHub App zu beheben.
Themen
Installieren Sie den AWS Connector für die GitHub App in einer unerwünschten Region
Problem: Sie haben den AWS Connector für GitHub vom GitHub Marketplace aus installiert, aber die Verbindung wurde in einer unerwünschten Region hergestellt. Wenn Sie versuchen, die App auf der GitHub Website neu zu konfigurieren, funktioniert dies nicht, da die App bereits in Ihrem GitHub Konto installiert ist.
Mögliche Ursache: Die App ist bereits in Ihrem GitHub Konto installiert, sodass Sie nur die App-Berechtigungen neu konfigurieren können.
Empfohlene Lösung: Sie können eine neue Verbindung mit der Installations-ID in der gewünschten Region erstellen.
-
Öffnen Sie die CodeConnections Konsole unter https://console.aws.amazon.com/codesuite/settings/connections
und navigieren Sie mithilfe der Regionsauswahl in der Navigationsleiste der Konsole zur gewünschten Region. AWS -
Folgen Sie den Anweisungen im Developer Tools-Benutzerhandbuch für Create a connection to. GitHub
Anmerkung
Da Sie den AWS Connector für die GitHub App bereits installiert haben, können Sie ihn auswählen, anstatt eine neue App zu installieren.
Die GitHub App-Verbindung hat keinen Zugriff auf Repositorys
Problem: Ein AWS Dienst, der die Verbindung verwendet, wie zum Beispiel CodeBuild oder CodePipeline, meldet, dass er keinen Zugriff auf das Repository hat oder dass das Repository nicht existiert. Zu den möglichen Fehlermeldungen gehören:
-
Authentication required for primary source.
-
Unable to create webhook at this time. Please try again later.
-
Failed to create webhook. GitHub API limit reached. Please try again later.
- Mögliche Ursache: Möglicherweise haben Sie die GitHub App verwendet und dem Webhook-Berechtigungsbereich nicht gewährt.
-
Empfohlene Lösung: Um den erforderlichen Berechtigungsbereich zu gewähren, folgen Sie den Anweisungen unter Navigieren zu der GitHub App, die Sie überprüfen oder ändern möchten, um
die installierte App zu konfigurieren. Im Abschnitt „Berechtigungen“ siehst du, dass die App nicht über Webhooks-Berechtigungen verfügt, und es gibt eine Option, mit der du die neu angeforderten Berechtigungen überprüfen kannst. Überprüfe und akzeptiere die neuen Berechtigungen. Weitere Informationen finden Sie unter Genehmigen aktualisierter Berechtigungen für eine App. GitHub - Mögliche Ursache: Die Verbindung funktionierte wie erwartet, hat aber plötzlich keinen Zugriff mehr auf die Repositorys.
-
Mögliche Lösung: Überprüfe zunächst deine Autorisierungen
und deine Installationen und stelle dann sicher, dass die GitHub App autorisiert und installiert ist. Wenn die GitHub App-Installation unterbrochen ist, müssen Sie sie wieder aufheben. Wenn die GitHub App nicht für eine Verbindung UAT(Benutzerzugriffstoken) autorisiert oder nicht für eine Verbindung IAT(Installationszugriffstoken) installiert ist, kann die bestehende Verbindung nicht mehr verwendet werden und Sie müssen eine neue Verbindung erstellen. Beachten Sie, dass durch eine Neuinstallation der GitHub App die vorherige Verbindung, die mit der alten Installation verknüpft war, nicht wiederhergestellt wird. Mögliche Lösung: Wenn es sich bei der Verbindung um eine UAT Verbindung handelt, stellen Sie sicher, dass die Verbindung nicht gleichzeitig verwendet wird, z. B. wenn sie in mehreren CodeBuild gleichzeitigen Build-Läufen verwendet wird. Dies liegt daran, dass ein zuvor ausgegebenes Token GitHub sofort ungültig wird, UAT wenn ein ablaufendes Token durch die Verbindung aktualisiert wird. Wenn Sie die UAT Verbindung für mehrere gleichzeitige CodeBuild Builds verwenden müssen, können Sie mehrere Verbindungen erstellen und jede Verbindung unabhängig voneinander verwenden.
Mögliche Lösung: Wenn die UAT Verbindung in den letzten 6 Monaten nicht verwendet wurde, wird die Verbindung von ungültig. GitHub Um dieses Problem zu beheben, erstellen Sie eine neue Verbindung.
- Mögliche Ursache: Möglicherweise haben Sie eine UAT Verbindung verwendet, ohne die App zu installieren.
-
Empfohlene Lösung: Um eine UAT Verbindung herzustellen, muss die Verbindung zwar nicht mit einer GitHub App-Installation verknüpft werden, es ist jedoch eine Installation erforderlich, damit auf das Repository zugegriffen werden kann. Folgen Sie den Anweisungen zur Überprüfung der Installationen
, um sicherzustellen, dass die GitHub App installiert ist. Wenn sie nicht installiert ist, navigieren Sie zur Seite der GitHub App , um die App zu installieren. Weitere Informationen zum Zugriff finden Sie unter Über Benutzerzugriffstoken . UAT
Für die IAM Rolle des AWS Dienstes fehlen die erforderlichen IAM Berechtigungen.
Problem: Es wird eine der folgenden Fehlermeldungen angezeigt:
-
Access denied to connection
<connection-arn>
-
Failed to get access token from
<connection-arn>
Empfohlene Lösung: In der Regel verwenden Sie eine Verbindung mit einem AWS Dienst, z. B. CodePipeline oder CodeBuild. Wenn Sie dem AWS Dienst eine IAM Rolle zuweisen, kann der AWS Dienst die Erlaubnis der Rolle verwenden, um in Ihrem Namen zu handeln. Stellen Sie sicher, dass die IAM Rolle über die erforderlichen Berechtigungen verfügt. Weitere Informationen zu den erforderlichen IAM Berechtigungen finden Sie unter Gewähren von Zugriff auf CodeBuild IAM Projektrollen zur Nutzung der Verbindung und Identitäts- und Zugriffsverwaltung für AWS CodeStar Benachrichtigungen sowie CodeConnections im Benutzerhandbuch der Developer Tools Console.