Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS endet der Support für AWS Proton. Nach dem 7. Oktober 2026 können Sie nicht mehr auf die AWS Proton Konsole oder AWS Proton die Ressourcen zugreifen. Ihre bereitgestellte Infrastruktur bleibt intakt. Weitere Informationen finden Sie im [AWS Proton Service Deprecation and Migration Guide](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html).
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.
# Einrichtung mit AWS Proton
Wenn Sie den AWS CLI zum Ausführen verwenden möchten, stellen Sie sicher AWS Proton APIs, dass Sie ihn installiert haben. Wenn Sie es nicht installiert haben, finden Sie weitere Informationen unter[Einrichtung der AWS CLI](#ag-setting-up-cli).
**AWS Proton spezifische Konfiguration:**
+ **Um Vorlagen zu erstellen und zu verwalten:**
+ Wenn Sie [Konfigurationen für die Vorlagensynchronisierung](ag-template-sync-configs.md) verwenden, richten Sie eine [AWS CodeStar Verbindung](#setting-up-vcontrol) ein.
+ Andernfalls richten Sie einen [Amazon S3 S3-Bucket ein.](#setting-up-bucket)
+ **So stellen Sie die Infrastruktur bereit:**
+ [Für die [selbstverwaltete Bereitstellung](ag-works-prov-methods.md#ag-works-prov-methods-self) müssen Sie eine AWS CodeStar Verbindung einrichten.](#setting-up-vcontrol)
+ **(Optional) So stellen Sie Pipelines bereit:**
+ [Richten Sie für [AWS-managed Provisioning](ag-works-prov-methods.md#ag-works-prov-methods-direct) und [CodeBuildbased Provisioning Pipeline-Rollen](ag-works-prov-methods.md#ag-works-prov-methods-codebuild) ein.](#setting-up-pr-role)
+ [Richten Sie für die [selbstverwaltete Bereitstellung](ag-works-prov-methods.md#ag-works-prov-methods-self) ein Pipeline-Repository ein.](#setting-up-pr-repo)
Weitere Informationen zu Bereitstellungsmethoden finden Sie unter. [So funktioniert AWS-managed Provisioning](ag-works-prov-methods.md#ag-works-prov-methods-direct)
## Einen Amazon S3 S3-Bucket einrichten
Um einen S3-Bucket einzurichten, folgen Sie den Anweisungen unter [Erstellen Sie Ihren ersten S3-Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html), 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. In anderen Abschnitten dieses Handbuchs erfahren Sie mehr über sie.
## 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 finden Sie unter [CodeConnections](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html) im *AWS CodePipeline -Benutzerhandbuch*.
**Um eine CodeStar Verbindung einzurichten.**
1. Öffnen Sie die [AWS Proton -Konsole](https://console.aws.amazon.com//proton/).
1. 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.
1. Wählen Sie **Verbindung erstellen** und folgen Sie den Anweisungen.
## Einstellungen für die CI/CD Konto-Pipeline einrichten
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](ag-works-prov-methods.md#ag-works-prov-methods-direct) werden Pipelines für Sie bereitgestellt.](ag-works-prov-methods.md#ag-works-prov-methods-codebuild) 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](https://console.aws.amazon.com//proton/).
1. Wählen Sie im Navigationsbereich **Einstellungen** und dann **Kontoeinstellungen** aus.
1. Wählen Sie auf der Seite mit den ** CI/CD Kontoeinstellungen** die Option **Konfigurieren** aus.
1. Führen Sie eine der folgenden Aktionen aus:
+ **Um eine Pipeline-Servicerolle für Sie AWS Proton 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.**
1. Geben Sie einen Namen für die Rolle ein, zum Beispiel**myProtonPipelineServiceRole**.
1. 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
1. 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](ag-works-prov-methods.md#ag-works-prov-methods-self) 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. [Wie funktioniert die selbstverwaltete Bereitstellung](ag-works-prov-methods.md#ag-works-prov-methods-self)
1. **Wählen Sie im Navigationsbereich **Einstellungen und dann Kontoeinstellungen** aus.**
1. Wählen Sie auf der Seite mit den ** CI/CD Kontoeinstellungen** die Option **Konfigurieren** aus.
1. 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.
1. 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.
1. Wählen Sie als **Repository-Name** Ihr Pipeline-Provisioning-Repository aus. Das Dropdownmenü zeigt die Liste der Repositorys im Anbieterkonto.
1. Wählen Sie als **Branch-Name** einen der Repository-Branches aus.
1. 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) im *AWS Command Line Interface -Benutzerhandbuch*. Weitere Informationen zu den ersten Schritten AWS CLI mit AWS Proton finden Sie unter[Erste Schritte mit dem AWS CLI](ag-getting-started-cli.md).