Umgebungsvorlagen veröffentlichen Dienstvorlagen veröffentlichen

Vorlagen registrieren und veröffentlichen

Sie können Umgebungs- und Dienstvorlagen mit registrieren und veröffentlichenAWS Proton, wie in den folgenden Abschnitten beschrieben.

Sie können eine neue Version einer Vorlage mit der Konsole oderAWS CLI.

Alternativ können Sie die Konsole verwenden oderAWS CLI um eine Vorlage zu erstellen und eine Vorlagensynchronisierung dafür zu konfigurieren. Diese Konfiguration ermöglicht dieAWS Proton Synchronisierung von Template-Bundles aus, die sich in registrierten Git-Repositorys befinden, die Sie definiert haben. Immer wenn ein Commit in dein Repository übertragen wird, das eines deiner Template-Bundles ändert, wird eine neue Neben- oder Hauptversion deiner Vorlage erstellt, sofern die Version noch nicht existiert. Weitere Informationen zu den Konfigurationsvoraussetzungen und Anforderungen für die Vorlagensynchronisierung finden Sie unterKonfigurationen für die Vorlagensynchronisierung.

Umgebungsvorlagen registrieren und veröffentlichen

Sie können die folgenden Arten von Umgebungsvorlagen registrieren und veröffentlichen.

Registrieren und veröffentlichen Sie eine Standardumgebungsvorlage, die für die Bereitstellung und Verwaltung der UmgebungsinfrastrukturAWS Proton verwendet wird.
Registrieren und veröffentlichen Sie eine Vorlage für eine vom Kunden verwaltete UmgebungAWS Proton, mit der Sie eine Verbindung zu Ihrer vorhandenen bereitgestellten Infrastruktur herstellen, die Sie verwalten. AWS Protonverwaltet Ihre bestehende bereitgestellte Infrastruktur nicht.

Wichtig

Stellen Sie als Administrator sicher, dass Ihre bereitgestellte und verwaltete Infrastruktur und alle Ausgabeparameter mit den zugehörigen, vom Kunden verwalteten Umgebungsvorlagen kompatibel sind. AWS Protonkann Änderungen in Ihrem Namen nicht berücksichtigen, da diese Änderungen für nicht sichtbar sindAWS Proton. Inkonsistenzen führen zu Fehlern.

Sie können die Konsole oder die verwendenAWS CLI, um eine Umgebungsvorlage zu registrieren und zu veröffentlichen.

AWS Management Console

Verwenden Sie die Konsole, um eine neue Umgebungsvorlage zu registrieren und zu veröffentlichen.

Wählen Sie in der AWS ProtonKonsole Umgebungsvorlagen aus.
Wählen Sie Umgebungsvorlage erstellen.
Wählen Sie auf der Seite Umgebungsvorlage erstellen im Abschnitt Vorlagenoptionen eine der beiden verfügbaren Vorlagenoptionen aus.
- Erstellen Sie eine Vorlage für die Bereitstellung neuer Umgebungen.
- Erstellen Sie eine Vorlage, um die bereitgestellte Infrastruktur zu verwenden, die Sie verwalten.
Wenn Sie Vorlage für die Bereitstellung neuer Umgebungen erstellen ausgewählt haben, wählen Sie im Abschnitt Quelle des Vorlagenpakets eine der drei verfügbaren Quellenoptionen für das Vorlagenpaket aus. Weitere Informationen zu den Anforderungen und Voraussetzungen für die Synchronisierung von Vorlagen finden Sie unterKonfigurationen für die Vorlagensynchronisierung.
- Verwenden Sie eines unserer Beispielvorlagenpakete.
- Verwenden Sie Ihr eigenes Vorlagenpaket.
- Synchronisiere Vorlagen aus Git.
Geben Sie einen Pfad zu einem Vorlagenpaket an.
1. Wenn Sie sich für „Verwenden Sie eines unserer Beispielvorlagenpakete“ entschieden haben:
  
  Wählen Sie im Abschnitt Beispielvorlagenpaket ein Beispielvorlagenpaket aus.
2. Wenn du „Vorlagen von Git synchronisieren“ ausgewählt hast, gehe im Abschnitt Quellcode wie folgt vor:
  1. Wählen Sie das Repository für Ihre Vorlagensynchronisierungskonfiguration aus.
  2. Geben Sie den Namen des Repository-Zweigs ein, von dem aus synchronisiert werden soll.
  3. (Optional) Geben Sie den Namen eines Verzeichnisses ein, um die Suche nach Ihrem Vorlagenpaket einzuschränken.
3. Andernfalls geben Sie im Abschnitt Speicherort des S3-Bundles einen Pfad zu Ihrem Vorlagenpaket an.
Im Abschnitt Vorlagendetails.
1. Geben Sie einen Vorlagennamen ein.
2. (Optional) Geben Sie einen Display name (Anzeigenamen) für die Vorlage ein.
3. (Optional) Geben Sie eine Beschreibung der Vorlage für die Umgebungsvorlage ein.
(Optional) Aktivieren Sie das Kontrollkästchen für Verschlüsselungseinstellungen anpassen (erweitert) im Abschnitt Verschlüsselungseinstellungen, um Ihren eigenen Verschlüsselungsschlüssel anzugeben.
(Optional) Wählen Sie im Abschnitt „Tags“ die Option „Neues Tag hinzufügen“ und geben Sie einen Schlüssel und einen Wert ein, um ein vom Kunden verwaltetes Tag zu erstellen.
Wählen Sie Create Environment Template.

Sie befinden sich jetzt auf einer neuen Seite, auf der der Status und die Details für Ihre neue Umgebungsvorlage angezeigt werden. Zu diesen Details gehören eine Liste vonAWS und vom Kunden verwalteten Tags. AWS Protongeneriert automatischAWS verwaltete Tags für Sie, wenn SieAWS Proton Ressourcen erstellen. Weitere Informationen finden Sie unter AWS ProtonRessourcen und Tagging.
Der Status einer neuen Umgebungsvorlage beginnt im Status Entwurf. Sie und andere berechtigteproton:CreateEnvironment Personen können es einsehen und darauf zugreifen. Folgen Sie dem nächsten Schritt, um die Vorlage anderen zur Verfügung zu stellen.
Wählen Sie im Abschnitt Vorlagenversionen das Optionsfeld links neben der Nebenversion der Vorlage, die Sie gerade erstellt haben (1.0). Alternativ können Sie im Info-Alert die Option Veröffentlichen wählen und den nächsten Schritt überspringen.
Wählen Sie im Abschnitt Vorlagenversionen die Option Veröffentlichen aus.
Der Status der Vorlage ändert sich in Veröffentlicht. Da es sich um die neueste Version der Vorlage handelt, handelt es sich um die empfohlene Version.
Wählen Sie im Navigationsbereich Umgebungsvorlagen aus, um eine Liste Ihrer Umgebungsvorlagen und Details anzuzeigen.

Verwenden Sie die Konsole, um neue Haupt- und Nebenversionen einer Umgebungsvorlage zu registrieren.

Weitere Informationen finden Sie unter Versionierte Vorlagen.

Wählen Sie in der AWS ProtonKonsole Environment Templates aus.
Wählen Sie in der Liste der Umgebungsvorlagen den Namen der Umgebungsvorlage aus, für die Sie eine Haupt- oder Nebenversion erstellen möchten.
Wählen Sie in der Detailansicht der Umgebungsvorlage im Abschnitt Vorlagenversionen die Option Neue Version erstellen aus.
Wählen Sie auf der Seite Neue Umgebungsvorlagenversion erstellen im Abschnitt Quelle des Vorlagenpakets eine der beiden verfügbaren Quellenoptionen für das Vorlagenpaket aus.
- Verwenden Sie eines unserer Beispielvorlagenpakete.
- Verwenden Sie Ihr eigenes Vorlagenpaket.
Geben Sie einen Pfad zum ausgewählten Vorlagenpaket an.
- Wenn Sie „Eines unserer Beispielvorlagenpakete verwenden“ ausgewählt haben, wählen Sie im Abschnitt Beispielvorlagenpaket ein Beispielvorlagenpaket aus.
- Wenn Sie „Eigenes Vorlagenpaket verwenden“ ausgewählt haben, wählen Sie im Abschnitt Speicherort des S3-Bundles den Pfad zu Ihrem Vorlagenpaket aus.
Im Abschnitt Vorlagendetails.
1. (Optional) Geben Sie einen Display name (Anzeigenamen) für die Vorlage ein.
2. (Optional) Geben Sie eine Beschreibung der Vorlage für die Service-Vorlage ein.
Wählen Sie im Abschnitt Vorlagendetails eine der folgenden Optionen.
- Um eine Nebenversion zu erstellen, lassen Sie das Kontrollkästchen Häkchen, um eine neue Hauptversion zu erstellen, leer.
- Um eine Hauptversion zu erstellen, aktivieren Sie das Kontrollkästchen Aktivieren, um eine neue Hauptversion zu erstellen.
Fahren Sie mit den Konsolenschritten fort, um die neue Neben- oder Hauptversion zu erstellen, und wählen Sie Neue Version erstellen.

AWS CLI

Verwenden Sie die CLI, um eine neue Umgebungsvorlage zu registrieren und zu veröffentlichen, wie in den folgenden Schritten gezeigt.

Erstellen Sie eine standardmäßige Vorlage für eine vom Kunden verwaltete OR-Umgebung, indem Sie die Region, den Namen, den Anzeigenamen (optional) und die Beschreibung (optional) angeben.

Erstellen Sie eine Standardumgebungsvorlage.

Führen Sie den Befehl aus:


$ aws proton create-environment-template \
    --name "simple-env" \
    --display-name "Fargate" \
    --description "VPC with public access"

Antwort:


{
    "environmentTemplate": {
        "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env",
        "createdAt": "2020-11-11T23:02:45.336000+00:00",
        "description": "VPC with public access",
        "displayName": "VPC",
        "lastModifiedAt": "2020-11-11T23:02:45.336000+00:00",
        "name": "simple-env"
    }
}

Erstellen Sie eine Vorlage für eine vom Kunden verwaltete Umgebung, indem Sie denprovisioning Parameter mit dem Wert hinzufügenCUSTOMER_MANAGED.

Führen Sie den Befehl aus:


$ aws proton create-environment-template \
    --name "simple-env" \
    --display-name "Fargate" \
    --description "VPC with public access" \
    --provisioning "CUSTOMER_MANAGED"

Antwort:


{
    "environmentTemplate": {
        "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env",
        "createdAt": "2020-11-11T23:02:45.336000+00:00",
        "description": "VPC with public access",
        "displayName": "VPC",
        "lastModifiedAt": "2020-11-11T23:02:45.336000+00:00",
        "name": "simple-env",
        "provisioning": "CUSTOMER_MANAGED"
    }
}

Erstellen Sie eine Nebenversion 0 der Hauptversion 1 der Umgebungsvorlage

Dieser und die übrigen Schritte sind für die Standardvorlagen und die Vorlagen für die vom Kunden verwaltete Umgebung identisch.

Geben Sie den Vorlagennamen, die Hauptversion sowie den Namen und Schlüssel des S3-Buckets für den Bucket an, der Ihr Umgebungsvorlagenpaket enthält.

Führen Sie den Befehl aus:


$ aws proton create-environment-template-version \
    --template-name "simple-env" \
    --description "Version 1" \
    --source s3="{bucket=your_s3_bucket, key=your_s3_key}"

Antwort:


{
    "environmentTemplateVersion": {
        "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env:1.0",
        "createdAt": "2020-11-11T23:02:47.763000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:02:47.763000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "status": "REGISTRATION_IN_PROGRESS",
        "templateName": "simple-env"
    }
}

Verwenden Sie den Befehl get, um den Status der Registrierung zu überprüfen.

Führen Sie den Befehl aus:


$ aws proton get-environment-template-version \
    --template-name "simple-env" \
    --major-version "1" \
    --minor-version "0"

Antwort:


{
    "environment": {
        "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env:1.0",
        "createdAt": "2020-11-11T23:02:47.763000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:02:47.763000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "recommendedMinorVersion": "0",
        "schema": "schema:\n  format:\n    openapi: \"3.0.0\"\n  environment_input_type: \"MyEnvironmentInputType\"\n  types:\n    MyEnvironmentInputType:\n      type: object\n      description: \"Input properties for my environment\"\n      properties:\n        my_sample_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_other_sample_input:\n          type: string\n          description: \"Another sample input\"\n      required:\n        - my_other_sample_input\n",
        "status": "DRAFT",
        "statusMessage": "",
        "templateName": "simple-env"
    }
}

Veröffentlichen Sie die Nebenversion 0 der Hauptversion 1 der Umgebungsvorlage, indem Sie den Vorlagennamen sowie die Haupt- und Nebenversion angeben. Diese Version ist dieRecommended Version.

Führen Sie den Befehl aus:


$ aws proton update-environment-template-version \
    --template-name "simple-env" \
    --major-version "1" \
    --minor-version "0" \
    --status "PUBLISHED"

Antwort:


{
    "environmentTemplateVersion": {
        "arn": "arn:aws:proton:region-id:123456789012:environment-template/simple-env:1.0",
        "createdAt": "2020-11-11T23:02:47.763000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:02:54.610000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "recommendedMinorVersion": "0",
        "schema": "schema:\n  format:\n    openapi: \"3.0.0\"\n  environment_input_type: \"MyEnvironmentInputType\"\n  types:\n    MyEnvironmentInputType:\n      type: object\n      description: \"Input properties for my environment\"\n      properties:\n        my_sample_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_other_sample_input:\n          type: string\n          description: \"Another sample input\"\n      required:\n        - my_other_sample_input\n",
        "status": "PUBLISHED",
        "statusMessage": "",
        "templateName": "simple-env"
    }
}

Nachdem Sie mit dem eine neue Vorlage erstellt habenAWS CLI, können Sie sich eine Liste derAWS vom Kunden verwalteten Tags anzeigen lassen. AWS Protongeneriert automatischAWS verwaltete Tags für Sie. Sie können auch vom Kunden verwaltete Tags ändern und erstellen, indem Sie die verwendenAWS CLI. Weitere Informationen finden Sie unter AWS ProtonRessourcen und Tagging.

Führen Sie den Befehl aus:


$ aws proton list-tags-for-resource \
    --resource-arn "arn:aws:proton:region-id:123456789012:environment-template/simple-env"

Service-Vorlagen registrieren und veröffentlichen

Wenn Sie eine Dienstvorlagenversion erstellen, geben Sie eine Liste kompatibler Umgebungsvorlagen an. Auf diese Weise haben Entwickler bei der Auswahl einer Service-Vorlage Optionen für die Umgebung, in der sie ihren Service bereitstellen möchten.

Bevor Sie einen Service anhand einer Service-Vorlage erstellen oder eine Service-Vorlage veröffentlichen, vergewissern Sie sich, dass Umgebungen anhand der aufgelisteten kompatiblen Umgebungsvorlagen bereitgestellt wurden.

Sie können einen Dienst nicht auf die neue Hauptversion aktualisieren, wenn er in einer Umgebung bereitgestellt wird, die auf der Grundlage einer entfernten kompatiblen Umgebungsvorlage erstellt wurde.

Um kompatible Umgebungsvorlagen für eine Dienstvorlagenversion hinzuzufügen oder zu entfernen, erstellen Sie eine neue Hauptversion davon.

Sie können die Konsole oder die verwendenAWS CLI, um eine Service-Vorlage zu registrieren und zu veröffentlichen.

AWS Management Console

Verwenden Sie die Konsole, um eine neue Service-Vorlage zu registrieren und zu veröffentlichen.

Wählen Sie in der AWS ProtonKonsole Service Templates aus.
Wählen Sie Create Service Template.
Wählen Sie auf der Seite Servicevorlage erstellen im Abschnitt Quelle des Vorlagenpakets eine der verfügbaren Vorlagenoptionen aus.
- Verwenden Sie Ihr eigenes Vorlagenpaket.
- Synchronisiere Vorlagen aus Git.
Geben Sie einen Pfad zu einem Vorlagenpaket an.
1. Wenn du im Abschnitt Quellcode-Repository die Option Vorlagen von Git synchronisieren ausgewählt hast:
  1. Wählen Sie das Repository für Ihre Vorlagensynchronisierungskonfiguration aus.
  2. Geben Sie den Namen des Repository-Zweigs ein, von dem aus synchronisiert werden soll.
  3. (Optional) Geben Sie den Namen eines Verzeichnisses ein, um die Suche nach Ihrem Vorlagenpaket einzuschränken.
2. Andernfalls geben Sie im Abschnitt Speicherort des S3-Bundles einen Pfad zu Ihrem Vorlagenpaket an.
Im Abschnitt Vorlagendetails.
1. Geben Sie einen Vorlagennamen ein.
2. (Optional) Geben Sie einen Display name (Anzeigenamen) für die Vorlage ein.
3. (Optional) Geben Sie eine Beschreibung der Vorlage für die Service-Vorlage ein.
Wählen Sie im Abschnitt Kompatible Umgebungsvorlagen aus einer Liste kompatibler Umgebungsvorlagen aus.
(Optional) Wählen Sie im Abschnitt Verschlüsselungseinstellungen die Option Verschlüsselungseinstellungen anpassen (erweitert), um Ihren eigenen Verschlüsselungsschlüssel bereitzustellen.
(Optional) Im Abschnitt Pipeline:

Wenn Sie keine Service-Pipeline-Definition in Ihre Service-Vorlage aufnehmen, deaktivieren Sie das Kontrollkästchen Pipeline — optional unten auf der Seite. Sie können dies nicht ändern, nachdem die Service-Vorlage erstellt wurde. Weitere Informationen finden Sie unter Vorlagenpakete.
(Optional) Wählen Sie im Abschnitt Unterstützte Komponentenquellen für Komponentenquellen die Option Direkt definiert aus, um das Anhängen direkt definierter Komponenten an Ihre Service-Instanzen zu ermöglichen.
(Optional) Wählen Sie im Abschnitt „Tags“ die Option „Neues Tag hinzufügen“ und geben Sie einen Schlüssel und einen Wert ein, um ein vom Kunden verwaltetes Tag zu erstellen.
Wählen Sie Create a service template.

Sie befinden sich jetzt auf einer neuen Seite, auf der der Status und die Details für Ihre neue Service-Vorlage angezeigt werden. Zu diesen Details gehören eine Liste vonAWS und vom Kunden verwalteten Tags. AWS Protongeneriert automatischAWS verwaltete Tags für Sie, wenn SieAWS Proton Ressourcen erstellen. Weitere Informationen finden Sie unter AWS ProtonRessourcen und Tagging.
Der Status einer neuen Servicevorlage beginnt im Status Entwurf. Sie und andere berechtigteproton:CreateService Personen können es einsehen und darauf zugreifen. Folgen Sie dem nächsten Schritt, um die Vorlage anderen zur Verfügung zu stellen.
Wählen Sie im Abschnitt Vorlagenversionen das Optionsfeld links neben der Nebenversion der Vorlage, die Sie gerade erstellt haben (1.0). Alternativ können Sie im Info-Alert die Option Veröffentlichen wählen und den nächsten Schritt überspringen.
Wählen Sie im Abschnitt Vorlagenversionen die Option Veröffentlichen aus.
Der Status der Vorlage ändert sich in Veröffentlicht. Da es sich um die neueste Version der Vorlage handelt, handelt es sich um die empfohlene Version.
Wählen Sie im Navigationsbereich Dienstvorlagen aus, um eine Liste Ihrer Servicevorlagen und Details anzuzeigen.

Verwenden Sie die Konsole, um neue Haupt- und Nebenversionen einer Service-Vorlage zu registrieren.

Weitere Informationen finden Sie unter Versionierte Vorlagen.

Wählen Sie in der AWS ProtonKonsole Service Templates aus.
Wählen Sie in der Liste der Service-Vorlagen den Namen der Service-Vorlage aus, für die Sie eine Haupt- oder Nebenversion erstellen möchten.
Wählen Sie in der Detailansicht der Service-Vorlage im Abschnitt Vorlagenversionen die Option Neue Version erstellen aus.
Wählen Sie auf der Seite Neue Service-Vorlagenversion erstellen im Abschnitt Bundle-Quelle die Option Eigenes Vorlagenpaket verwenden aus.
Wählen Sie im Abschnitt Standort des S3-Bundles den Pfad zu Ihrem Vorlagenpaket aus.
Im Abschnitt Vorlagendetails.
1. (Optional) Geben Sie einen Display name (Anzeigenamen) für die Vorlage ein.
2. (Optional) Geben Sie eine Beschreibung der Vorlage für die Service-Vorlage ein.
Wählen Sie im Abschnitt Vorlagendetails eine der folgenden Optionen.
- Um eine Nebenversion zu erstellen, lassen Sie das Kontrollkästchen Häkchen, um eine neue Hauptversion zu erstellen, leer.
- Um eine Hauptversion zu erstellen, aktivieren Sie das Kontrollkästchen Aktivieren, um eine neue Hauptversion zu erstellen.
Fahren Sie mit den Konsolenschritten fort, um die neue Neben- oder Hauptversion zu erstellen, und wählen Sie Neue Version erstellen.

AWS CLI

Um eine Dienstvorlage zu erstellen, die einen Dienst ohne Dienstpipeline bereitstellt, fügen Sie demcreate-service-template Befehl den Parameter und--pipeline-provisioning "CUSTOMER_MANAGED" den Wert hinzu. Konfigurieren Sie Ihre Vorlagenpakete wie unterVorlagenpakete Erstellung und beschriebenSchemaanforderungen für Servicevorlagenpakete.

Anmerkung

Sie können die Servicevorlage nicht mehr ändern,pipelineProvisioning nachdem sie erstellt wurde.

Verwenden Sie die CLI, um eine neue Service-Vorlage mit oder ohne Service-Pipeline zu registrieren und zu veröffentlichen, wie in den folgenden Schritten gezeigt.

Erstellen Sie mithilfe der CLI eine Service-Vorlage mit einer Service-Pipeline.

Geben Sie den Namen, den Anzeigenamen (optional) und die Beschreibung (optional) an.

Führen Sie den Befehl aus:


$ aws proton create-service-template \
    --name "fargate-service" \
    --display-name "Fargate" \
    --description "Fargate-based Service"

Antwort:


{
    "serviceTemplate": {
        "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service",
        "createdAt": "2020-11-11T23:02:55.551000+00:00",
        "description": "Fargate-based Service",
        "displayName": "Fargate",
        "lastModifiedAt": "2020-11-11T23:02:55.551000+00:00",
        "name": "fargate-service"
    }
}

Erstellen Sie eine Service-Vorlage ohne Service-Pipeline.

Fügen Sie --pipeline-provisioning hinzu.

Führen Sie den Befehl aus:


$ aws proton create-service-template \
    --name "fargate-service" \
    --display-name "Fargate" \
    --description "Fargate-based Service" \
    --pipeline-provisioning "CUSTOMER_MANAGED"

Antwort:


{
    "serviceTemplate": {
        "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service",
        "createdAt": "2020-11-11T23:02:55.551000+00:00",
        "description": "Fargate-based Service",
        "displayName": "Fargate",
        "lastModifiedAt": "2020-11-11T23:02:55.551000+00:00",
        "name": "fargate-service",
        "pipelineProvisioning": "CUSTOMER_MANAGED"
    }
}

Erstellen Sie eine Nebenversion 0 der Hauptversion 1 der Servicevorlage.

Geben Sie den Vorlagennamen, die kompatiblen Umgebungsvorlagen, die Hauptversion sowie den Namen und Schlüssel des S3-Buckets für den Bucket an, der Ihr Service-Vorlagenpaket enthält.

Führen Sie den Befehl aus:


$ aws proton create-service-template-version \
    --template-name "fargate-service" \
    --description "Version 1" \
    --source s3="{bucket=your_s3_bucket, key=your_s3_key}" \
    --compatible-environment-templates '[{"templateName":"simple-env","majorVersion":"1"}]'

Antwort:


{
    "serviceTemplateMinorVersion": {
        "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service:1.0",
        "compatibleEnvironmentTemplates": [
            {
                "majorVersion": "1",
                "templateName": "simple-env"
            }
        ],
        "createdAt": "2020-11-11T23:02:57.912000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:02:57.912000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "status": "REGISTRATION_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}

Verwenden Sie den Befehl get, um den Status der Registrierung zu überprüfen.

Führen Sie den Befehl aus:


$ aws proton get-service-template-version \
    --template-name "fargate-service" \
    --major-version "1" \
    --minor-version "0"

Antwort:


{
    "serviceTemplateMinorVersion": {
        "arn": "arn:aws:proton:us-east-1:123456789012:service-template/fargate-service:1.0",
        "compatibleEnvironmentTemplates": [
            {
                "majorVersion": "1",
                "templateName": "simple-env"
            }
        ],
        "createdAt": "2020-11-11T23:02:57.912000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:02:57.912000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "schema": "schema:\n  format:\n    openapi: \"3.0.0\"\n  pipeline_input_type: \"MyPipelineInputType\"\n  service_input_type: \"MyServiceInstanceInputType\"\n\n  types:\n    MyPipelineInputType:\n      type: object\n      description: \"Pipeline input properties\"\n      required:\n        - my_sample_pipeline_required_input\n      properties:\n        my_sample_pipeline_optional_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_sample_pipeline_required_input:\n          type: string\n          description: \"Another sample input\"\n\n    MyServiceInstanceInputType:\n      type: object\n      description: \"Service instance input properties\"\n      required:\n        - my_sample_service_instance_required_input\n      properties:\n        my_sample_service_instance_optional_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_sample_service_instance_required_input:\n          type: string\n          description: \"Another sample input\"",
        "status": "DRAFT",
        "statusMessage": "",
        "templateName": "fargate-service"
    }
}

Veröffentlichen Sie die Dienstvorlage, indem Sie den Befehl update verwenden, um den Status zu ändern"PUBLISHED".

Führen Sie den Befehl aus:


$ aws proton update-service-template-version \
    --template-name "fargate-service" \
    --description "Version 1" \
    --major-version "1" \
    --minor-version "0" \
    --status "PUBLISHED"

Antwort:


{
    "serviceTemplateVersion": {
        "arn": "arn:aws:proton:region-id:123456789012:service-template/fargate-service:1.0",
        "compatibleEnvironmentTemplates": [
            {
                "majorVersion": "1",
                "templateName": "simple-env"
            }
        ],
        "createdAt": "2020-11-11T23:02:57.912000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:02:57.912000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "recommendedMinorVersion": "0",
        "schema": "schema:\n  format:\n    openapi: \"3.0.0\"\n  pipeline_input_type: \"MyPipelineInputType\"\n  service_input_type: \"MyServiceInstanceInputType\"\n\n  types:\n    MyPipelineInputType:\n      type: object\n      description: \"Pipeline input properties\"\n      required:\n        - my_sample_pipeline_required_input\n      properties:\n        my_sample_pipeline_optional_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello pipeline\"\n        my_sample_pipeline_required_input:\n          type: string\n          description: \"Another sample input\"\n\n    MyServiceInstanceInputType:\n      type: object\n      description: \"Service instance input properties\"\n      required:\n        - my_sample_service_instance_required_input\n      properties:\n        my_sample_service_instance_optional_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_sample_service_instance_required_input:\n          type: string\n          description: \"Another sample input\"\n",
        "status": "PUBLISHED",
        "statusMessage": "",
        "templateName": "fargate-service"
    }
}

Überprüfen Sie, ob Version 1.0 veröffentlichtAWS Proton wurde, indem Sie den Befehl get verwenden, um die Detaildaten der Servicevorlage abzurufen.

Führen Sie den Befehl aus:


$ aws proton get-service-template-version \
    --template-name "fargate-service" \
    --major-version "1" \
    --minor-version "0"

Antwort:


{
    "serviceTemplateMinorVersion": {
        "arn": "arn:aws:proton:us-east-1:123456789012:service-template/fargate-service:1.0",
        "compatibleEnvironmentTemplates": [
            {
                "majorVersion": "1",
                "templateName": "simple-env"
            }
        ],
        "createdAt": "2020-11-11T23:02:57.912000+00:00",
        "description": "Version 1",
        "lastModifiedAt": "2020-11-11T23:03:04.767000+00:00",
        "majorVersion": "1",
        "minorVersion": "0",
        "schema": "schema:\n  format:\n    openapi: \"3.0.0\"\n  pipeline_input_type: \"MyPipelineInputType\"\n  service_input_type: \"MyServiceInstanceInputType\"\n\n  types:\n    MyPipelineInputType:\n      type: object\n      description: \"Pipeline input properties\"\n      required:\n        - my_sample_pipeline_required_input\n      properties:\n        my_sample_pipeline_optional_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_sample_pipeline_required_input:\n          type: string\n          description: \"Another sample input\"\n\n    MyServiceInstanceInputType:\n      type: object\n      description: \"Service instance input properties\"\n      required:\n        - my_sample_service_instance_required_input\n      properties:\n        my_sample_service_instance_optional_input:\n          type: string\n          description: \"This is a sample input\"\n          default: \"hello world\"\n        my_sample_service_instance_required_input:\n          type: string\n          description: \"Another sample input\"",
        "status": "PUBLISHED",
        "statusMessage": "",
        "templateName": "fargate-service"
    }
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Versionen

Vorlagen ansehen

Vorlagen registrieren und veröffentlichen

Umgebungsvorlagen registrieren und veröffentlichen

Wichtig

Verwenden Sie die Konsole, um eine neue Umgebungsvorlage zu registrieren und zu veröffentlichen.

Geben Sie einen Pfad zu einem Vorlagenpaket an.

Verwenden Sie die Konsole, um neue Haupt- und Nebenversionen einer Umgebungsvorlage zu registrieren.

Verwenden Sie die CLI, um eine neue Umgebungsvorlage zu registrieren und zu veröffentlichen, wie in den folgenden Schritten gezeigt.

Erstellen Sie eine Nebenversion 0 der Hauptversion 1 der Umgebungsvorlage

Service-Vorlagen registrieren und veröffentlichen

Verwenden Sie die Konsole, um eine neue Service-Vorlage zu registrieren und zu veröffentlichen.

Geben Sie einen Pfad zu einem Vorlagenpaket an.

Verwenden Sie die Konsole, um neue Haupt- und Nebenversionen einer Service-Vorlage zu registrieren.

Anmerkung

Verwenden Sie die CLI, um eine neue Service-Vorlage mit oder ohne Service-Pipeline zu registrieren und zu veröffentlichen, wie in den folgenden Schritten gezeigt.

Erstellen Sie mithilfe der CLI eine Service-Vorlage mit einer Service-Pipeline.

Erstellen Sie eine Service-Vorlage ohne Service-Pipeline.

Erstellen Sie eine Nebenversion 0 der Hauptversion 1 der Servicevorlage.