App Runner-Verbindungen verwalten

Wenn Sie einen Service in erstellen AWS App Runner, konfigurieren Sie eine Anwendungsquelle — ein Container-Image oder ein Quell-Repository, das bei einem Anbieter gespeichert ist. App Runner muss eine authentifizierte und autorisierte Verbindung mit dem Anbieter herstellen. Dann kann App Runner Ihr Repository lesen und es für Ihren Dienst bereitstellen. App Runner erfordert keinen Verbindungsaufbau, wenn Sie einen Dienst erstellen, der auf den in Ihrem AWS-Konto gespeicherten Code zugreift.

App Runner verwaltet Verbindungsinformationen in einer Ressource, die als Verbindung bezeichnet wird. In der App Runner-Konsole und in diesem Handbuch werden Verbindungen auch als verbundene Konten bezeichnet. App Runner benötigt eine Verbindungsressource, wenn Sie einen Dienst erstellen, der Verbindungsinformationen von Drittanbietern benötigt. Im Folgenden finden Sie einige wichtige Informationen zu Verbindungen:

• Anbieter — App Runner benötigt derzeit Verbindungsressourcen mit GitHuboder Bitbucket.

• Geteilt — Du kannst eine Verbindungsressource verwenden, um mehrere App Runner-Dienste zu erstellen, die dasselbe Repository-Anbieter-Konto verwenden.

• Ressourcenverwaltung — In App Runner können Sie Verbindungen erstellen und löschen. Sie können eine bestehende Verbindung jedoch nicht ändern.

• Ressourcenkontingent — Verbindungsressourcen haben ein festgelegtes Kontingent, das AWS-Konto jeweils Ihrem entspricht AWS-Region. Wenn Sie dieses Kontingent erreichen, müssen Sie möglicherweise eine Verbindung löschen, bevor Sie eine Verbindung zu einem neuen Anbieterkonto herstellen können. Sie können eine Verbindung mithilfe der App Runner-Konsole oder der API löschen, wie im folgenden Abschnitt beschriebenVerbindungen verwalten. Weitere Informationen finden Sie unter App Runner-Ressourcenkontingente.

Verbindungen verwalten

Verwalte deine App Runner-Verbindungen mit einer der folgenden Methoden:

App Runner console

Wenn Sie die App Runner-Konsole verwenden, um einen Dienst zu erstellen, geben Sie Verbindungsdetails an. Sie müssen nicht explizit eine Verbindungsressource erstellen. In der Konsole kannst du wählen, ob du dich mit einem GitHub oder einem Bitbucket-Konto, mit dem du zuvor verbunden warst, oder mit einem neuen Konto verbinden möchtest. Bei Bedarf erstellt App Runner eine Verbindungsressource für dich. Für eine neue Verbindung verlangen einige Anbieter, dass Sie einen Authentifizierungs-Handshake durchführen, bevor Sie die Verbindung verwenden können. Die Konsole führt Sie durch diesen Vorgang.

Die Konsole verfügt auch über eine Seite zur Verwaltung Ihrer bestehenden Verbindungen. Sie können den Authentifizierungs-Handshake für eine Verbindung abschließen, wenn Sie ihn bei der Erstellung Ihres Dienstes nicht getan haben. Sie können auch Verbindungen löschen, die Sie nicht mehr verwenden. Das folgende Verfahren zeigt, wie Sie Verbindungen mit Repository-Anbietern verwalten können.

Um Verbindungen in Ihrem Konto zu verwalten

1. Öffnen Sie die App Runner-Konsole und wählen Sie in der Liste der Regionen Ihre aus AWS-Region.

2. Wählen Sie im Navigationsbereich Verbundene Konten aus.

   In der Konsole wird dann eine Liste der Repository-Provider-Verbindungen in Ihrem Konto angezeigt.

   

3. Sie können jetzt mit jeder Verbindung in der Liste eine der folgenden Aktionen ausführen:

   • GitHub/Bitbucket-Konto oder Organisation öffnen — Wähle den Namen der Verbindung.

   • Vollständiger Authentifizierungs-Handshake — Wähle die Verbindung aus und wähle dann im Aktionsmenü Vollständiger Handshake aus. Die Konsole führt Sie durch den Authentifizierungs-Handshake-Prozess.

   • Verbindung löschen — Wählen Sie die Verbindung aus und klicken Sie dann im Menü Aktionen auf Löschen. Folgen Sie den Anweisungen auf der Löschaufforderung.

App Runner API or AWS CLI

Sie können die folgenden App Runner API-Aktionen verwenden, um Ihre Verbindungen zu verwalten.

• CreateConnection— Stellt eine Verbindung zu einem Repository-Anbieter-Konto her. Nachdem die Verbindung hergestellt wurde, müssen Sie den Authentifizierungs-Handshake manuell mithilfe der App Runner-Konsole abschließen. Dieser Vorgang wurde im vorherigen Abschnitt erklärt.

• ListConnections— Gibt eine Liste der App Runner-Verbindungen zurück, die mit Ihrem verknüpft sind AWS-Konto.

• DeleteConnection— Löscht eine Verbindung. Möglicherweise müssen Sie nicht benötigte Verbindungen löschen, wenn Sie das Verbindungskontingent für Ihre AWS-Konto erreichen.