Einrichtung mit AWS Proton

Wenn Sie die AWS CLI zum Ausführen von AWS Proton APIs verwenden möchten, stellen Sie sicher, dass Sie sie installiert haben. Wenn Sie es nicht installiert haben, finden Sie weitere Informationen unterEinrichtung der AWS CLI.

AWS Proton spezifische Konfiguration:

• Um Vorlagen zu erstellen und zu verwalten:

  • Wenn Sie Konfigurationen für die Vorlagensynchronisierung verwenden, richten Sie eine AWS CodeStar Verbindung ein.

  • Andernfalls richten Sie einen Amazon S3 S3-Bucket ein.

• So stellen Sie die Infrastruktur bereit:

  • Für die selbstverwaltete Bereitstellung müssen Sie eine AWS CodeStar Verbindung einrichten.

• (Optional) So stellen Sie Pipelines bereit:

  • Richten Sie für AWS-managed Provisioning und CodeBuildbased Provisioning Pipeline-Rollen ein.

  • Richten Sie für die selbstverwaltete Bereitstellung ein Pipeline-Repository ein.

Weitere Informationen zu Bereitstellungsmethoden finden Sie unter. So funktioniert AWS Managed Provisioning

Einen Amazon S3 S3-Bucket einrichten

Um einen S3-Bucket einzurichten, folgen Sie den Anweisungen unter Erstellen Sie Ihren ersten S3-Bucket, um einen S3-Bucket einzurichten. Platzieren Sie Ihre Eingaben AWS Proton in dem Bucket, wo AWS Proton Sie sie abrufen können. Diese Eingaben werden als Template-Bundles bezeichnet. Sie können in anderen Abschnitten dieses Handbuchs mehr über sie erfahren.

Eine AWS CodeStar Verbindung einrichten

Um eine Verbindung AWS Proton zu einem Repository herzustellen, erstellen Sie eine AWS CodeStar Verbindung, die eine Pipeline aktiviert, wenn ein neuer Commit in einem Quellcode-Repository eines Drittanbieters vorgenommen wird.

AWS Proton verwendet die Verbindung für:

• Aktiviert eine Service-Pipeline, wenn ein neuer Commit für den Quellcode Ihres Repositorys vorgenommen wird.

• Stellen Sie eine Pull-Anfrage für ein Infrastruktur-as-Code-Repository.

• Erstellen Sie immer dann eine neue Neben- oder Hauptversion einer Vorlage, wenn ein Commit in ein Template-Repository übertragen wird, das eine Ihrer Vorlagen ändert, sofern die Version noch nicht existiert.

Du kannst dich mit Bitbucket- GitHub, GitHub Enterprise- und GitHub Enterprise Server-Repositorys verbinden. CodeConnections Weitere Informationen findest du CodeConnectionsim AWS CodePipeline Benutzerhandbuch.

Um eine CodeStar Verbindung einzurichten.

1. Öffnen Sie die AWS Proton -Konsole.

2. Wählen Sie im Navigationsbereich Einstellungen und dann Repository-Verbindungen aus, um zur Seite Verbindungen in den Einstellungen der Developer Tools zu gelangen. Auf der Seite wird eine Liste von Verbindungen angezeigt.

3. Wählen Sie Verbindung erstellen und folgen Sie den Anweisungen.

Einrichtung der CI/CD-Pipeline-Einstellungen für das Konto

AWS Proton kann CI/CD-Pipelines für die Bereitstellung von Anwendungscode in Ihren Serviceinstanzen bereitstellen. Die AWS Proton Einstellungen, die Sie für die Pipeline-Bereitstellung benötigen, hängen von der Bereitstellungsmethode ab, die Sie für Ihre Pipeline wählen.

AWS-verwaltete und CodeBuild basierte Bereitstellung — Richten Sie Pipeline-Rollen ein

Mit AWS-managed Provisioning und CodeBuild Provisioning werden Pipelines für Sie bereitgestellt. AWS Proton Benötigt daher eine AWS Proton Servicerolle, die Berechtigungen für die Bereitstellung von Pipelines bereitstellt. Jede dieser beiden Bereitstellungsmethoden verwendet ihre eigene Servicerolle. Diese Rollen werden von allen AWS Proton Service-Pipelines gemeinsam genutzt und Sie konfigurieren sie einmal in Ihren Kontoeinstellungen.

So erstellen Sie Pipeline-Servicerollen mithilfe der Konsole

1. Öffnen Sie die AWS Proton -Konsole.

2. Wählen Sie im Navigationsbereich Einstellungen und dann Kontoeinstellungen aus.

3. Wählen Sie auf der Seite mit den CI/CD-Einstellungen für das Konto die Option Konfigurieren aus.

4. Führen Sie eine der folgenden Aktionen aus:

   • Um eine Pipeline-Servicerolle für AWS Proton Sie erstellen zu lassen

     [Um die AWS-verwaltete Bereitstellung von Pipelines zu aktivieren] Gehen Sie auf der Seite Kontoeinstellungen konfigurieren im Abschnitt AWS-managed provisioning Pipeline-Rolle wie folgt vor:

     1. Wählen Sie Neue Servicerolle aus.

     2. Geben Sie einen Namen für die Rolle ein, myProtonPipelineServiceRole z. B.

     3. Aktivieren Sie das Kontrollkästchen, um der Erstellung einer AWS Proton Rolle mit Administratorrechten in Ihrem Konto zuzustimmen.

     [Um die CodeBuild basierte Bereitstellung von Pipelines zu aktivieren] Wählen Sie auf der Seite Kontoeinstellungen konfigurieren im Abschnitt CodeBuildPipeline-Rolle die Option Bestehende Servicerolle und wählen Sie die Servicerolle aus, die Sie im Abschnitt CloudFormation Pipeline-Rolle erstellt haben. Oder, wenn Sie keine CloudFormation Pipeline-Rolle zugewiesen haben, wiederholen Sie die vorherigen drei Schritte, um eine neue Servicerolle zu erstellen.

   • Um bestehende Pipeline-Dienstrollen auszuwählen

     [Um die AWS verwaltete Bereitstellung von Pipelines zu aktivieren] Wählen Sie auf der Seite Kontoeinstellungen konfigurieren im Abschnitt AWS-managed provisioning pipeline role die Option Existierende Servicerolle und wählen Sie eine Servicerolle in Ihrem Konto aus. AWS

     [Um die CodeBuild Bereitstellung von Pipelines zu aktivieren] Wählen Sie auf der Seite Kontoeinstellungen konfigurieren im Abschnitt CodeBuildPipeline-Bereitstellungsrolle die Option Bestehende Servicerolle und wählen Sie eine Servicerolle in Ihrem Konto aus. AWS

5. Wählen Sie Änderungen speichern aus.

   Ihre neue Pipeline-Servicerolle wird auf der Seite mit den Kontoeinstellungen angezeigt.

Selbstverwaltete Bereitstellung — Richten Sie ein Pipeline-Repository ein

AWS Proton Sendet bei der selbstverwalteten Bereitstellung eine Pull-Anfrage (PR) an ein von Ihnen eingerichtetes Provisioning-Repository, und Ihr Automatisierungscode ist für die Bereitstellung von Pipelines verantwortlich. Für die Bereitstellung von Pipelines ist daher AWS Proton keine Servicerolle erforderlich. Stattdessen benötigt es ein registriertes Provisioning-Repository. Ihr Automatisierungscode im Repository muss eine entsprechende Rolle übernehmen, die Berechtigungen für die Bereitstellung von Pipelines bereitstellt.

Um ein Pipeline-Provisioning-Repository mit der Konsole zu registrieren

1. Erstellen Sie ein CI/CD-Pipeline-Provisioning-Repository, falls Sie noch keines erstellt haben. Weitere Informationen zu Pipelines bei der selbstverwalteten Bereitstellung finden Sie unter. So funktioniert Selbstverwaltetes Provisioning

2. Wählen Sie im Navigationsbereich Einstellungen und dann Kontoeinstellungen aus.

3. Wählen Sie auf der Seite mit den CI/CD-Einstellungen für das Konto die Option Konfigurieren aus.

4. Gehen Sie auf der Seite Kontoeinstellungen konfigurieren im Abschnitt CI/CD-Pipeline-Repository wie folgt vor:

   1. Wählen Sie Neues Repository und dann einen der Repository-Anbieter aus.

   2. Wählen Sie für die CodeStar Verbindung eine Ihrer Verbindungen aus.

      Anmerkung

      Wenn Sie noch keine Verbindung zum entsprechenden Repository-Provider-Konto haben, wählen Sie Neue CodeStar Verbindung hinzufügen, schließen Sie den Verbindungsaufbau ab und klicken Sie dann auf die Schaltfläche „Aktualisieren“ neben dem CodeStarVerbindungsmenü. Sie sollten jetzt in der Lage sein, Ihre neue Verbindung im Menü auszuwählen.

   3. Wählen Sie als Repository-Name Ihr Pipeline-Provisioning-Repository aus. Das Drop-down-Menü zeigt die Liste der Repositorys im Anbieterkonto.

   4. Wählen Sie als Branch-Name einen der Repository-Branches aus.

5. Wählen Sie Änderungen speichern aus.

   Ihr Pipeline-Repository wird auf der Seite mit den Kontoeinstellungen angezeigt.

Einrichtung der AWS CLI

Um die AWS CLI für AWS Proton API-Aufrufe zu verwenden, stellen Sie sicher, dass Sie die neueste Version von installiert haben AWS CLI. Weitere Informationen finden Sie unter Erste Schritte mit dem AWS CLI im AWS Command Line Interface -Benutzerhandbuch. Weitere Informationen zu den ersten Schritten AWS CLI mit AWS Proton finden Sie unterErste Schritte mit AWS CLI.