Was sind Verbindungen?

Sie können die Verbindungsfunktion in der Developer Tools-Konsole verwenden, um AWS Ressourcen zu verbinden, z. B. AWS CodePipeline mit externen Code-Repositorys. Diese Funktion hat eine eigene API, die AWS CodeConnections API-Referenz. Jede Verbindung ist eine Ressource, die Sie AWS Diensten zur Verfügung stellen können, um eine Verbindung zu einem Repository eines Drittanbieters herzustellen, z. BitBucket B. Sie können die Verbindung beispielsweise CodePipeline so hinzufügen, dass sie Ihre Pipeline auslöst, wenn eine Codeänderung an Ihrem Code-Repository eines Drittanbieters vorgenommen wird. Jede Verbindung wird benannt und mit einem eindeutigen Amazon-Ressourcenname (ARN) verknüpft, der auf die Verbindung verweist.

Wichtig

Der Servicename AWS CodeStar Connections wurde umbenannt. Ressourcen, die mit dem vorherigen Namespace codestar-connections erstellt wurden, werden weiterhin unterstützt.

Was kann ich mit Verbindungen tun?

Sie können Verbindungen verwenden, um Ressourcen von Drittanbietern in Ihre AWS -Ressourcen in Entwicklertools zu integrieren. Beispiele:

• Stelle eine Connect zu einem Drittanbieter wie Bitbucket her und verwende die Drittanbieterverbindung als Quellintegration mit deinen AWS Ressourcen, wie CodePipeline z.

• Verwalte den Zugriff auf deine Verbindung über deine Ressourcen hinweg einheitlich, indem du Projekte, CodeDeploy Anwendungen und Pipelines CodePipeline für deinen Drittanbieter CodeBuild erstellst.

• Verwenden Sie einen Verbindungs-ARN in Ihren Stack-Vorlagen, CodeBuild um Projekte, CodeDeploy Anwendungen und Pipelines zu erstellen CodePipeline, ohne auf gespeicherte Geheimnisse oder Parameter verweisen zu müssen.

Für welche Drittanbieter kann ich Verbindungen erstellen?

Verbindungen können Ihre AWS Ressourcen mit den folgenden Repositorys von Drittanbietern verknüpfen:

• Bitbucket Cloud

• GitHub.com

• GitHub Cloud für Unternehmen

• GitHub Server für Unternehmen

• GitLab.com

  Wichtig

  Die Unterstützung für Verbindungen GitLab umfasst Version 15.x und höher.

• GitLab selbstverwaltete Installation (für Enterprise Edition oder Community Edition)

Eine Übersicht über den Workflow bei Verbindungen finden Sie unter Workflow zum Erstellen oder Ändern von Verbindungen.

Die Schritte zum Erstellen von Verbindungen für einen Cloud-Anbietertyp, z. B. GitHub, unterscheiden sich von den Schritten für einen installierten Anbietertyp, z. B. GitHub Enterprise Server. Weitere Hinweise zur allgemeinen Vorgehensweise beim Erstellen einer Verbindung nach Anbietertyp finden Sie unter Arbeiten mit Verbindungen.

Anmerkung

Um Verbindungen in Europa (Mailand) nutzen zu können AWS-Region, müssen Sie:

1. Regionsspezifische App installieren

2. Region aktivieren

Diese regionsspezifische App unterstützt Verbindungen in der Region Europa (Mailand). Sie ist auf der Website des Drittanbieters veröffentlicht und von der bestehenden App getrennt, die Verbindungen für andere Regionen unterstützt. Durch die Installation dieser App autorisieren Sie Drittanbieter, Ihre Daten nur für diese Region an den Dienst weiterzugeben, und Sie können diese Autorisierung jederzeit widerrufen, indem Sie die App deinstallieren.

Der Dienst verarbeitet oder speichert Ihre Daten nicht, es sei denn, Sie aktivieren die Region. Durch die Aktivierung dieser Region gewähren Sie unserem Dienst die Erlaubnis, Ihre Daten zu verarbeiten und zu speichern.

Auch wenn die Region nicht aktiviert ist, können Drittanbieter Ihre Daten trotzdem mit unserem Dienst teilen, wenn die regionsspezifische App installiert bleibt. Achten Sie also darauf, die App zu deinstallieren, sobald Sie die Region deaktivieren. Weitere Informationen finden Sie unter Aktivieren einer Region.

Was AWS -Services lässt sich in Verbindungen integrieren?

Sie können mit Verbindungen Ihr Drittanbieter-Repository in andere AWS -Services-Services integrieren. Informationen zu den Serviceintegrationen für Verbindungen finden Sie unterProdukt- und Service-Integrationen mit AWS CodeConnections.

Wie funktionieren Verbindungen?

Bevor Sie eine Verbindung erstellen können, müssen Sie zunächst die AWS -Authentifizierungs-App in Ihrem Drittanbieterkonto installieren oder den Zugriff darauf bereitstellen. Nachdem eine Verbindung installiert wurde, kann sie so eingestellt werden, dass sie diese Installation verwendet. Wenn Sie eine Verbindung erstellen, erteilen Sie Zugriff auf die AWS -Ressource in Ihrem Drittanbieterkonto. Dadurch kann die Verbindung im Namen Ihrer AWS Ressourcen auf Inhalte wie Quell-Repositorys im Drittanbieter-Konto zugreifen. Sie können diese Verbindung dann mit anderen teilen, AWS -Services um sichere OAuth-Verbindungen zwischen den Ressourcen bereitzustellen.

Wenn Sie eine Verbindung zu einem installierten Anbietertyp herstellen möchten, z. B. GitHub Enterprise Server, erstellen Sie zunächst eine Hostressource mit dem. AWS Management Console

Verbindungen gehören demjenigen AWS-Konto , der sie erstellt hat. Verbindungen werden durch einen ARN identifiziert, der eine Verbindungs-ID enthält. Die Verbindungs-ID ist eine UUID, die nicht geändert oder neu zugeordnet werden kann. Durch das Löschen und Wiedererstellen einer Verbindung entsteht eine neue Verbindungs-ID und damit ein neuer Verbindungs-ARN. Das bedeutet, dass Verbindungs-ARNs niemals wiederverwendet werden.

Eine neu erstellte Verbindung befindet sich im Zustand Pending. Ein Drittanbieter-Handshake-Prozess (OAuth-Flow) ist erforderlich, um die Einrichtung der Verbindung abzuschließen und vom Zustand Pending (Ausstehend) zum Zustand Available (Verfügbar) zu gelangen. Sobald dieser Vorgang abgeschlossen ist, ist Available und kann eine Verbindung mit AWS Diensten wie verwendet werden CodePipeline.

Ein neu erstellter Host befindet sich im Zustand Pending (Ausstehend). Ein Drittanbieter-Registrierungs-Prozess ist erforderlich, um die Einrichtung des Hosts abzuschließen und vom Zustand Pending (Ausstehend) zum Zustand Available (Verfügbar) zu gelangen. Nachdem das abgeschlossen ist, ist ein Host Available (Verfügbar) und kann für Verbindungen mit installierten Anbietertypen verwendet werden.

Eine Übersicht über den Workflow bei Verbindungen finden Sie unter Workflow zum Erstellen oder Ändern von Verbindungen. Eine Übersicht über den Workflow zur Host-Erstellung für installierte Anbieter finden Sie unter Workflow zum Erstellen oder Aktualisieren eines Hosts. Weitere Hinweise zur allgemeinen Vorgehensweise beim Erstellen einer Verbindung nach Anbietertyp finden Sie unter Arbeiten mit Verbindungen.

Globale Ressourcen in AWS CodeConnections

Verbindungen sind globale Ressourcen. Das bedeutet, dass die Ressource in allen AWS-Regionen repliziert wird.

Obwohl das Format des Verbindungs-ARNs den Namen der Region widerspiegelt, in der sie erstellt wurde, ist die Ressource nicht auf eine Region beschränkt. Die Region, in der die Verbindungsressource erstellt wurde, ist die Region, in der Änderungen an den Daten der Verbindungsressourcen gesteuert werden. Beispiele für API-Vorgänge, die Änderungen an den Daten der Verbindungsressourcen steuern, sind: das Erstellen einer Verbindung, das Aktualisieren einer Installation, das Löschen einer Verbindung oder das Markieren einer Verbindung.

Hostressourcen für Verbindungen sind keine global verfügbaren Ressourcen. Sie verwenden Hostressourcen nur in der Region, in der sie erstellt wurden.

• Sie müssen nur einmal eine Verbindung erstellen und können diese dann in jeder AWS-Region verwenden.

• Wenn es in der Region, in der die Verbindung erstellt wurde, Probleme gibt, wirkt sich das auf APIs aus, die Verbindungsressourcendaten steuern. Sie können die Verbindung jedoch auch dann ohne Weiteres in jeder anderen Region verwenden.

• Wenn Sie Verbindungsressourcen in der Konsole oder der CLI auflisten, werden in der Liste alle Verbindungsressourcen angezeigt, die mit Ihrem Konto in sämtlichen Regionen verknüpft sind.

• Wenn Sie Hostressourcen in der Konsole oder der CLI auflisten, werden in der Liste alle Hostressourcen angezeigt, die mit Ihrem Konto verknüpft sind, jedoch nur in den ausgewählten Regionen.

• Wenn eine Verbindung mit einer zugeordneten Hostressource mit der CLI aufgelistet oder angezeigt wird, gibt die Ausgabe den Host-ARN zurück, unabhängig von der konfigurierten CLI-Region.

Workflow zum Erstellen oder Aktualisieren eines Hosts

Wenn Sie eine Verbindung für einen installierten Anbieter erstellen, erstellen Sie zunächst einen Host.

Hosts können die folgenden Status haben:

• Pending – Ein Host mit dem Status pending ist ein Host, der erstellt wurde und eingerichtet (in den Status available versetzt) werden muss, bevor er verwendet werden kann.

• Available – Sie können einen Host mit dem Status available verwenden oder an Ihre Verbindung übergeben.

Workflow: Erstellen oder Aktualisieren eines Hosts über die CLI, das SDK oder AWS CloudFormation

Sie verwenden die CreateHostAPI, um einen Host mithilfe von AWS Command Line Interface (AWS CLI), SDK oder zu erstellen AWS CloudFormation. Nachdem der Host erstellt wurde, befindet er sich im Status pending. Sie schließen den Vorgang mithilfe der Option Einrichten in der Konsole ab.

Workflow: Erstellen oder Aktualisieren eines Hosts über die Konsole

Wenn Sie eine Verbindung zu einem installierten Anbietertyp herstellen, z. B. GitHub Enterprise Server oder GitLab selbstverwaltet, erstellen Sie zunächst einen Host. Wenn Sie eine Verbindung zu einem Cloud-Anbietertyp herstellen, z. B. Bitbucket, können Sie das Erstellen des Hosts überspringen und direkt die Verbindung erstellen.

Verwenden Sie die Konsole, um den Host einzurichten und seinen Status von pending in available zu ändern.

Workflow zum Erstellen oder Ändern von Verbindungen

Wenn Sie eine Verbindung erstellen, erstellen bzw. verwenden Sie auch eine vorhandene Installation für den Authentifizierungs-Handshake beim Drittanbieter.

Verbindungen können die folgenden Status haben:

• Pending (Ausstehend) – Eine pending (ausstehende) Verbindung ist eine Verbindung, die abgeschlossen werden muss (d. h. in den Zustand available (verfügbar) gelangen), bevor sie verwendet werden kann.

• Available (Verfügbar) – Sie können eine available (verfügbare) Verbindung in Ihrem Konto verwenden oder an andere Ressourcen und Benutzern übergeben.

• Error (Fehler) – Ist eine Verbindung im Zustand error (Fehler), wird die Erstellung automatisch erneut versucht. Sie kann nicht verwendet werden, bis sie im Status available (verfügbar) ist.

Workflow: Erstellen oder Ändern einer Verbindung mit CLI, SDK oder AWS CloudFormation

Sie verwenden die CreateConnectionAPI, um eine Verbindung mithilfe von AWS Command Line Interface (AWS CLI), SDK oder AWS CloudFormation herzustellen. Nachdem sie erstellt wurde, befindet sich die Verbindung im Zustand pending (ausstehend). Sie schließen den Vorgang mithilfe der Option Set up pending connection (Ausstehende Verbindung einrichten) mit der Konsole ab. Die Konsole fordert Sie auf, eine Installation zu erstellen oder eine vorhandene Installation für die Verbindung zu verwenden. Sie verwenden dann die Konsole, um den Handshake abzuschließen und die Verbindung in den Zustand available (verfügbar) zu bringen, indem Sie Complete connection (Verbindung abschließen) in der Konsole auswählen.

Workflow: Erstellen oder Ändern einer Verbindung über die Konsole

Wenn Sie eine Verbindung zu einem installierten Anbietertyp wie GitHub Enterprise Server herstellen, erstellen Sie zunächst einen Host. Wenn Sie eine Verbindung zu einem Cloud-Anbietertyp herstellen, z. B. Bitbucket, können Sie das Erstellen des Hosts überspringen und direkt die Verbindung erstellen.

Um mit der Konsole eine Verbindung herzustellen oder zu aktualisieren, verwenden Sie die Aktionsseite CodePipeline „Aktion bearbeiten“ in der Konsole, um Ihren Drittanbieter auszuwählen. Die Konsole fordert Sie auf, eine Installation zu erstellen oder eine vorhandene Installation für die Verbindung zu verwenden. Danach erstellen Sie mit der Konsole die Verbindung. Die Konsole schließt den Handshake ab und ändert den Zustand der Verbindung automatisch von pending (ausstehend) zu available (verfügbar).

Was sind die ersten Schritte mit Verbindungen?

Hier finden Sie einige nützliche Themen für den Einstieg:

• Erfahren Sie mehr über die Konzepte für Verbindungen.

• Richten Sie die benötigten Ressourcen für Verbindungen ein.

• Gehen Sie erste Schritte und erstellen Sie Ihre erste Verbindungen und verbinden Sie sie mit einer Ressource.