Veröffentlichen Sie Umgebungsvorlagen Veröffentlichen Sie Servicevorlagen

Vorlagen registrieren und veröffentlichen

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

Sie können eine neue Version einer Vorlage mit der Konsole oder erstellen AWS CLI.

Alternativ können Sie die Konsole verwenden oder AWS CLI um eine Vorlage zu erstellen und eine Vorlagensynchronisierung dafür zu konfigurieren und zu konfigurieren. Diese Konfiguration ermöglicht die AWS Proton Synchronisierung anhand von Vorlagenpaketen, 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 deines Templates erstellt, sofern die Version noch nicht existiert. Weitere Informationen zu den Voraussetzungen und Anforderungen für die Konfiguration der Template-Sync finden Sie unterKonfigurationen für die Vorlagensynchronisierung.

Registrieren und veröffentlichen Sie Umgebungsvorlagen

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

Registrieren und veröffentlichen Sie eine Standardumgebungsvorlage, die zur Bereitstellung und Verwaltung der Umgebungsinfrastruktur AWS Proton verwendet wird.
Registrieren und veröffentlichen Sie eine Vorlage für eine vom Kunden verwaltete Umgebung, die AWS Proton verwendet wird, um eine Verbindung zu Ihrer vorhandenen bereitgestellten Infrastruktur herzustellen, die Sie verwalten. AWS Proton verwaltet 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 Proton kann Änderungen in Ihrem Namen nicht berücksichtigen, da diese Änderungen für Sie nicht sichtbar sind. AWS Proton Inkonsistenzen führen zu Fehlern.

Sie können die Konsole oder die verwenden, um eine Umgebungsvorlage AWS CLI 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 Proton Konsole Umgebungsvorlagen aus.
Wählen Sie Umgebungsvorlage erstellen aus.
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 für die Verwendung der bereitgestellten Infrastruktur, 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 Quelloptionen für das Vorlagenpaket aus. Weitere Informationen zu den Anforderungen und Voraussetzungen für die Synchronisierung von Vorlagen finden Sie unter. Konfigurationen für die Vorlagensynchronisierung
- Verwenden Sie eines unserer Beispiel-Vorlagenpakete.
- Verwenden Sie Ihr eigenes Vorlagenpaket.
- Synchronisieren Sie Vorlagen von Git.
Geben Sie einen Pfad zu einem Vorlagenpaket an.
1. Wenn Sie eines unserer Beispiel-Vorlagenpakete verwenden ausgewählt haben:
  
  Wählen Sie im Abschnitt Mustervorlagenpaket ein Mustervorlagenpaket 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 Template-Synchronisierungskonfiguration 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 Namen für die Vorlage ein.
2. (Optional) Geben Sie einen Anzeigenamen für die Vorlage ein.
3. (Optional) Geben Sie eine Vorlagenbeschreibung für die Umgebungsvorlage ein.
(Optional) Aktivieren Sie im Abschnitt Verschlüsselungseinstellungen das Kontrollkästchen Verschlüsselungseinstellungen anpassen (erweitert), um Ihren eigenen Verschlüsselungsschlüssel anzugeben.
(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.
Wählen Sie „Umgebungsvorlage erstellen“.

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 von AWS und vom Kunden verwaltete Tags. AWS Proton generiert automatisch AWS verwaltete Tags für Sie, wenn Sie AWS Proton Ressourcen erstellen. Weitere Informationen finden Sie unter AWS Proton Ressourcen und Tagging.
Der Status einer neuen Umgebungsvorlage beginnt im Status Entwurf. Sie und andere Personen mit proton:CreateEnvironment entsprechenden Berechtigungen können sie anzeigen und darauf zugreifen. Folgen Sie dem nächsten Schritt, um die Vorlage für andere verfügbar zu machen.
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 in der Informationswarnung die Option Veröffentlichen auswä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 Proton Konsole 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 Version der Umgebungsvorlage erstellen im Abschnitt Quelle des Vorlagenpakets eine der beiden verfügbaren Quelloptionen für das Vorlagenpaket aus.
- Verwenden Sie eines unserer Beispiel-Template-Bundles.
- Verwenden Sie Ihr eigenes Vorlagenpaket.
Geben Sie einen Pfad zum ausgewählten Vorlagenpaket an.
- Wenn Sie Eines unserer Mustervorlagenpakete verwenden ausgewählt haben, wählen Sie im Abschnitt Beispielvorlagenpaket ein Mustervorlagenpaket aus.
- Wenn Sie Ihr eigenes Vorlagenpaket verwenden ausgewählt haben, wählen Sie im Abschnitt Speicherort des S3-Pakets den Pfad zu Ihrem Vorlagenpaket aus.
Im Abschnitt Vorlagendetails.
1. (Optional) Geben Sie einen Anzeigenamen für die Vorlage ein.
2. (Optional) Geben Sie eine Vorlagenbeschreibung für die Dienstvorlage ein.
Wählen Sie im Abschnitt Vorlagendetails eine der folgenden Optionen aus.
- Um eine Nebenversion zu erstellen, lassen Sie das Kontrollkästchen Aktivieren, 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 aus.

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 oder vom Kunden verwaltete Umgebungsvorlage, indem Sie die Region, den Namen, den Anzeigenamen (optional) und die Beschreibung (optional) angeben.

Erstellen Sie eine Standardumgebungsvorlage.

Führen Sie den folgenden 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 vom Kunden verwaltete Umgebungsvorlage, indem Sie den provisioning Parameter mit Wert hinzufügenCUSTOMER_MANAGED.

Führen Sie den folgenden 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 standardmäßigen und kundenverwalteten Umgebungsvorlagen identisch.

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

Führen Sie den folgenden 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 Registrierungen zu überprüfen.

Führen Sie den folgenden 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öffentlichung der Nebenversion 0 der Hauptversion 1 der Umgebungsvorlage unter Angabe des Vorlagennamens sowie der Haupt- und Nebenversion. Diese Version ist die Recommended Version.

Führen Sie den folgenden 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 haben AWS CLI, können Sie eine Liste mit AWS und vom Kunden verwalteten Tags anzeigen. AWS Proton generiert automatisch AWS verwaltete Tags für Sie. Mit dem können Sie auch vom Kunden verwaltete Tags ändern und erstellen AWS CLI. Weitere Informationen finden Sie unter AWS Proton Ressourcen und Tagging.

Führen Sie den folgenden Befehl aus:


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

Registrieren und veröffentlichen Sie Servicevorlagen

Wenn Sie eine Service-Vorlagenversion erstellen, geben Sie eine Liste kompatibler Umgebungsvorlagen an. Auf diese Weise haben Entwickler bei der Auswahl einer Dienstvorlage Optionen dafür, in welcher Umgebung sie ihren Dienst bereitstellen möchten.

Stellen Sie vor dem Erstellen eines Dienstes anhand einer Dienstvorlage oder vor dem Veröffentlichen einer Dienstvorlage sicher, dass die 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 aus 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 verwenden AWS CLI , um eine Dienstvorlage zu registrieren und zu veröffentlichen.

AWS Management Console

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

Wählen Sie in der AWS Proton Konsole Service Templates aus.
Wählen Sie Dienstvorlage erstellen aus.
Wählen Sie auf der Seite „Dienstvorlage erstellen“ im Abschnitt „Quelle des Vorlagenpakets“ eine der verfügbaren Vorlagenoptionen aus.
- Verwenden Sie Ihr eigenes Vorlagenpaket.
- Synchronisieren Sie Vorlagen von Git.
Geben Sie einen Pfad zu einem Vorlagenpaket an.
1. Wenn du Vorlagen von Git synchronisieren ausgewählt hast, gehe im Abschnitt Quellcode-Repository wie folgt vor:
  1. Wählen Sie das Repository für Ihre Konfiguration zur Vorlagensynchronisierung 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 Namen für die Vorlage ein.
2. (Optional) Geben Sie einen Anzeigenamen für die Vorlage ein.
3. (Optional) Geben Sie eine Vorlagenbeschreibung für die Dienstvorlage 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) aus, um Ihren eigenen Verschlüsselungsschlüssel anzugeben.
(Optional) Gehen Sie im Abschnitt Pipeline wie folgt vor:

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 Dienstvorlage 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 Dienstinstanzen zu ermöglichen.
(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.
Wählen Sie „Servicevorlage erstellen“ aus.

Sie befinden sich jetzt auf einer neuen Seite, auf der der Status und die Details für Ihre neue Servicevorlage angezeigt werden. Zu diesen Details gehören eine Liste von AWS und vom Kunden verwaltete Tags. AWS Proton generiert automatisch AWS verwaltete Tags für Sie, wenn Sie AWS Proton Ressourcen erstellen. Weitere Informationen finden Sie unter AWS Proton Ressourcen und Tagging.
Der Status einer neuen Dienstvorlage beginnt im Status Entwurf. Sie und andere Personen mit proton:CreateService entsprechenden Berechtigungen können die Datei anzeigen und darauf zugreifen. Folgen Sie dem nächsten Schritt, um die Vorlage für andere verfügbar zu machen.
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 in der Informationswarnung die Option Veröffentlichen auswä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 Dienstvorlagen und Details anzuzeigen.

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

Weitere Informationen finden Sie unter Versionierte Vorlagen.

Wählen Sie in der AWS Proton Konsole Service Templates aus.
Wählen Sie in der Liste der Dienstvorlagen den Namen der Dienstvorlage aus, für die Sie eine Haupt- oder Nebenversion erstellen möchten.
Wählen Sie in der Detailansicht der Servicevorlage 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 Speicherort des S3-Bundles den Pfad zu Ihrem Vorlagenpaket aus.
Im Abschnitt Vorlagendetails.
1. (Optional) Geben Sie einen Anzeigenamen für die Vorlage ein.
2. (Optional) Geben Sie eine Vorlagenbeschreibung für die Dienstvorlage ein.
Wählen Sie im Abschnitt Vorlagendetails eine der folgenden Optionen aus.
- Um eine Nebenversion zu erstellen, lassen Sie das Kontrollkästchen Aktivieren, 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 aus.

AWS CLI

Um eine Dienstvorlage zu erstellen, die einen Service ohne Service-Pipeline bereitstellt, fügen Sie dem create-service-template Befehl den Parameter und den Wert --pipeline-provisioning "CUSTOMER_MANAGED" hinzu. Konfigurieren Sie Ihre Vorlagenpakete wie unter Vorlagenpakete Erstellung und beschrieben. Schemaanforderungen für Service-Vorlagen-Pakete

Anmerkung

pipelineProvisioningNachdem die Dienstvorlage erstellt wurde, können Sie sie nicht mehr ändern.

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

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

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

Führen Sie den folgenden 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 Dienstvorlage ohne Dienstpipeline.

Fügen Sie --pipeline-provisioning hinzu.

Führen Sie den folgenden 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 Dienstvorlage.

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

Führen Sie den folgenden 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 Registrierungen zu überprüfen.

Führen Sie den folgenden 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 zu "PUBLISHED" ändern.

Führen Sie den folgenden 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öffentlicht AWS Proton wurde, indem Sie den Befehl get verwenden, um die Detaildaten der Service-Vorlage abzurufen.

Führen Sie den folgenden 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 anzeigen

Vorlagen registrieren und veröffentlichen

Registrieren und veröffentlichen Sie Umgebungsvorlagen

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

Registrieren und veröffentlichen Sie Servicevorlagen

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

Geben Sie einen Pfad zu einem Vorlagenpaket an.

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

Anmerkung

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

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

Erstellen Sie eine Dienstvorlage ohne Dienstpipeline.

Erstellen Sie eine Nebenversion 0 der Hauptversion 1 der Dienstvorlage.