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. # Konfigurationen für die Dienstsynchronisierung Mit Service Sync können Sie Ihre AWS Proton Dienste mit Git konfigurieren und bereitstellen. Sie können Service Sync verwenden, um erste Bereitstellungen und Updates für Ihren AWS Proton Service mit einer in einem Git-Repository definierten Konfiguration zu verwalten. Über Git kannst du Funktionen wie Versionsverfolgung und Pull-Requests verwenden, um deine Dienste zu konfigurieren, zu verwalten und bereitzustellen. Service Sync kombiniert AWS Proton und Git unterstützt Sie bei der Bereitstellung einer standardisierten Infrastruktur, die über AWS Proton Vorlagen definiert und verwaltet wird. Es verwaltet Dienstdefinitionen in Ihrem Git-Repository und reduziert den Werkzeugwechsel. Im Vergleich zur alleinigen Verwendung von Git können Sie durch die Standardisierung von Vorlagen und Bereitstellung weniger Zeit für die Verwaltung Ihrer Infrastruktur aufwenden. AWS Proton AWS Proton bietet außerdem eine höhere Transparenz und Überprüfbarkeit sowohl für Entwickler als auch für Plattformteams. ## AWS Proton OPS-Datei Die `proton-ops` Datei definiert, wo AWS Proton sich die Spezifikationsdatei befindet, die zum Aktualisieren Ihrer Dienstinstanz verwendet wird. Sie definiert auch, in welcher Reihenfolge Serviceinstanzen aktualisiert werden sollen und wann Änderungen von einer Instanz auf eine andere übertragen werden sollen. Die `proton-ops` Datei unterstützt das Synchronisieren einer Dienstinstanz mithilfe der Spezifikationsdatei oder mehrerer Spezifikationsdateien, die sich in Ihrem verknüpften Repository befinden. Sie können dies tun, indem Sie einen Sync-Block in der `proton-ops` Datei definieren, wie im folgenden Beispiel. **Beispiel. /configuration/proton-ops.yaml**: ``` sync: services: frontend-svc: alpha: branch: dev spec: ./frontend-svc/test/frontend-spec.yaml beta: branch: dev spec: ./frontend-svc/test/frontend-spec.yaml gamma: branch: pre-prod spec: ./frontend-svc/pre-prod/frontend-spec.yaml prod-one: branch: prod spec: ./frontend-svc/prod/frontend-spec-second.yaml prod-two: branch: prod spec: ./frontend-svc/prod/frontend-spec-second.yaml prod-three: branch: prod spec: ./frontend-svc/prod/frontend-spec-second.yaml ``` Im vorherigen Beispiel sind dies der Dienstname und,`frontend-svc`,,, `alpha``beta`, `gamma` und sind die Instanzen. `prod-one` `prod-two` `prod-three` Bei der `spec` Datei kann es sich um alle Instanzen oder eine Teilmenge der in der `proton-ops` Datei definierten Instanzen handeln. Es muss jedoch mindestens die Instanz innerhalb des Branches und die Spezifikation, mit der sie synchronisiert wird, definiert sein. Wenn in der `proton-ops` Datei keine Instanzen mit dem spezifischen Zweig und dem Speicherort der `spec` Datei definiert sind, erstellt oder aktualisiert Service Sync diese Instanzen nicht. Die folgenden Beispiele zeigen, wie die `spec` Dateien aussehen. Denken Sie daran, dass die `proton-ops` Datei aus diesen `spec` Dateien synchronisiert wird. **Beispiel: `./frontend-svc/test/frontend-spec.yaml`** ``` proton: "ServiceSpec" instances: - name: "alpha" environment: "frontend-env" spec: port: 80 desired_count: 1 task_size: "x-small" image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0" - name: "beta" environment: "frontend-env" spec: port: 80 desired_count: 1 task_size: "x-small" image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0" ``` **Beispiel`./frontend-svc/pre-prod/frontend-spec.yaml`:** ``` proton: "ServiceSpec" instances: - name: "gamma" environment: "frontend-env" spec: port: 80 desired_count: 1 task_size: "x-small" image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0" ``` **Beispiel`./frontend-svc/prod/frontend-spec-second.yaml`:** ``` proton: "ServiceSpec" instances: - name: "prod-one" environment: "frontend-env" spec: port: 80 desired_count: 1 task_size: "x-small" image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0" - name: "prod-two" environment: "frontend-env" spec: port: 80 desired_count: 1 task_size: "x-small" image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0" - name: "prod-three" environment: "frontend-env" spec: port: 80 desired_count: 1 task_size: "x-small" image: "public.ecr.aws/z9d2n7e1/nginx:1.21.0" ``` Wenn eine Instanz nicht synchronisiert wird und beim Versuch, sie zu synchronisieren, weiterhin ein Problem auftritt, kann der Aufruf der [https://docs.aws.amazon.com//proton/latest/APIReference/API_GetServiceInstanceSyncStatus.html](https://docs.aws.amazon.com//proton/latest/APIReference/API_GetServiceInstanceSyncStatus.html)API zur Lösung des Problems beitragen. **Anmerkung** Kunden, die Service Sync verwenden, sind immer noch durch AWS Proton Beschränkungen eingeschränkt. **Blocker** Indem Sie Ihren Service mithilfe AWS Proton von Service Sync synchronisieren, können Sie Ihre Servicespezifikation aktualisieren und Service-Instanzen aus Ihrem Git-Repository erstellen und aktualisieren. Es kann jedoch vorkommen, dass Sie einen Service oder eine Instanz manuell über das AWS-Managementkonsole oder aktualisieren müssen. AWS CLI AWS Proton verhindert, dass manuelle Änderungen, die Sie über das AWS-Managementkonsole oder vornehmen, überschrieben werden AWS CLI, z. B. das Aktualisieren einer Dienstinstanz oder das Löschen einer Dienstinstanz. Um dies zu erreichen, erstellt es AWS Proton automatisch einen Service Sync-Blocker, indem Service Sync deaktiviert wird, wenn eine manuelle Änderung erkannt wird. Um alle mit einem Dienst verknüpften Blocker abzurufen, müssen Sie für jeden, der mit dem Dienst `serviceInstance` verknüpft ist, die folgenden Schritte ausführen: + Rufen Sie die `getServiceSyncBlockerSummary` API nur mit dem auf`serviceName`. + Rufen Sie die `getServiceSyncBlockerSummary` API mit dem `serviceName` und auf`serviceInstanceName`. Dadurch wird eine Liste der neuesten Blocker und der ihnen zugeordnete Status zurückgegeben. Wenn irgendwelche Blocker als **AKTIV** markiert sind, müssen Sie sie lösen, indem Sie die `UpdateServiceSyncBlocker` API mit dem `blockerId` und `resolvedReason` für jeden Block aufrufen. Wenn Sie eine Dienstinstanz manuell aktualisieren oder erstellen, AWS Proton wird auf der Dienstinstanz ein Dienstsynchronisierungsblocker erstellt. AWS Proton synchronisiert weiterhin alle anderen Dienstinstanzen, deaktiviert jedoch die Synchronisierung dieser Dienstinstanz, bis der Blocker behoben ist. Wenn Sie eine Dienstinstanz aus einem Dienst löschen, AWS Proton wird für den Dienst ein Dienstsynchronisierungsblocker erstellt. Dadurch wird AWS Proton verhindert, dass eine der Dienstinstanzen synchronisiert wird, bis der Blocker behoben wurde. Wenn Sie alle aktiven Blocker haben, müssen Sie sie lösen, indem Sie die `UpdateServiceSyncBlocker` API mit `blockerId` und `resolvedReason` für jeden der aktiven Blocker aufrufen. Mithilfe von können Sie feststellen AWS-Managementkonsole, ob eine Dienstsynchronisierung deaktiviert ist, indem Sie zur Registerkarte **Service** Sync navigieren AWS Proton und diese auswählen. Wenn der Dienst oder die Dienstinstanzen blockiert sind, wird die Schaltfläche **Aktivieren** angezeigt. Um die Dienstsynchronisierung zu aktivieren, wählen Sie **Aktivieren**. **Topics** + [AWS Proton OPS-Datei](#service-sync-ops) + [Erstellen Sie eine Service Sync-Konfiguration](create-service-sync.md) + [Konfigurationsdetails für eine Dienstsynchronisierung anzeigen](get-service-sync.md) + [Bearbeiten Sie eine Dienstsynchronisierungskonfiguration](update-service-sync.md) + [Löschen Sie eine Service Sync-Konfiguration](delete-service-sync.md) # Erstellen Sie eine Service Sync-Konfiguration Sie können eine Service Sync-Konfiguration mithilfe der Konsole oder erstellen AWS CLI. ------ #### [ AWS-Managementkonsole ] 1. **Wählen Sie auf der Seite Servicevorlage** auswählen eine Vorlage aus und klicken Sie auf **Konfigurieren**. 1. Geben Sie auf der Seite **Dienst konfigurieren** im Abschnitt **Dienstdetails** einen neuen **Dienstnamen** ein. 1. (Optional) Geben Sie eine Beschreibung für den Dienst ein. 1. Wählen Sie im Abschnitt **Quellcode-Repository der Anwendung** die Option **Verlinktes Git-Repository** auswählen aus, um ein Repository auszuwählen, mit dem Sie bereits verknüpft sind AWS Proton. Wenn du noch kein verlinktes Repository hast, wähle **Ein anderes Git-Repository verknüpfen** und befolge die Anweisungen unter [Link zu deinem Repository erstellen](https://docs.aws.amazon.com//proton/latest/userguide/ag-create-repo.html). 1. Wählen Sie für **Repository** den Namen Ihres Quellcode-Repositorys aus der Liste aus. 1. Wählen Sie für **Branch** den Namen des Repository-Branches für Ihren Quellcode aus der Liste aus. 1. (Optional) Wählen Sie im Abschnitt „**Tags**“ die Option **Neues Tag hinzufügen** aus und geben Sie einen Schlüssel und einen Wert ein, um ein vom Kunden verwaltetes Tag zu erstellen. 1. Wählen Sie **Weiter** aus. 1. Wählen Sie auf der Seite **Dienstinstanzen konfigurieren** im Abschnitt **Service-Definitionsquelle** die Option **Service mit Git synchronisieren aus**. 1. Wenn Sie Ihre `proton-ops` Datei erstellen möchten AWS Proton , wählen Sie im Abschnitt **Servicedefinitionsdateien** die Option **Ich möchte, dass AWS Proton die Dateien erstellt**. Mit dieser Option wird die `proton-ops` AND-Datei an `spec` den von Ihnen angegebenen Speicherorten AWS Proton erstellt. Wählen Sie **Ich stelle meine eigenen Dateien** bereit, um Ihre eigene OPS-Datei zu erstellen. 1. Wählen Sie im Abschnitt **Service-Definition-Repository** die Option **Ein verknüpftes Git-Repository** auswählen aus, um ein Repository auszuwählen, mit dem Sie bereits verknüpft sind AWS Proton. 1. Wählen Sie **unter Repository-Name** den Namen Ihres Quellcode-Repositorys aus der Liste aus. 1. Wählen Sie für den **`proton-ops`Dateizweig** den Namen Ihres Zweigs aus der Liste aus, in der Ihre OPS- und Spezifikationsdatei gespeichert AWS Proton werden soll. 1. Im Abschnitt **Serviceinstanzen** wird jedes Feld automatisch auf der Grundlage der Werte in der `proton-ops` Datei gefüllt. 1. Wählen Sie **Weiter** und überprüfen Sie Ihre Eingaben. 1. Wählen Sie **Erstellen** aus. ------ #### [ AWS CLI ] **Erstellen Sie eine Service Sync-Konfiguration mit dem AWS CLI** + Führen Sie den folgenden Befehl aus. ``` $ aws proton create-service-sync-config \ --resource "service-arn" \ --repository-provider "GITHUB" \ --repository "example/proton-sync-service" \ --ops-file-branch "main" \ --proton-ops-file "./configuration/custom-proton-ops.yaml" (optional) ``` Die Antwort lautet wie folgt. ``` { "serviceSyncConfig": { "branch": "main", "filePath": "./configuration/custom-proton-ops.yaml", "repositoryName": "example/proton-sync-service", "repositoryProvider": "GITHUB", "serviceName": "service name" } } ``` ------ # Konfigurationsdetails für eine Dienstsynchronisierung anzeigen Sie können die Konfigurationsdetails für eine Servicesynchronisierung in der Konsole oder anzeigen AWS CLI. ------ #### [ AWS-Managementkonsole ] **Verwenden Sie die Konsole, um die Konfigurationsdetails für eine Servicesynchronisierung anzuzeigen** 1. Wählen Sie im Navigationsbereich **Services**. 1. Um Detaildaten anzuzeigen, wählen Sie den Namen eines Dienstes aus, für den Sie eine Service Sync-Konfiguration erstellt haben. 1. Wählen Sie auf der Detailseite für den Service die Registerkarte **Service Sync** aus, um die Konfigurationsdetaildaten für die Service Sync anzuzeigen. ------ #### [ AWS CLI ] **Verwenden Sie den AWS CLI , um einen synchronisierten Dienst abzurufen.** Führen Sie den folgenden Befehl aus. ``` $ aws proton get-service-sync-config \ --service-name "service name" ``` Die Antwort lautet wie folgt. ``` { "serviceSyncConfig": { "branch": "main", "filePath": "./configuration/custom-proton-ops.yaml", "repositoryName": "example/proton-sync-service", "repositoryProvider": "GITHUB", "serviceName": "service name" } } ``` **Verwenden Sie den AWS CLI , um den Status der Dienstsynchronisierung abzurufen.** Führen Sie den folgenden Befehl aus. ``` $ aws proton get-service-sync-status \ --service-name "service name" ``` ------ # Bearbeiten Sie eine Dienstsynchronisierungskonfiguration Sie können eine Service Sync-Konfiguration mit der Konsole oder bearbeiten AWS CLI. ------ #### [ AWS-Managementkonsole ] Bearbeiten Sie eine Service Sync-Konfiguration mithilfe der Konsole. 1. Wählen Sie im Navigationsbereich **Services**. 1. Um Detaildaten anzuzeigen, wählen Sie den Namen eines Dienstes aus, für den Sie eine Service Sync-Konfiguration erstellt haben. 1. Wählen Sie auf der Service-Detailseite die Registerkarte **Service Sync** aus. 1. Wählen Sie im Abschnitt **Service Sync** die Option **Bearbeiten** aus. 1. Aktualisieren Sie auf der Seite **Bearbeiten** die Informationen, die Sie bearbeiten möchten, und wählen Sie dann **Speichern**. ------ #### [ AWS CLI ] **Der folgende Beispielbefehl und die folgende Antwort zeigen, wie Sie eine Service Sync-Konfiguration mit dem bearbeiten können AWS CLI.** Führen Sie den folgenden Befehl aus. ``` $ aws proton update-service-sync-config \ --service-name "service name" \ --repository-provider "GITHUB" \ --repository "example/proton-sync-service" \ --ops-file-branch "main" \ --ops-file "./configuration/custom-proton-ops.yaml" ``` Die Antwort lautet wie folgt. ``` { "serviceSyncConfig": { "branch": "main", "filePath": "./configuration/custom-proton-ops.yaml", "repositoryName": "example/proton-sync-service", "repositoryProvider": "GITHUB", "serviceName": "service name" } } ``` ------ # Löschen Sie eine Service Sync-Konfiguration Sie können eine Service Sync-Konfiguration über die Konsole oder löschen AWS CLI. ------ #### [ AWS-Managementkonsole ] **Löschen Sie eine Service Sync-Konfiguration mithilfe der Konsole** 1. Wählen Sie auf der Seite mit den Dienstdetails die Registerkarte **Service Sync** aus. 1. Wählen Sie im Abschnitt **Details zur Servicesynchronisierung** die Option **Verbindung trennen**, um die Verbindung zu Ihrem Repository zu trennen. Nachdem dein Repository getrennt wurde, synchronisieren wir den Service nicht mehr mit diesem Repository. ------ #### [ AWS CLI ] **Die folgenden Beispielbefehle und Antworten zeigen, wie Sie mit dem Dienst synchronisierte Konfigurationen löschen AWS CLI können.** Führen Sie den folgenden Befehl aus. ``` $ aws proton delete-service-sync-config \ --service-name "service name" ``` Die Antwort lautet wie folgt. ``` { "serviceSyncConfig": { "branch": "main", "filePath": "./configuration/custom-proton-ops.yaml", "repositoryName": "example/proton-sync-service", "repositoryProvider": "GITHUB", "serviceName": "service name" } } ``` **Anmerkung** Service Sync löscht keine Dienstinstanzen. Es löscht nur die Konfiguration. ------