Erste Schritte mit AWS Management Console

Erste Schritte mit AWS Proton

• Erstellen Sie eine Umgebungsvorlage und zeigen Sie sie an.

• Erstellen, Anzeigen und Veröffentlichen einer Dienstvorlage, die die Umgebungsvorlage verwendet, die Sie gerade erstellt haben.

• Erstellen Sie eine Umgebung und einen Dienst (optional).

• Löschen Sie die Dienstvorlage, die Umgebungsvorlage, die Umgebung und den Dienst, falls sie erstellt wurden.

Schritt 1: Öffnen Sie die AWS Proton Konsole

• Öffnen Sie die AWS Proton-Konsole.

Schritt 2: Bereiten Sie sich auf die Verwendung der Beispielvorlagen vor

1. Erstellen Sie eine Codestar-Verbindung zu Github und benennen Sie die Verbindung. my-proton-connection

2. Navigieren Sie zu https://github.com/aws-samples/aws-proton-cloudformation-sample-templates

3. Erstelle einen Fork des Repositorys in deinem Github-Konto.

Schritt 3: Erstellen Sie eine Umgebungsvorlage

Wählen Sie im Navigationsbereich die Option Umgebungsvorlagen aus.

1. Wählen Sie auf der Seite Umgebungsvorlagen die Option Umgebungsvorlage erstellen aus.

2. Wählen Sie auf der Seite Umgebungsvorlage erstellen im Abschnitt Vorlagenoptionen die Option Vorlage für die Bereitstellung neuer Umgebungen erstellen aus.

3. Wählen Sie im Abschnitt Quelle des Vorlagenpakets die Option Ein Vorlagenpaket aus Git synchronisieren aus.

4. Wählen Sie im Abschnitt Repository für Vorlagendefinitionen die Option Ein verknüpftes Git-Repository auswählen aus.

5. Wählen Sie my-proton-connectionaus der Repository-Liste aus.

6. Wählen Sie main aus der Branch-Liste aus.

7. Im Abschnitt Details zur Proton-Umgebungsvorlage.

   1. Geben Sie den Vorlagennamen als fargate-env ein.

   2. Geben Sie den Anzeigenamen der Umgebungsvorlage als einMy Fargate Environment.

   3. (Optional) Geben Sie eine Beschreibung für die Umgebungsvorlage ein.

8. (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.

9. 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 Protongeneriert automatisch AWS verwaltete Tags für Sie, wenn Sie AWS Proton Ressourcen erstellen. Weitere Informationen finden Sie unter AWS ProtonRessourcen und Tagging.

10. 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.

11. 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-Banner die Option Veröffentlichen auswählen und den nächsten Schritt überspringen.

12. Wählen Sie im Abschnitt Vorlagenversionen die Option Veröffentlichen aus.

13. 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.

14. Wählen Sie im Navigationsbereich die Option Umgebungsvorlagen aus.

    Auf einer neuen Seite wird eine Liste Ihrer Umgebungsvorlagen zusammen mit Vorlagendetails angezeigt.

Schritt 4: Erstellen Sie eine Dienstvorlage

Erstellen Sie eine Dienstvorlage.

1. Wählen Sie im Navigationsbereich die Option Dienstvorlagen aus.

2. Wählen Sie auf der Seite mit den Dienstvorlagen die Option Dienstvorlage erstellen aus.

3. Wählen Sie auf der Seite Dienstvorlage erstellen im Abschnitt Quelle des Vorlagenpakets die Option Vorlagenpaket aus Git synchronisieren aus.

4. Wählen Sie im Abschnitt Vorlage die Option Ein verknüpftes Git-Repository auswählen aus.

5. Wählen Sie my-proton-connectionaus der Repository-Liste aus.

6. Wählen Sie main aus der Branch-Liste aus.

7. Im Abschnitt Details zur Proton-Servicevorlage.

   1. Geben Sie den Namen der Dienstvorlage als backend-fargate-svc ein.

   2. Geben Sie den Anzeigenamen der Dienstvorlage als einMy Fargate Service.

   3. (Optional) Geben Sie eine Beschreibung für die Dienstvorlage ein.

8. Im Abschnitt Kompatible Umgebungsvorlagen.

   1. Aktivieren Sie das Kontrollkästchen links neben der Umgebungsvorlage My Fargate Environment, um die kompatible Umgebungsvorlage für die neue Dienstvorlage auszuwählen.

9. Behalten Sie für die Verschlüsselungseinstellungen die Standardeinstellungen bei.

10. Im Abschnitt Pipeline-Definition.

    1. Lassen Sie die Schaltfläche Diese Vorlage enthält eine CI/CD-Pipeline ausgewählt.

11. Wählen Sie Dienstvorlage erstellen aus.

    Sie befinden sich jetzt auf einer neuen Seite, auf der der Status und die Details für Ihre neue Servicevorlage angezeigt werden, einschließlich einer Liste von AWS und vom Kunden verwalteten Tags.

12. Der Status einer neuen Servicevorlage beginnt im Status Entwurf. Nur Administratoren können sie anzeigen und darauf zugreifen. Gehen Sie wie folgt vor, um die Dienstvorlage Entwicklern zur Verfügung zu stellen.

13. 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-Banner die Option Veröffentlichen auswählen und den nächsten Schritt überspringen.

14. Wählen Sie im Abschnitt Vorlagenversionen die Option Veröffentlichen aus.

15. Der Status der Vorlage ändert sich in Veröffentlicht.

    Die erste Nebenversion Ihrer Service-Vorlage ist veröffentlicht und steht Entwicklern zur Verwendung zur Verfügung. Da es sich um die neueste Version der Vorlage handelt, handelt es sich um die empfohlene Version.

16. Wählen Sie im Navigationsbereich die Option Dienstvorlagen aus.

    Auf einer neuen Seite wird eine Liste Ihrer Dienstvorlagen und Details angezeigt.

Schritt 5: Erstellen Sie eine Umgebung

Wählen Sie im Navigationsbereich Environments (Umgebungen) aus.

1. Wählen Sie Create environment (Umgebung erstellen) aus.

2. Wählen Sie auf der Seite Umgebungsvorlage auswählen die Vorlage aus, die Sie gerade erstellt haben. Es heißt My Fargate Environment. Wählen Sie dann Configure.

3. Wählen Sie auf der Seite Umgebung konfigurieren im Abschnitt Provisioning die Option Bereitstellung durch AWS Proton aus.

4. Wählen Sie im Abschnitt Bereitstellungskonto die Option Dies AWS-Konto aus.

5. Geben Sie unter Umgebungseinstellungen den Namen der Umgebung als einmy-fargate-environment.

6. Wählen Sie im Abschnitt Umgebungsrollen die Option Neue Servicerolle oder, falls Sie bereits eine AWS Proton Servicerolle erstellt haben, die Option Bestehende Servicerolle aus.

   1. Wählen Sie Neue Servicerolle aus, um eine neue Rolle zu erstellen.

      1. Geben Sie den Namen der Umgebungsrolle als einMyProtonServiceRole.

      2. Aktivieren Sie das Kontrollkästchen, um der Erstellung einer AWS Proton Servicerolle mit Administratorrechten für Ihr Konto zuzustimmen.

   2. Wählen Sie Bestehende Servicerolle aus, um eine bestehende Rolle zu verwenden.

      1. Wählen Sie Ihre Rolle im Dropdownfeld Name der Umgebungsrolle aus.

7. Wählen Sie Weiter aus.

8. Verwenden Sie auf der Seite Benutzerdefinierte Einstellungen konfigurieren die Standardeinstellungen.

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

10. Wählen Sie Erstellen aus.

    Sehen Sie sich die Umgebungsdetails und den Status sowie die AWS verwalteten und vom Kunden verwalteten Tags für Ihre Umgebung an.

11. Wählen Sie im Navigationsbereich Environments (Umgebungen) aus.

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

Schritt 6: Optional — Erstellen Sie einen Dienst und stellen Sie eine Anwendung bereit

1. Öffnen Sie die AWS Proton-Konsole.

2. Wählen Sie im Navigationsbereich Dienste aus.

3. Wählen Sie auf der Seite Dienste die Option Dienst erstellen aus.

4. Wählen Sie auf der Seite Servicevorlage auswählen die Vorlage My Fargate Service aus, indem Sie auf das Optionsfeld in der oberen rechten Ecke der Vorlagenkarte klicken.

5. Wählen Sie in der unteren rechten Ecke der Seite die Option Konfigurieren aus.

6. Geben Sie auf der Seite Dienst konfigurieren im Abschnitt Diensteinstellungen den Dienstnamen einmy-service.

7. (Optional) Geben Sie eine Beschreibung für den Dienst ein.

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

   1. Wählen Sie für die CodeStar Verbindung Ihre Verbindung aus der Liste aus.

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

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

9. (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 anschließend Next (Weiter).

10. Folgen Sie auf der Seite Benutzerdefinierte Einstellungen konfigurieren im Abschnitt Serviceinstanzen im Abschnitt Neue Instanz den nächsten Schritten, um benutzerdefinierte Werte für Ihre Service-Instance-Parameter anzugeben.

    1. Geben Sie den Instanznamen einmy-app-service.

    2. Wählen Sie die Umgebung my-fargate-environment für Ihre Dienstinstanz aus.

    3. Behalten Sie die Standardeinstellungen für die verbleibenden Instanzparameter bei.

    4. Behalten Sie die Standardeinstellungen für Pipeline-Eingaben bei.

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

    6. Wählen Sie Erstellen und sehen Sie sich Ihren Servicestatus und die Details an.

11. Auf der Seite mit den Servicedetails können Sie den Status Ihrer Serviceinstanz und Pipeline einsehen, indem Sie die Registerkarten Übersicht und Pipeline auswählen. Auf diesen Seiten können Sie auch Tags einsehen AWS und vom Kunden verwalten. AWS Protonerstellt automatisch AWS verwaltete Tags für Sie. Wählen Sie Tags verwalten, um vom Kunden verwaltete Tags zu erstellen und zu ändern. Weitere Informationen über das Markieren mit Tags finden Sie unter AWS ProtonRessourcen und Tagging.

12. Wenn der Service aktiv ist, wählen Sie auf der Registerkarte Overview im Abschnitt Service Instances den Namen Ihrer Dienstinstanz aus my-app-service.

    Sie befinden sich jetzt auf der Detailseite der Service-Instanz.

13. Um Ihre Anwendung anzuzeigen, kopieren Sie im Abschnitt Ausgaben den ServiceEndpointLink in Ihren Browser.

    Sie sehen eine AWS Proton Grafik auf der Webseite.

14. Nachdem der Dienst erstellt wurde, wählen Sie im Navigationsbereich Dienste aus, um eine Liste Ihrer Dienste anzuzeigen.

Schritt 7: Aufräumen.

1. Öffnen Sie die AWS Proton-Konsole.

2. Löschen Sie einen Dienst (falls Sie einen erstellt haben)

   1. Wählen Sie im Navigationsbereich Dienste aus.

   2. Wählen Sie auf der Seite Dienste den Dienstnamen my-service aus.

      Sie befinden sich jetzt auf der Seite mit den Servicedetails für my-service.

   3. Wählen Sie in der oberen rechten Ecke der Seite Aktionen und dann Löschen aus.

   4. In einem Modal werden Sie aufgefordert, die Löschaktion zu bestätigen.

   5. Folgen Sie den Anweisungen und wählen Sie Ja, löschen.

3. Lösche eine Umgebung

   1. Wählen Sie im Navigationsbereich Environments (Umgebungen) aus.

   2. Wählen Sie auf der Seite Umgebungen das Optionsfeld links neben der Umgebung aus, die Sie gerade erstellt haben.

   3. Wählen Sie „Aktionen“ und dann „Löschen“.

   4. In einem Modal werden Sie aufgefordert, die Löschaktion zu bestätigen.

   5. Folgen Sie den Anweisungen und wählen Sie Ja, löschen.

4. Löschen Sie eine Dienstvorlage

   1. Wählen Sie im Navigationsbereich die Option Dienstvorlagen aus.

   2. Wählen Sie auf der Seite mit den Dienstvorlagen das Optionsfeld links neben der Dienstvorlage aus my-svc-template.

   3. Wählen Sie „Aktionen“ und dann „Löschen“.

   4. In einem Modal werden Sie aufgefordert, die Löschaktion zu bestätigen.

   5. Folgen Sie den Anweisungen und wählen Sie Ja, löschen. Dadurch werden die Dienstvorlage und alle ihre Versionen gelöscht.

5. Löscht eine Umgebungsvorlage

   1. Wählen Sie im Navigationsbereich die Option Umgebungsvorlagen aus.

   2. Wählen Sie auf der Seite mit den Umgebungsvorlagen das Optionsfeld links neben aus my-env-template.

   3. Wählen Sie „Aktionen“ und dann „Löschen“.

   4. In einem Modal werden Sie aufgefordert, die Löschaktion zu bestätigen.

   5. Folgen Sie den Anweisungen und wählen Sie Ja, löschen. Dadurch werden die Umgebungsvorlage und alle ihre Versionen gelöscht.

6. Löschen Sie Ihre Codestar-Verbindung