教學課程：將應用程式部署到 Amazon ECS

建立IAM識別中心使用者的步驟

1. 登入 AWS Management Console 並開啟 AWS IAM Identity Center 主控台，位於https://console.aws.amazon.com/singlesignon/。

   注意

   確保您使用連接到您的 CodeCatalyst空間的登錄。 AWS 帳戶 您可以瀏覽至您的空間並選擇 [帳戶] 索引標籤，確認已連結哪個AWS帳戶。如需詳細資訊，請參閱 建立空間。

2. 在導覽窗格中，選擇 使用者，然後選擇 新增使用者。

3. 在使用者名稱中，輸入：

   CodeCatalystECSUser

4. 在 [密碼] 下方，選擇 [產生一次性密碼，您可以與此使用者共用]。

5. 在 [電子郵件地址] 和 [確認電子郵件地址] 中，輸入IAM身分識別中心中尚未存在的電子郵件地址。

6. 在名字和姓氏中，輸入：

   CodeCatalystECSUser

7. 在 [顯示名稱] 中，保留自動產生的名稱：

   CodeCatalystECSUser CodeCatalystECSUser

8. 選擇下一步。

9. 在 [新增使用者至群組] 頁面上，選擇 [下一步]。

10. 在 [檢閱並新增使用者] 頁面上，檢閱資訊並選擇 [新增使用者]。

    這時系統顯示一次性密碼對話框。

11. 選擇 [複製]，然後貼上登入資訊，包括 AWS 存取入口網站URL和一次性密碼。

12. 選擇關閉。

建立許可集合

您會將此權限集指派給CodeCatalystECSUser稍後。

1. 在瀏覽窗格中，選擇 [權限集]，然後選擇 [建立權限集]。

2. 選擇預先定義的權限集，然後選取AdministratorAccess。此原則為所有人提供完整權限 AWS 服務。

3. 選擇下一步。

4. 在權限集名稱中，輸入：

   CodeCatalystECSPermissionSet

5. 選擇下一步。

6. 在 [檢閱並建立] 頁面上，檢閱資訊並選擇 [建立]。

若要將權限集指派給 CodeCatalyst ECSUser

1. 在功 AWS 帳戶 能窗格中，選擇 AWS 帳戶，然後選取您目前登入的對象旁邊的核取方塊。

2. 選擇 [指派使用者或群組]。

3. 選擇 Users (使用者) 索引標籤。

4. 選取旁邊的核取方塊CodeCatalystECSUser。

5. 選擇下一步。

6. 選取旁邊的核取方塊CodeCatalystECSPermissionSet。

7. 選擇下一步。

8. 複查資訊，然後選擇「提交」。

   您現在已經分配CodeCatalystECSUser並CodeCatalystECSPermissionSet將 AWS 帳戶它們綁定在一起。

若要登出並重新登入為 CodeCatalyst ECSUser

1. 在您登出之前，請確定您擁有 AWS 存取入口網站URL、使用者名稱和一次性密碼CodeCatalystECSUser。您應該先前將此資訊複製到文字編輯器中。

   注意

   如果您沒有此資訊，請前往IAM身分識別中心的CodeCatalystECSUser詳細資料頁面，選擇 [重設密碼]、[產生一次性密碼 [...] ，然後再次重設密碼以在螢幕上顯示資訊。

2. 登出 AWS。

3. 將 AWS 訪問門戶粘貼URL到瀏覽器的地址欄中。

4. 使用的使用者名稱和一次性密碼登入CodeCatalystECSUser。

5. 在 [新密碼] 中，輸入密碼，然後選擇 [設定新密碼]。

   螢幕上會出現一個AWS 帳戶方塊。

6. 選擇 AWS 帳戶，然後選擇您 AWS 帳戶 為其指派CodeCatalystECSUser使用者和權限集的名稱。

7. 在旁邊CodeCatalystECSPermissionSet，選擇 [管理主控台]。

   AWS Management Console 隨即出現。您現在已使用適當CodeCatalystECSUser的權限登入。

若要啟動 AWS CloudShell 執行個體

1. 作為CodeCatalystECSUser，在頂部導航欄中，選擇 AWS 圖標（ ）。

   的主頁面 AWS Management Console 隨即出現。

2. 在上方導覽列中，選擇 AWS CloudShell 圖示 ( )。

   CloudShell 打開。等待 CloudShell 環境建立完成。

   注意

   如果沒有看到 CloudShell 圖示，請確定您所在的地區受支援 CloudShell。本教學課程假設您位於美國西部 (奧勒岡) 區域。

若要確認是否 AWS CLI 已安裝

1. 在 CloudShell 終端機中，輸入：

   aws --version

2. 檢查是否顯示版本。

   AWS CLI 已針對目前使用者設定CodeCatalystECSUser，因此不需要設定 AWS CLI 金鑰和認證，就像通常情況一樣。

若要建立作業執行角色

此角色授予 Amazon 以ECS及代表您API撥打電話的權 AWS Fargate 限。

1. 建立信任原則：

   1. 在中 AWS CloudShell，輸入下列命令：

      cat > codecatalyst-ecs-trust-policy.json

      CloudShell 終端機中會出現閃爍的提示。

   2. 在提示符下輸入以下代碼：

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

   3. 將游標置於最後一個大括號 (}) 之後。

   4. 按，Enter然後Ctrl+d保存文件並退出貓。

2. 建立工作執行角色：

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

3. 將 AWS 受管理的AmazonECSTaskExecutionRolePolicy策略附加到角色：

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

4. 顯示角色的詳細資訊：

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

5. 請記下角色的"Arn":值，例如，arn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role。您將需要這個 Amazon 資源名稱（ARN）以後。

若要建立 Amazon ECS 叢集

此叢集將包含 Apache 預留位置應用程式，以及之後的 Hello World 應用程式。

1. 如同 CodeCatalystECSUser AWS CloudShell，在中建立一個空叢集：

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

2. (選擇性) 確認叢集是否已成功建立：

   aws ecs list-clusters

   codecatalyst-ecs-cluster叢集ARN的應該會出現在清單中，表示建立成功。

建立工作定義檔案的步驟

任務定義文件指示運行從 DockerHub中提取的 Apache 2.4 Web 服務器碼頭圖像（httpd:2.4）。

1. 如同 CodeCatalystECSUser AWS CloudShell，在中建立工作定義檔案：

   cat > taskdef.json

2. 在提示符下粘貼以下代碼：

   {
       "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"
   }

   在前面的代碼中，替換 arn:aws:iam::111122223333:role/codecatalyst-ecs-task-execution-role

   與您在中所記錄ARN的任務執行角色若要建立作業執行角色。

3. 將游標置於最後一個大括號 (}) 之後。

4. 按，Enter然後Ctrl+d保存文件並退出貓。

向 Amazon 註冊任務定義文件 ECS

1. 如同 CodeCatalystECSUser AWS CloudShell，在中註冊任務定義：

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

2. (選擇性) 確認工作定義是否已註冊：

   aws ecs list-task-definitions

   codecatalyst-ecs-task-def任務定義應該會出現在清單中。

要創建 Amazon ECS 服務

Amazon ECS 服務運行 Apache 佔位符應用程序的任務（和相關的 Docker 容器），以及更高版本的 Hello World 應用程序。

1. 作為CodeCatalystECSUser，切換到 Amazon 彈性容器服務主控台（如果尚未這樣做）。

2. 選擇您先前建立的叢集codecatalyst-ecs-cluster。

3. 在「服務」標籤中，選擇「建立」。

4. 在「建立」頁面中，執行下列動作：

   1. 保留所有預設設定，但接下來列出的設定除外。

   2. 針對 [啟動類型]，選擇FARGATE。

   3. 在「工作定義」下的「系列」下拉式清單中，選擇：

      codecatalyst-ecs-task-def

   4. 在「服務名稱」中，輸入：

      codecatalyst-ecs-service

   5. 針對 [想要的工作]，輸入：

      3

      在本教學課程中，每項工作都會啟動單一 Docker 容器。

   6. 展開 [網路] 區段。

   7. 對於 VPC，選擇任何VPC。

   8. 對於子網路，請選擇任何子網路。

      注意

      僅指定一個子網路。這就是本教程所需要的一切。

      注意

      如果您沒有VPC和子網路，請建立它們。請參閱 Amazon VPC 使用者指南中的VPC建立子網路和建立子網路。VPC

   9. 針對 [安全性群組]，選擇 [建立新的安全性群組]，然後執行下列動作：

      1. 在「安全性群組名稱」中，輸入：

         codecatalyst-ecs-security-group

      2. 對於安全性群組說明，請輸入：

         CodeCatalyst ECS security group

      3. 選擇新增規則。對於「類型」HTTP，請選擇「來源」，然後選擇「任意位置」

   10. 選擇底部的 [建立]。

   11. 等待服務建立完成。這可能需要幾分鐘的時間。

5. 選擇 [作業] 索引標籤，然後選擇 [重新整理] 按鈕。確認所有三個工作的 [上次狀態] 欄都設定為 [執行中]。

(選擇性) 若要確認您的 Apache 預留位置應用程式正在執行

1. 在 [工作] 索引標籤中，選擇三個工作中的任何一個。

2. 在 [公用 IP] 欄位中，選擇 [開啟位址]。

   隨即顯示It Works!頁面。這表明 Amazon ECS 服務成功啟動了使用 Apache 映像啟動 Docker 容器的任務。

   在本教學中，您已手動部署 Amazon ECS 叢集、服務和任務定義，以及 Apache 預留位置應用程式。有了這些項目，您現在就可以建立工作流程，以教學課程的 Hello World 應用程式取代 Apache 預留位置應用程式。

在 Amazon 中創建映像存儲庫 ECR

1. 如在中 CodeCatalystECSUser AWS CloudShell，在 Amazon 中創建一個空存儲庫ECR：

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

2. 顯示 Amazon ECR 存儲庫的詳細信息：

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

3. 請注意“repositoryUri”:值，例如，111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo。

   稍後在將存放庫新增至工作流程時需要它。

若要將建置和部署角色新增至您的帳戶連線

1. 在中 CodeCatalyst，導覽至您的空間。

2. 選擇AWS 帳戶。此時會顯示帳戶連線清單。

3. 選擇代表您建立組建和部署角色之 AWS 帳戶的帳戶連線。

4. 從管理主控台選擇 [ AWS 管理角色]。

   將顯示 [新增IAM角色至 Amazon CodeCatalyst 空間] 頁面。您可能需要登入才能存取此頁面。

5. 選取 [新增您在中建立的現有角色] IAM。

   這時系統顯示下拉列表。此清單會顯示具有信任原則的所有IAM角色，其中包括codecatalyst-runner.amazonaws.com和codecatalyst.amazonaws.com服務主體。

6. 在下拉式清單中，選擇codecatalyst-ecs-build-role，然後選擇 [新增角色]。

   注意

   如果您看到The security token included in the request is invalid，可能是因為您沒有正確的權限。若要修正此問題，請使 AWS 用您建立 CodeCatalyst空間時使用的 AWS 帳戶登出以重新登入。

7. 選擇 [新增IAM角色]，選擇 [新增您在其中建立的現有角色]IAM，然後在下拉式清單中選擇codecatalyst-ecs-deploy-role。選擇 Add role (新增角色)。

   您現在已將組建和部署角色新增至您的空間。

8. 複製 Amazon CodeCatalyst 顯示名稱的值。在建立工作流程時，您將需要此值。

若要建立來源儲存庫

1. 請在以下位置開啟 CodeCatalyst 主控台。 https://codecatalyst.aws/

2. 導航到您的項目，codecatalyst-ecs-project。

3. 在瀏覽窗格中，選擇 [程式碼]，然後選擇 [原始碼儲存庫]。

4. 選擇新增儲存區域，然後選擇建立儲存庫。

5. 在存放庫名稱中，輸入：

   codecatalyst-ecs-source-repository

6. 選擇建立。

若要新增 index.html 檔案的步驟

1. 在 CodeCatalyst 主控台中，移至您的來源儲存庫、codecatalyst-ecs-source-repository.

2. 在 [檔案] 中選擇 [建立檔案]。

3. 在「檔案名稱」中，輸入：

   public-html/index.html

   重要

   確保包括public-html/前綴以創建相同名稱的文件夾。預期index.html會位於此資料夾中。

4. 在文字方塊中，輸入下列程式碼：

   <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. 選擇「確認」，然後再次選擇「確認」。

   會index.html新增至資public-html料夾中的儲存庫。

添加碼頭文件

1. 在來源儲存庫中，選擇 [建立檔案]。

2. 在「檔案名稱」中，輸入：

   Dockerfile

   請勿包含副檔名。

   重要

   Docker 文件必須駐留在存儲庫的根文件夾中。工作流程的Docker build命令期望它在那裡。

3. 在文字方塊中，輸入下列程式碼：

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

4. 選擇「確認」，然後再次選擇「確認」。

   碼頭文件被添加到您的存儲庫中。

若要新增工作定義 .json 檔案

1. 在來源儲存庫中，選擇 [建立檔案]。

2. 在「檔案名稱」中，輸入：

   taskdef.json

3. 在文字方塊中，輸入下列程式碼：

   {
       "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"
   }

   在前面的代碼中，替換

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

   與您在中所記錄ARN的任務執行角色若要建立作業執行角色。

4. 選擇「確認」，然後再次選擇「確認」。

   taskdef.json檔案即會新增至您的儲存庫。

若要建立工作流程

1. 在 CodeCatalyst 主控台的功能窗格中，選擇 CI/CD，然後選擇 [工作流程]。

2. 選擇建立工作流程。

3. 針對來源儲存庫，選擇codecatalyst-ecs-source-repository。

4. 對於「分支」，請選擇main。

5. 選擇建立。

6. 刪除範YAML例程式碼。

7. 添加以下YAML代碼：

   注意

   在下面的YAML代碼中，如果需要，可以省略Connections:部分。如果您省略這些區段，則必須確定您環境中「預設IAM角色」欄位中指定的角色包含中所述兩個角色的權限和信任原則步驟 5：將 AWS 角色新增至 CodeCatalyst。如需使用預設IAM角色設定環境的詳細資訊，請參閱建立環境。

   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

   在前面的代碼中，替換：

   • 的兩個執行個體 codecatalyst-ecs-environment 使用您在中建立的環境名稱必要條件。

   • 的兩個執行個體 codecatalyst-account-connection 與您的帳戶連接的顯示名稱。顯示名稱可能是數字。如需詳細資訊，請參閱 步驟 5：將 AWS 角色新增至 CodeCatalyst。

   • codecatalyst-ecs-build-role 使用您在中建立之建置角色的名稱步驟 4：建立 AWS 角色。

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo （在Value:屬性中）使用您在中創建URI的 Amazon ECR 存儲庫步驟 3：創建一個 Amazon ECR 映像存儲庫。

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com （在Run: aws ecr命令中）使用不帶圖像後綴URI的 Amazon ECR 存儲庫（/codecatalyst-ecs-image-repo）。

   • codecatalyst-ecs-deploy-role 使用您在中建立的部署角色名稱步驟 4：建立 AWS 角色。

   • 的兩個執行個體 us-west-2 使用您的 AWS 區域代碼。如需區域代碼的清單，請參閱 AWS 一般參考.

   注意

   如果您決定不建立建置和部署角色，請取代 codecatalyst-ecs-build-role 以及 codecatalyst-ecs-deploy-role 與CodeCatalystWorkflowDevelopmentRole-spaceName角色的名稱。如需有關此角色的詳細資訊，請參閱 步驟 4：建立 AWS 角色。

   提示

   您可以針對此目find的使用 Render Amazon ECS 任務定義動作，而不是使用先前工作流程程式碼中顯示的和sed命令來更新儲存庫和映像名稱。如需詳細資訊，請參閱 修改 Amazon ECS任務定義。

8. (選擇性) 選擇「驗證」，確定YAML程式碼在認可之前是有效的。

9. 選擇 Commit (遞交)。

10. 在「提交工作流程」對話方塊中，輸入以下內容：

    1. 對於提交訊息，請移除文字並輸入：

       Add first workflow

    2. 針對「儲存庫」，選擇codecatalyst-ecs-source-repository。

    3. 選擇「主要」做為「分支名稱」。

    4. 選擇 Commit (遞交)。

    您現在已建立工作流程。工作流程執行會自動啟動，因為工作流程頂端定義了觸發器。具體而言，當您認可 (並推送) workflow.yaml 檔案至來源儲存庫時，觸發程序會啟動工作流程執行。

若要檢視工作流程執行進度

1. 在 CodeCatalyst 主控台的瀏覽窗格中，選擇 CI/CD，然後選擇 [工作流程]。

2. 選擇您剛建立的工作流程codecatalyst-ecs-workflow。

3. 選擇BuildBackend查看構建進度。

4. 選擇DeployToECS以查看部署進度。

   如需檢視執行詳細資訊的詳細資訊，請參閱檢視工作流程執行狀態與詳細。

驗證部署的步驟

1. 在打開 Amazon ECS 經典控制台https://console.aws.amazon.com/ecs/。

2. 選擇您的叢集、codecatalyst-ecs-cluster.

3. 選擇 Tasks (任務) 索引標籤。

4. 選擇三個任務中的任何一個。

5. 在 [公用 IP] 欄位中，選擇 [開啟位址]。

   瀏覽器中會出現「Hello World」頁面，表示 Amazon ECS 服務已成功部署您的應用程式。

若要變更 index.html 的步驟

1. 在 CodeCatalyst 主控台的導覽窗格中，選擇 [程式碼]，然後選擇 [原始碼儲存庫]，然後選擇您的存放庫codecatalyst-ecs-source-repository。

2. 選擇 public-html (下一步)，然後選擇 index.html (完成)。

   index.html會顯示的內容。

3. 選擇編輯。

4. 在第 14 行中，將Hello World文字變更為Tutorial complete!。

5. 選擇「確認」，然後再次選擇「確認」。

   認可會啟動新的工作流程執行。

6. (選擇性) 移至來源儲存庫的主頁面，選擇 [檢視認可]，然後記下index.html變更的提交 ID。

7. 觀看部署進度：

   1. 在瀏覽窗格中，選擇 CI/CD，然後選擇 [工作流程]。

   2. 選擇codecatalyst-ecs-workflow檢視最新執行。

   3. 選擇BuildBackend和DeployToECS以查看工作流程執行進度。

8. 確認您的應用程式已更新，如下所示：

   1. 在打開 Amazon ECS 經典控制台https://console.aws.amazon.com/ecs/。

   2. 選擇您的叢集、codecatalyst-ecs-cluster.

   3. 選擇 Tasks (任務) 索引標籤。

   4. 選擇三個任務中的任何一個。

   5. 在 [公用 IP] 欄位中，選擇 [開啟位址]。

      隨即顯示Tutorial complete!頁面。

9. (選擇性) 在中 AWS，切換至 Amazon ECR 主控台，並確認新的 Docker 映像已使用步驟 6 中的提交 ID 標記。