Einen Service erstellen - AWS Proton
Was ist in einem Service enthalten?ServicevorlagenEinen Service erstellen

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.

Einen Service erstellen

Um eine Anwendung bereitzustellenAWS Proton, erstellen Sie als Entwickler einen Dienst und geben die folgenden Eingaben ein.

  1. Der Name einerAWS Proton Service-Vorlage, die vom Plattformteam veröffentlicht wurde.

  2. Ein Name für den Service.

  3. Die Anzahl der Service-Instances, die Sie bereitstellen möchten.

  4. Eine Auswahl von Umgebungen, die Sie verwenden möchten.

  5. Eine Verbindung zu Ihrem Code-Repository, wenn Sie eine Service-Vorlage verwenden, die eine Service-Pipeline enthält (optional).

Was ist in einem Service enthalten?

Wenn Sie einenAWS Proton Service erstellen, können Sie aus zwei verschiedenen Typen von Servicevorlagen wählen:

  • Eine Service-Vorlage, die eine Service-Pipeline enthält (Standard).

  • Eine Service-Vorlage, die keine Service-Pipeline enthält.

Sie müssen mindestens eine Service-Instance erstellen, wenn Sie Ihren Service erstellen.

Eine Dienstinstanz und eine optionale Pipeline sind einem Dienst zugeordnet. Sie können eine Pipeline nur im Zusammenhang mit Aktionen zum Erstellen und Löschen von Diensten erstellen oder löschen. Wie Sie Instances zu einem Service hinzufügen und daraus entfernen, erfahren Sie unterDienst bearbeiten.

Anmerkung

Ihre Umgebung ist entweder für die Bereitstellung oderAWS für die selbstverwaltete Bereitstellung konfiguriert. AWS Protonstellt Dienste in einer Umgebung bereit, die dieselbe Bereitstellungsmethode wie die Umgebung verwendet. Der Entwickler, der Service-Instanzen erstellt oder aktualisiert, sieht den Unterschied nicht und seine Erfahrung ist in beiden Fällen dieselbe.

Weitere Informationen zu Bereitstellungsmethoden finden Sie unterWie stellt AWS Proton die Infrastruktur bereit.

Servicevorlagen

Es sind sowohl Haupt- als auch Nebenversionen von Service-Templates verfügbar. Wenn Sie die Konsole verwenden, wählen Sie die neuesteRecommended Haupt- und Nebenversion der Service-Vorlage aus. Wenn Sie das verwendenAWS CLI und nur die Hauptversion der Service-Vorlage angeben, geben Sie implizit die neuesteRecommended Nebenversion an.

Im Folgenden werden der Unterschied zwischen Haupt- und Nebenversionen der Vorlagen und deren Verwendung beschrieben.

  • Neue Versionen einer Vorlage werden verfügbar,Recommended sobald sie von einem Mitglied des Plattformteams genehmigt wurden. Das bedeutet, dass neue Dienste mit dieser Version erstellt werden und Sie aufgefordert werden, vorhandene Dienste auf die neue Version zu aktualisieren.

  • DadurchAWS Proton kann das Plattformteam Service-Instanzen automatisch auf eine neue Nebenversion einer Service-Vorlage aktualisieren. Kleinere Versionen müssen abwärtskompatibel sein.

  • Da bei Hauptversionen im Rahmen des Aktualisierungsprozesses neue Eingaben erforderlich sind, müssen Sie Ihren Service auf eine Hauptversion seiner Service-Vorlage aktualisieren. Hauptversionen sind nicht abwärtskompatibel.

Einen Service erstellen

Die folgenden Verfahren zeigen, wie Sie dieAWS Proton Konsole verwenden oderAWS CLI einen Dienst mit oder ohne Service-Pipeline erstellen.

AWS Management Console
Erstellen Sie einen Dienst, wie in den folgenden Konsolenschritten gezeigt.

  1. Wählen Sie in der AWS ProtonKonsole Dienste aus.

  2. Wählen Sie Create service.

  3. Wählen Sie auf der Seite „Dienstvorlage auswählen“ eine Vorlage aus und wählen Sie „Konfigurieren“.

    Wenn Sie keine aktivierte Pipeline verwenden möchten, wählen Sie eine Vorlage aus, die mit Excludes-Pipeline für Ihren Service gekennzeichnet ist.

  4. Geben Sie auf der Seite Dienst konfigurieren im Abschnitt Diensteinstellungen einen Dienstnamen ein.

  5. (Optional) Geben Sie eine Beschreibung für den Service ein.

  6. Gehen Sie im Abschnitt Einstellungen für das Service-Repository wie folgt vor:

    1. Wählen Sie unter CodeStar Verbindung Ihre Verbindung aus der Liste aus.

    2. Wählen Sie als Repository-ID den Namen Ihres Quellcode-Repositorys aus der Liste aus.

    3. Wählen Sie als Branch-Name den Namen Ihres Quellcode-Repository-Zweigs aus der Liste aus.

  7. (Optional) Wählen Sie im Abschnitt „Stichwörter“ die Option „Neuen Tag hinzufügen“ und geben Sie einen Schlüssel und einen Wert ein, um ein vom Kunden verwaltetes Tag zu erstellen.

  8. Wählen Sie Next (Weiter).

  9. Auf der Seite Benutzerdefinierte Einstellungen konfigurieren, im Abschnitt Dienstinstanzen, im Abschnitt Neue Instanz. Sie müssen Werte für dierequired Parameter eingeben. Sie können Werte für dieoptional Parameter eingeben oder die Standardwerte verwenden, sofern angegeben.

  10. Im Abschnitt Pipeline-Eingaben müssen Sie Werte für dierequired Parameter eingeben. Sie können Werte für dieoptional Parameter eingeben oder die Standardwerte verwenden, sofern angegeben.

  11. Wählen Sie Weiter und überprüfen Sie Ihre Eingaben.

  12. Wählen Sie Create (Erstellen) aus.

    Sehen Sie sich die Servicedetails und den Status sowie dieAWS verwalteten Tags und vom Kunden verwalteten Tags für Ihren Service an.

  13. Wählen Sie im Navigationsbereich -Services aus.

    Auf einer neuen Seite wird eine Liste Ihrer Dienste zusammen mit dem Status und anderen Servicedetails angezeigt.

AWS CLI

Wenn Sie den verwendenAWS CLI, geben Sie Diensteingaben in einer YAML-formatiertenspec Datei an.aws-proton/service.yaml, die sich in Ihrem Quellcodeverzeichnis befindet.

Sie können denget-service-template-minor-version CLI-Befehl verwenden, um das erforderliche Schema und die optionalen Parameter anzuzeigen, für die Sie Werte in Ihrer Spezifikationsdatei angeben.

Wenn Sie eine Service-Vorlage verwenden möchten, die hatpipelineProvisioning: "CUSTOMER_MANAGED", nehmen Sie denpipeline: Abschnitt nicht in Ihre Spezifikation auf und schließen -repository-connection-arnSie keine-branch-name Parameter in Ihrencreate-service Befehl ein.-repository-id

Erstellen Sie einen Service mit einer Service-Pipeline, wie in den folgenden CLI-Schritten gezeigt.

  1. Richten Sie die Servicerolle für die Pipeline ein, wie im folgenden CLI-Beispielbefehl gezeigt.

    Befehl:

    $ aws proton update-account-settings \
        --pipeline-service-role-arn "arn:aws:iam::123456789012:role/AWSProtonServiceRole"

  2. Die folgende Liste zeigt eine Beispielspezifikation, die auf dem Service-Template-Schema basiert und die Service-Pipeline und Instanzeingaben enthält.

    Spezifikation:

    proton: ServiceSpec

pipeline:
  my_sample_pipeline_required_input: "hello"
  my_sample_pipeline_optional_input: "bye"

instances:
  - name: "acme-network-dev"
    environment: "ENV_NAME"
    spec:
      my_sample_service_instance_required_input: "hi"
      my_sample_service_instance_optional_input: "ho"

    Erstellen Sie einen Dienst mit einer Pipeline, wie im folgenden CLI-Beispiel für Befehl und Antwort gezeigt.

    Befehl:

    $ aws proton create-service \
        --name "MySimpleService" \
        --branch-name "mainline" \
        --template-major-version "1" \
        --template-name "fargate-service" \
        --repository-connection-arn "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
        --repository-id "myorg/myapp" \
        --spec "file://spec.yaml"

    Antwort:

    {
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "createdAt": "2020-11-18T19:50:27.460000+00:00",
        "lastModifiedAt": "2020-11-18T19:50:27.460000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "myorg/myapp",
        "status": "CREATE_IN_PROGRESS",
        "templateName": "fargate-service"
    }
}

Erstellen Sie einen Dienst ohne Service-Pipeline, wie im folgenden CLI-Beispiel für Befehl und Antwort gezeigt.

Im Folgenden wird eine Beispielspezifikation gezeigt, die keine Service-Pipeline-Eingaben enthält.

Spezifikation:

proton: ServiceSpec

instances:
  - name: "acme-network-dev"
    environment: "ENV_NAME"
    spec:
      my_sample_service_instance_required_input: "hi"
      my_sample_service_instance_optional_input: "ho"

Um einen Service ohne bereitgestellte Service-Pipeline zu erstellen, geben Sie den Pfad zu einemspec.yaml und Sie schließen keine Repository-Parameter ein, wie im folgenden CLI-Beispiel für Befehl und Antwort gezeigt.

Befehl:

$ aws proton create-service \
        --name "MySimpleServiceNoPipeline" \
        --template-major-version "1" \
        --template-name "fargate-service" \
        --spec "file://spec-no-pipeline.yaml"

Antwort:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleServiceNoPipeline",
        "createdAt": "2020-11-18T19:50:27.460000+00:00",
        "lastModifiedAt": "2020-11-18T19:50:27.460000+00:00",
        "name": "MySimpleServiceNoPipeline",
        "status": "CREATE_IN_PROGRESS",
        "templateName": "fargate-service-no-pipeline"
    }
}