Tutorial: Eine Anwendung auf Amazon bereitstellen ECS

Um einen IAM Identity Center-Benutzer zu erstellen

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die AWS IAM Identity Center Konsole unter https://console.aws.amazon.com/singlesignon/.

   Anmerkung

   Stellen Sie sicher, dass Sie sich mit dem anmelden AWS-Konto , der mit Ihrem CodeCatalyst Bereich verbunden ist. Du kannst überprüfen, welches Konto verbunden ist, indem du zu deinem Bereich navigierst und den Tab AWSKonten auswählst. Weitere Informationen finden Sie unter Einen Raum schaffen.

2. Wählen Sie im Navigationsbereich Users (Benutzer) und dann Add User (Benutzer hinzufügen) aus.

3. Geben Sie im Feld Nutzername Folgendes ein:

   CodeCatalystECSUser

4. Wählen Sie unter Passwort die Option Einmalpasswort generieren aus, das Sie mit diesem Benutzer teilen können.

5. Geben Sie in den Feldern E-Mail-Adresse und E-Mail-Adresse bestätigen eine E-Mail-Adresse ein, die noch nicht in IAM Identity Center vorhanden ist.

6. Geben Sie in die Felder Vorname und Nachname Folgendes ein:

   CodeCatalystECSUser

7. Behalten Sie im Feld Anzeigename den automatisch generierten Namen bei:

   CodeCatalystECSUser CodeCatalystECSUser

8. Wählen Sie Weiter aus.

9. Wählen Sie auf der Seite „Benutzer zu Gruppen hinzufügen“ die Option Weiter aus.

10. Überprüfen Sie auf der Seite Benutzer überprüfen und hinzufügen die Informationen und wählen Sie Benutzer hinzufügen aus.

    Ein Dialogfeld mit einem Einmalkennwort wird angezeigt.

11. Wählen Sie Kopieren und fügen Sie dann die Anmeldeinformationen ein, einschließlich des AWS Zugriffsportals URL und des Einmalkennworts.

12. Klicken Sie auf Schließen.

So erstellen Sie einen Berechtigungssatz

Sie weisen diesen Berechtigungssatz einem CodeCatalystECSUser späteren Zeitpunkt zu.

1. Wählen Sie im Navigationsbereich die Option Berechtigungssätze und dann Berechtigungssatz erstellen aus.

2. Wählen Sie Vordefinierter Berechtigungssatz und dann aus AdministratorAccess. Diese Richtlinie gewährt allen volle Berechtigungen AWS-Services.

3. Wählen Sie Weiter aus.

4. Geben Sie im Feld Name des Berechtigungssatzes Folgendes ein:

   CodeCatalystECSPermissionSet

5. Wählen Sie Weiter aus.

6. Überprüfen Sie auf der Seite Überprüfen und erstellen die Informationen und wählen Sie Erstellen aus.

Um den Berechtigungssatz zuzuweisen CodeCatalyst ECSUser

1. Wählen Sie im Navigationsbereich das Kontrollkästchen neben dem aus AWS-Konten, bei dem Sie derzeit angemeldet sind AWS-Konto , und aktivieren Sie es anschließend.

2. Wählen Sie Benutzer oder Gruppen zuweisen aus.

3. Wählen Sie die Registerkarte Users.

4. Aktivieren Sie das Kontrollkästchen nebenCodeCatalystECSUser.

5. Wählen Sie Weiter aus.

6. Aktivieren Sie das Kontrollkästchen nebenCodeCatalystECSPermissionSet.

7. Wählen Sie Weiter aus.

8. Überprüfen Sie die Informationen und wählen Sie Senden aus.

   Sie haben sie nun CodeCatalystECSPermissionSet zugewiesen CodeCatalystECSUser und an Sie AWS-Konto gebunden.

Um sich abzumelden und wieder anzumelden als CodeCatalyst ECSUser

1. Bevor Sie sich abmelden, stellen Sie sicher, dass Sie das AWS Zugangsportal URL sowie den Benutzernamen und das Einmalpasswort für habenCodeCatalystECSUser. Sie hätten diese Informationen früher in einen Texteditor kopieren sollen.

   Anmerkung

   Wenn Sie diese Informationen nicht haben, gehen Sie zur CodeCatalystECSUser Detailseite in IAM Identity Center und wählen Sie Passwort zurücksetzen, Einmalpasswort generieren [...] und klicken Sie erneut auf Passwort zurücksetzen, um die Informationen auf dem Bildschirm anzuzeigen.

2. Melden Sie sich ab AWS.

3. Fügen Sie das AWS Zugangsportal URL in die Adressleiste Ihres Browsers ein.

4. Melden Sie sich mit dem Benutzernamen und dem Einmalpasswort für anCodeCatalystECSUser.

5. Geben Sie unter Neues Passwort ein Passwort ein und wählen Sie Neues Passwort festlegen aus.

   Auf dem Bildschirm erscheint ein AWS-KontoFeld.

6. Wählen Sie AWS-Kontound wählen Sie dann den Namen des Benutzers und des AWS-Konto Berechtigungssatzes aus, dem Sie den CodeCatalystECSUser Benutzer zugewiesen haben.

7. Wählen Sie neben dem CodeCatalystECSPermissionSet die Option Verwaltungskonsole aus.

   Das AWS Management Console erscheint. Sie sind jetzt CodeCatalystECSUser mit den entsprechenden Berechtigungen angemeldet.

Um eine AWS CloudShell Instance zu starten

1. Wählen Sie wie CodeCatalystECSUser in der oberen Navigationsleiste das AWS Symbol ( ).

   Die Hauptseite von wird AWS Management Console angezeigt.

2. Wählen Sie in der oberen Navigationsleiste das AWS CloudShell Symbol ( ).

   CloudShell öffnet. Warten Sie, bis die CloudShell Umgebung erstellt ist.

   Anmerkung

   Wenn Sie das CloudShell Symbol nicht sehen, vergewissern Sie sich, dass Sie sich in einer Region befinden, die von unterstützt wird CloudShell. In diesem Tutorial wird davon ausgegangen, dass Sie sich in der Region USA West (Oregon) befinden.

Um zu überprüfen, ob der installiert AWS CLI ist

1. Geben Sie im CloudShell Terminal Folgendes ein:

   aws --version

2. Vergewissern Sie sich, dass eine Version angezeigt wird.

   Der AWS CLI ist bereits für den aktuellen Benutzer konfiguriertCodeCatalystECSUser, sodass keine AWS CLI Schlüssel und Anmeldeinformationen konfiguriert werden müssen, wie dies normalerweise der Fall ist.

Um die Rolle zur Aufgabenausführung zu erstellen

Diese Rolle gewährt Amazon ECS die AWS Fargate Erlaubnis, in Ihrem Namen API Anrufe zu tätigen.

1. Erstellen Sie eine Vertrauensrichtlinie:

   1. Geben Sie in AWS CloudShell den folgenden Befehl ein:

      cat > codecatalyst-ecs-trust-policy.json

      Im CloudShell Terminal erscheint eine blinkende Aufforderung.

   2. Geben Sie an der Eingabeaufforderung den folgenden Code ein:

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
              "Service": "ecs-tasks.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
          }
        ]
      }

   3. Platzieren Sie den Cursor hinter der letzten geschweiften Klammer (}).

   4. Drücken Sie dann Enter undCtrl+d, um die Datei zu speichern und cat zu beenden.

2. Erstellen Sie eine Rolle zur Aufgabenausführung:

   aws iam create-role \
         --role-name codecatalyst-ecs-task-execution-role \
         --assume-role-policy-document file://codecatalyst-ecs-trust-policy.json

3. Hängen Sie die AWS verwaltete AmazonECSTaskExecutionRolePolicy Richtlinie an die Rolle an:

   aws iam attach-role-policy \
         --role-name codecatalyst-ecs-task-execution-role \
         --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

4. Zeigen Sie die Details der Rolle an:

   aws iam get-role \
         --role-name codecatalyst-ecs-task-execution-role

5. Notieren Sie sich den "Arn": Wert der Rolle, zum Beispielarn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role. Sie benötigen diesen Amazon-Ressourcennamen (ARN) später.

Um einen ECS Amazon-Cluster zu erstellen

Dieser Cluster wird die Apache-Platzhalteranwendung und später die Hello World-Anwendung enthalten.

1. Wie in CodeCatalystECSUser AWS CloudShell, erstellen Sie einen leeren Cluster:

   aws ecs create-cluster --cluster-name codecatalyst-ecs-cluster

2. (Optional) Stellen Sie sicher, dass der Cluster erfolgreich erstellt wurde:

   aws ecs list-clusters

   Der ARN des codecatalyst-ecs-cluster Clusters sollte in der Liste erscheinen, was auf eine erfolgreiche Erstellung hinweist.

Um eine Aufgabendefinitionsdatei zu erstellen

Die Aufgabendefinitionsdatei gibt an, dass das Docker-Image (httpd:2.4) des Apache 2.4-Webservers ausgeführt werden soll, von DockerHub dem abgerufen wird.

1. Wie in CodeCatalystECSUser AWS CloudShell, erstellen Sie eine Aufgabendefinitionsdatei:

   cat > taskdef.json

2. Fügen Sie den folgenden Code an der Eingabeaufforderung ein:

   {
       "executionRoleArn": "arn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role",
       "containerDefinitions": [
           {
               "name": "codecatalyst-ecs-container",
               "image": "httpd:2.4",
               "essential": true,
               "portMappings": [
                   {
                       "hostPort": 80,
                       "protocol": "tcp",
                       "containerPort": 80
                   }
               ]
           }
       ],
       "requiresCompatibilities": [
           "FARGATE"
       ],
       "cpu": "256",
       "family": "codecatalyst-ecs-task-def",
       "memory": "512",
       "networkMode": "awsvpc"
   }

   Ersetzen Sie im vorherigen Code arn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role

   durch die Rolle ARN der Aufgabenausführung, die Sie notiert habenUm die Rolle zur Aufgabenausführung zu erstellen.

3. Platzieren Sie den Cursor hinter der letzten geschweiften Klammer (}).

4. Drücken Sie dann Enter undCtrl+d, um die Datei zu speichern und cat zu beenden.

Um die Aufgabendefinitionsdatei bei Amazon zu registrieren ECS

1. Wie in CodeCatalystECSUser AWS CloudShell, registrieren Sie die Aufgabendefinition:

   aws ecs register-task-definition \
       --cli-input-json file://taskdef.json

2. (Optional) Stellen Sie sicher, dass die Aufgabendefinition registriert wurde:

   aws ecs list-task-definitions

   Die codecatalyst-ecs-task-def Aufgabendefinition sollte in der Liste erscheinen.

Um den ECS Amazon-Service zu erstellen

Der ECS Amazon-Service führt die Aufgaben (und die zugehörigen Docker-Container) der Apache-Platzhalteranwendung und später der Hello World-Anwendung aus.

1. Wechseln Sie außerdem zur Amazon Elastic Container Service-Konsole, falls Sie dies noch nicht getan haben. CodeCatalystECSUser

2. Wählen Sie den Cluster aus, den Sie zuvor erstellt haben,codecatalyst-ecs-cluster.

3. Wählen Sie auf der Registerkarte Dienste die Option Erstellen aus.

4. Gehen Sie auf der Seite „Erstellen“ wie folgt vor:

   1. Behalten Sie alle Standardeinstellungen mit Ausnahme der im Folgenden aufgeführten bei.

   2. Wählen Sie als Starttyp die Option FARGATE.

   3. Wählen Sie unter Aufgabendefinition in der Dropdownliste Familie die folgenden Optionen aus:

      codecatalyst-ecs-task-def

   4. Geben Sie als Dienstname Folgendes ein:

      codecatalyst-ecs-service

   5. Geben Sie für Gewünschte Aufgaben Folgendes ein:

      3

      In diesem Tutorial startet jede Aufgabe einen einzelnen Docker-Container.

   6. Erweitern Sie den Bereich Netzwerk.

   7. Wählen Sie für VPCeine beliebige Option ausVPC.

   8. Wählen Sie für Subnetze ein beliebiges Subnetz aus.

      Anmerkung

      Geben Sie nur ein Subnetz an. Das ist alles, was für dieses Tutorial benötigt wird.

      Anmerkung

      Wenn Sie kein UND-Subnetz haben, erstellen Sie sie. VPC Weitere Informationen finden Sie unter Erstellen eines und Erstellen eines Subnetzes VPC in Ihrem im VPCAmazon-Benutzerhandbuch. VPC

   9. Wählen Sie für Sicherheitsgruppe die Option Neue Sicherheitsgruppe erstellen aus und gehen Sie dann wie folgt vor:

      1. Geben Sie als Namen der Sicherheitsgruppe Folgendes ein:

         codecatalyst-ecs-security-group

      2. Geben Sie als Beschreibung der Sicherheitsgruppe Folgendes ein:

         CodeCatalyst ECS security group

      3. Wählen Sie Regel hinzufügen aus. Wählen Sie als Typ HTTPund für Quelle die Option Anywhere aus.

   10. Wählen Sie unten „Erstellen“ aus.

   11. Warten Sie, bis der Dienst erstellt wurde. Dies kann einige Minuten dauern.

5. Wählen Sie die Registerkarte Aufgaben und dann die Schaltfläche „Aktualisieren“. Vergewissern Sie sich, dass die Spalte Letzter Status für alle drei Aufgaben auf Wird ausgeführt gesetzt ist.

(Optional) Um zu überprüfen, ob Ihre Apache-Platzhalteranwendung ausgeführt wird

1. Wählen Sie auf der Registerkarte Aufgaben eine der drei Aufgaben aus.

2. Wählen Sie im Feld Öffentliche IP die Option Open Address aus.

   Eine It Works! Seite wird angezeigt. Dies weist darauf hin, dass der ECS Amazon-Service erfolgreich eine Aufgabe gestartet hat, die einen Docker-Container mit dem Apache-Image gestartet hat.

   An diesem Punkt des Tutorials haben Sie manuell einen ECS Amazon-Cluster, eine Service- und Aufgabendefinition sowie eine Apache-Platzhalteranwendung bereitgestellt. Nachdem Sie all diese Elemente eingerichtet haben, sind Sie nun bereit, einen Workflow zu erstellen, der die Apache-Platzhalteranwendung durch die Hello World-Anwendung des Tutorials ersetzt.

Um ein Bild-Repository in Amazon zu erstellen ECR

1. Wie in CodeCatalystECSUser AWS CloudShell, ein leeres Repository in Amazon erstellenECR:

   aws ecr create-repository --repository-name codecatalyst-ecs-image-repo

2. Zeigen Sie die Details des ECR Amazon-Repositorys an:

   aws ecr describe-repositories \
         --repository-names codecatalyst-ecs-image-repo
   

3. Notieren Sie sich den “repositoryUri”: Wert, zum Beispiel111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo.

   Sie benötigen ihn später, wenn Sie das Repository zu Ihrem Workflow hinzufügen.

Um deiner Kontoverbindung Rollen zum Erstellen und Bereitstellen hinzuzufügen

1. Navigieren CodeCatalyst Sie darin zu Ihrem Bereich.

2. Wählen Sie AWS accounts (-Konten). Eine Liste der Kontoverbindungen wird angezeigt.

3. Wählen Sie die Kontoverbindung aus, die dem AWS Konto entspricht, in dem Sie Ihre Build- und Deploy-Rollen erstellt haben.

4. Wählen Sie in der AWS Managementkonsole die Option Rollen verwalten aus.

   Die Seite IAMRolle zu Amazon CodeCatalyst Space hinzufügen wird angezeigt. Möglicherweise müssen Sie sich anmelden, um auf die Seite zuzugreifen.

5. Wählen Sie Eine bestehende Rolle hinzufügen aus, in der Sie sie erstellt haben IAM.

   Eine Dropdownliste wird angezeigt. In der Liste werden alle IAM Rollen mit einer Vertrauensrichtlinie angezeigt, die die Dienstprinzipale codecatalyst-runner.amazonaws.com und die codecatalyst.amazonaws.com Dienstprinzipale umfasst.

6. Wählen Sie in der Dropdownliste codecatalyst-ecs-build-role die Option Rolle hinzufügen aus.

   Anmerkung

   Wenn Sie das sehenThe security token included in the request is invalid, liegt es möglicherweise daran, dass Sie nicht über die richtigen Berechtigungen verfügen. Um dieses Problem zu beheben, melden Sie sich ab und melden Sie sich mit dem AWS Konto wieder an, das Sie bei der Erstellung Ihres CodeCatalyst Bereichs verwendet haben. AWS

7. Wähle „IAMRolle hinzufügen“, wähle „Bestehende Rolle hinzufügenIAM, in der du erstellt hast“ und wähle in der Drop-down-Liste die Option auscodecatalyst-ecs-deploy-role. Wählen Sie Rolle hinzufügen aus.

   Sie haben jetzt die Rollen Build und Deploy zu Ihrem Bereich hinzugefügt.

8. Kopieren Sie den Wert des CodeCatalyst Amazon-Anzeigenamens. Sie benötigen diesen Wert später, wenn Sie Ihren Workflow erstellen.

Um ein Quell-Repository zu erstellen

1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

2. Navigieren Sie zu Ihrem Projekt,codecatalyst-ecs-project.

3. Wählen Sie im Navigationsbereich Code und dann Quell-Repositories aus.

4. Wählen Sie Repository hinzufügen und anschließend Repository erstellen aus.

5. Geben Sie im Feld Repository-Name Folgendes ein:

   codecatalyst-ecs-source-repository

6. Wählen Sie Erstellen.

Um die Datei index.html hinzuzufügen

1. Gehen Sie in der CodeCatalyst Konsole zu Ihrem Quell-Repository,codecatalyst-ecs-source-repository.

2. Wählen Sie unter Dateien die Option Datei erstellen aus.

3. Geben Sie als Dateiname Folgendes ein:

   public-html/index.html

   Wichtig

   Stellen Sie sicher, dass Sie das public-html/ Präfix angeben, um einen Ordner mit demselben Namen zu erstellen. Das index.html wird sich voraussichtlich in diesem Ordner befinden.

4. Geben Sie in das Textfeld den folgenden Code ein:

   <html>
     <head>
       <title>Hello World</title>
       <style>
         body {
         background-color: black;
         text-align: center;
         color: white;
         font-family: Arial, Helvetica, sans-serif;
         }  
       </style>
     </head>
     <body>
       <h1>Hello World</h1>
     </body>
   </html>

5. Wählen Sie Commit und anschließend erneut Commit aus.

   Das index.html wird Ihrem Repository in einem public-html Ordner hinzugefügt.

Um das Dockerfile hinzuzufügen

1. Wählen Sie in Ihrem Quell-Repository die Option Datei erstellen aus.

2. Geben Sie als Dateiname Folgendes ein:

   Dockerfile

   Geben Sie keine Dateierweiterung an.

   Wichtig

   Das Dockerfile muss sich im Stammordner Ihres Repositorys befinden. Der Docker build Befehl des Workflows erwartet, dass es dort vorhanden ist.

3. Geben Sie in das Textfeld den folgenden Code ein:

   FROM httpd:2.4
   COPY ./public-html/index.html /usr/local/apache2/htdocs/index.html
   EXPOSE 80

4. Wählen Sie Commit und anschließend erneut Commit aus.

   Das Dockerfile wird Ihrem Repository hinzugefügt.

Um die Datei taskdef.json hinzuzufügen

1. Wählen Sie in Ihrem Quell-Repository die Option Datei erstellen aus.

2. Geben Sie als Dateiname Folgendes ein:

   taskdef.json

3. Geben Sie in das Textfeld den folgenden Code ein:

   {
       "executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
       "containerDefinitions": [
           {
               "name": "codecatalyst-ecs-container",
               # The $REPOSITORY_URI and $IMAGE_TAG variables will be replaced 
               # by the workflow at build time (see the build action in the 
               # workflow)
               "image": $REPOSITORY_URI:$IMAGE_TAG,
               "essential": true,
               "portMappings": [
                   {
                       "hostPort": 80,
                       "protocol": "tcp",
                       "containerPort": 80
                   }
               ]
           }
       ],
       "requiresCompatibilities": [
           "FARGATE"
       ],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512",
       "family": "codecatalyst-ecs-task-def"
   }

   Ersetzen Sie im vorherigen Code

   arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role

   durch die Rolle ARN der Aufgabenausführung, die Sie notiert habenUm die Rolle zur Aufgabenausführung zu erstellen.

4. Wählen Sie Commit und anschließend erneut Commit aus.

   Die taskdef.json Datei wird Ihrem Repository hinzugefügt.

So erstellen Sie ein Workflow

1. Wählen Sie in der CodeCatalyst Konsole im Navigationsbereich CI/CD und dann Workflows aus.

2. Wählen Sie Workflow erstellen aus.

3. Wählen Sie für Quell-Repository die Optioncodecatalyst-ecs-source-repository.

4. Wählen Sie für Branch die Optionmain.

5. Wählen Sie Erstellen.

6. Löschen Sie den YAML Beispielcode.

7. Fügen Sie den folgenden YAML Code hinzu:

   Anmerkung

   Im folgenden YAML Code können Sie die Connections: Abschnitte weglassen, wenn Sie möchten. Wenn Sie diese Abschnitte weglassen, müssen Sie sicherstellen, dass die im Feld Standardrolle angegebene IAM Rolle in Ihrer Umgebung die unter beschriebenen Berechtigungen und Vertrauensrichtlinien für beide Rollen enthält. Schritt 5: AWS Rollen hinzufügen CodeCatalyst Weitere Informationen zum Einrichten einer Umgebung mit einer IAM Standardrolle finden Sie unterErstellen einer Umgebung.

   Name: codecatalyst-ecs-workflow
   SchemaVersion: 1.0
   
   Triggers:
     - Type: PUSH
       Branches:
         - main
   Actions:
     BuildBackend:
       Identifier: aws/build@v1
       Environment:
         Name: codecatalyst-ecs-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-ecs-build-role
       Inputs:
         Sources:
           - WorkflowSource
         Variables:
           - Name: REPOSITORY_URI
             Value: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo
           - Name: IMAGE_TAG
             Value: ${WorkflowSource.CommitId}
       Configuration:
         Steps:
           #pre_build:
           - Run: echo Logging in to Amazon ECR...
           - Run: aws --version
           - Run: aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-west-2.amazonaws.com
           #build:
           - Run: echo Build started on `date`
           - Run: echo Building the Docker image...
           - Run: docker build -t $REPOSITORY_URI:latest .
           - Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG
           #post_build:
           - Run: echo Build completed on `date`
           - Run: echo Pushing the Docker images...
           - Run: docker push $REPOSITORY_URI:latest
           - Run: docker push $REPOSITORY_URI:$IMAGE_TAG
           # Replace the variables in taskdef.json
           - Run: find taskdef.json -type f | xargs sed -i "s|\$REPOSITORY_URI|$REPOSITORY_URI|g"
           - Run: find taskdef.json -type f | xargs sed -i "s|\$IMAGE_TAG|$IMAGE_TAG|g"
           - Run: cat taskdef.json
           # The output artifact will be a zip file that contains a task definition file.
       Outputs:
         Artifacts:
           - Name: TaskDefArtifact
             Files: 
               - taskdef.json
     DeployToECS:
       DependsOn: 
         - BuildBackend
       Identifier: aws/ecs-deploy@v1
       Environment:
         Name: codecatalyst-ecs-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-ecs-deploy-role
       Inputs:
         Sources: []
         Artifacts:
           - TaskDefArtifact
       Configuration:
         region: us-west-2
         cluster: codecatalyst-ecs-cluster
         service: codecatalyst-ecs-service
         task-definition: taskdef.json

   Ersetzen Sie im vorherigen Code:

   • Beide Instanzen von codecatalyst-ecs-environment mit dem Namen der Umgebung, in der Sie erstellt habenVoraussetzungen.

   • Beide Instanzen von codecatalyst-account-connection mit dem Anzeigenamen Ihrer Kontoverbindung. Der Anzeigename kann eine Zahl sein. Weitere Informationen finden Sie unter Schritt 5: AWS Rollen hinzufügen CodeCatalyst.

   • codecatalyst-ecs-build-role mit dem Namen der Build-Rolle, in der Sie sie erstellt habenSchritt 4: AWS Rollen erstellen.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo (in der Value: Eigenschaft) mit dem URI des ECR Amazon-Repositorys, in dem Sie es erstellt habenSchritt 3: Erstellen Sie ein ECR Amazon-Image-Repository.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com (im Run: aws ecr Befehl) mit dem URI des ECR Amazon-Repositorys ohne das Bildsuffix (/codecatalyst-ecs-image-repo).

   • codecatalyst-ecs-deploy-role mit dem Namen der Bereitstellungsrolle, in Schritt 4: AWS Rollen erstellen der Sie sie erstellt haben.

   • Beide Instanzen von us-west-2 mit Ihrem AWS Regionalcode. Eine Liste der Regionalcodes finden Sie unter Regionale Endpunkte in der Allgemeine AWS-Referenz.

   Anmerkung

   Wenn Sie sich entschieden haben, keine Rollen zu erstellen, zu erstellen und bereitzustellen, ersetzen Sie codecatalyst-ecs-build-role and codecatalyst-ecs-deploy-role mit dem Namen der CodeCatalystWorkflowDevelopmentRole-spaceName Rolle. Weitere Informationen über diese Rolle finden Sie unter Schritt 4: AWS Rollen erstellen.

   Tipp

   Anstatt die sed Befehle find und und zu verwenden, die im vorherigen Workflow-Code gezeigt wurden, um das Repository und den Namen des Images zu aktualisieren, können Sie zu diesem Zweck die Aktion Render ECS Amazon-Aufgabendefinition verwenden. Weitere Informationen finden Sie unter Änderung einer ECS Amazon-Aufgabendefinition.

8. (Optional) Wählen Sie „Validieren“, um sicherzustellen, dass der YAML Code gültig ist, bevor Sie ihn bestätigen.

9. Wählen Sie Commit (Übergeben).

10. Geben Sie im Dialogfeld „Workflow bestätigen“ Folgendes ein:

    1. Entfernen Sie bei Nachricht bestätigen den Text und geben Sie Folgendes ein:

       Add first workflow

    2. Wählen Sie für Repositorycodecatalyst-ecs-source-repository.

    3. Wählen Sie als Branch-Name die Option main aus.

    4. Wählen Sie Commit (Übergeben).

    Sie haben jetzt einen Workflow erstellt. Eine Workflow-Ausführung wird aufgrund des oben im Workflow definierten Triggers automatisch gestartet. Insbesondere, als Sie die workflow.yaml Datei in Ihr Quell-Repository übernommen (und per Push übertragen) haben, hat der Trigger die Workflow-Ausführung gestartet.

Um den Fortschritt der Workflow-Ausführung zu sehen

1. Wählen Sie im Navigationsbereich der CodeCatalyst Konsole CI/CD und dann Workflows aus.

2. Wählen Sie den Workflow aus, den Sie gerade erstellt haben,. codecatalyst-ecs-workflow

3. Wählen Sie BuildBackend, ob Sie den Baufortschritt sehen möchten.

4. Wählen Sie DeployToECSdiese Option, um den Fortschritt der Bereitstellung zu sehen.

   Weitere Informationen zum Anzeigen von Ausführungsdetails finden Sie unterStatus und Details der Workflow-Ausführung anzeigen.

Um die Bereitstellung zu überprüfen

1. Öffnen Sie die Amazon ECS Classic-Konsole unter https://console.aws.amazon.com/ecs/.

2. Wählen Sie Ihren Cluster,codecatalyst-ecs-cluster.

3. Wählen Sie die Registerkarte Tasks aus.

4. Wählen Sie eine der drei Aufgaben.

5. Wählen Sie im Feld Öffentliche IP die Option Open Address aus.

   Im Browser wird eine Seite „Hello World“ angezeigt, die darauf hinweist, dass der ECS Amazon-Service Ihre Anwendung erfolgreich bereitgestellt hat.

Um die Datei index.html zu ändern

1. Wählen Sie in der CodeCatalyst Konsole im Navigationsbereich Code, dann Quell-Repositories und anschließend Ihr Repository aus. codecatalyst-ecs-source-repository

2. Klicken Sie auf public-html und danach auf index.html.

   Der Inhalt von index.html wird angezeigt.

3. Wählen Sie Bearbeiten aus.

4. Ändern Sie in Zeile 14 den Hello World Text inTutorial complete!.

5. Wählen Sie Commit und anschließend erneut Commit aus.

   Durch den Commit wird ein neuer Workflow-Lauf gestartet.

6. (Optional) Gehen Sie zur Hauptseite Ihres Quell-Repositorys, wählen Sie Commits anzeigen und notieren Sie sich die Commit-ID für die index.html Änderung.

7. Beobachten Sie den Fortschritt der Bereitstellung:

   1. Wählen Sie im Navigationsbereich CI/CD und dann Workflows aus.

   2. Wählen Siecodecatalyst-ecs-workflow, ob Sie die letzte Ausführung anzeigen möchten.

   3. Wählen Sie und BuildBackend, DeployToECSum den Fortschritt der Workflow-Ausführung zu sehen.

8. Stellen Sie wie folgt sicher, dass Ihre Anwendung aktualisiert wurde:

   1. Öffnen Sie die Amazon ECS Classic-Konsole unter https://console.aws.amazon.com/ecs/.

   2. Wählen Sie Ihren Cluster,codecatalyst-ecs-cluster.

   3. Wählen Sie die Registerkarte Tasks aus.

   4. Wählen Sie eine der drei Aufgaben.

   5. Wählen Sie im Feld Öffentliche IP die Option Open Address aus.

      Eine Tutorial complete! Seite wird angezeigt.

9. (Optional) Wechseln Sie in AWS zur ECR Amazon-Konsole und überprüfen Sie, ob das neue Docker-Image mit der Commit-ID aus Schritt 6 gekennzeichnet wurde.