Prasyarat Langkah 1: Buat Application Load Balancer Langkah 2: Buat klaster Amazon ECS Langkah 3: Daftarkan ketentuan tugas Langkah 4: Buat layanan Amazon ECS Langkah 5: Buat sumber daya AWS CodeDeploy Langkah 6: Buat dan pantau deployment CodeDeploy Langkah 7: Bersihkan

Tutorial: Membuat layanan menggunakan deployment biru/hijau

Amazon ECS telah mengintegrasikan deployment biru/hijau ke dalam wizard Buat Layanan di konsol Amazon ECS klasik. Untuk informasi selengkapnya, lihat Membuat layanan Amazon ECS di konsol klasik.

Tutorial berikut menunjukkan cara membuat layanan Amazon ECS yang berisi tugas Fargate yang menggunakan tipe deployment biru/hijau denganAWS CLI.

catatan

Dukungan untuk melakukan deployment biru/hijau telah ditambahkan untuk AWS CloudFormation. Untuk informasi selengkapnya, lihat Melakukan penerapan biru/hijau Amazon ECS melalui CodeDeploy penggunaanAWS CloudFormation di PanduanAWS CloudFormation Pengguna.

Prasyarat

Tutorial ini mengasumsikan bahwa Anda telah menyelesaikan prasyarat berikut:

Versi terbaru dari AWS CLI diinstal dan dikonfigurasi. Untuk informasi selengkapnya tentang meningkatkan atau menginstal AWS CLI, lihat Instalasi AWS Command Line Interface.
Langkah dalam Mengatur untuk menggunakan Amazon ECS telah selesai.
AWSPengguna Anda memiliki izin yang diperlukan yang ditentukan dalam contoh kebijakanIzin wizard yang dijalankan pertama Amazon ECS IAM.
Anda memiliki VPC dan grup keamanan yang dibuat untuk digunakan. Untuk informasi selengkapnya, lihat Buat virtual private cloud.
Peran CodeDeploy IAM Amazon ECS dibuat. Untuk informasi selengkapnya, lihat Peran CodeDeploy IAM Amazon ECS.

Langkah 1: Buat Application Load Balancer

Layanan Amazon ECS yang menggunakan tipe deployment biru/hijau yang memerlukan penggunaan Application Load Balancer atau Network Load Balancer. Tutorial ini menggunakan Application Load Balancer.

Untuk membuat Application Load Balancer

Gunakan create-load-balancerperintah untuk membuat Application Load Balancer. Tentukan dua subnet yang bukan dari Availability Zone serta grup keamanan yang sama.


aws elbv2 create-load-balancer \
     --name bluegreen-alb \
     --subnets subnet-abcd1234 subnet-abcd5678 \
     --security-groups sg-abcd1234 \
     --region us-east-1

Ouput tersebut mencakup Amazon Resource Name (ARN) dari penyeimbang beban, dengan format berikut:

arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642

Gunakan create-target-groupperintah untuk membuat grup target. Grup target ini akan merutekan lalu lintas ke tugas asli yang ditetapkan dalam layanan Anda.


aws elbv2 create-target-group \
     --name bluegreentarget1 \
     --protocol HTTP \
     --port 80 \
     --target-type ip \
     --vpc-id vpc-abcd1234 \
     --region us-east-1

Output termasuk ARN dari grup target, dengan format berikut:

arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4

Menggunakan perintah create-listener untuk membuat listener penyeimbang beban dengan aturan default yang meneruskan permintaan ke grup target.


aws elbv2 create-listener \
     --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
     --protocol HTTP \
     --port 80 \
     --default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4 \
     --region us-east-1

Output tersebut mencakup ARN listener, dengan format berikut:

arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4

Langkah 2: Buat klaster Amazon ECS

Gunakan perintah create-cluster untuk membuat sebuah klaster bernama tutorial-bluegreen-cluster untuk digunakan.


aws ecs create-cluster \
     --cluster-name tutorial-bluegreen-cluster \
     --region us-east-1

Output tersebut mencakup klaster ARN, dengan format berikut:

arn:aws:ecs:region:aws_account_id:cluster/tutorial-bluegreen-cluster

Langkah 3: Daftarkan ketentuan tugas

Gunakan register-task-definitionperintah untuk mendaftarkan ketentuan tugas yang kompatibel dengan Fargate. Hal ini membutuhkan penggunaan mode jaringan awsvpc. Berikut ini adalah contoh ketentuan tugas yang digunakan untuk tutorial ini.

Pertama, buat file bernama fargate-task.json dengan isi berikut. Pastikan bahwa Anda menggunakan ARN untuk peran eksekusi tugas Anda. Untuk informasi selengkapnya, lihat Peran IAM eksekusi tugas ECS.


{
    "family": "tutorial-task-def",
        "networkMode": "awsvpc",
        "containerDefinitions": [
            {
                "name": "sample-app",
                "image": "httpd:2.4",
                "portMappings": [
                    {
                        "containerPort": 80,
                        "hostPort": 80,
                        "protocol": "tcp"
                    }
                ],
                "essential": true,
                "entryPoint": [
                    "sh",
                    "-c"
                ],
                "command": [
                    "/bin/sh -c \"echo '<html> <head> <title>Amazon ECS Sample App</title> <style>body {margin-top: 40px; background-color: #333;} </style> </head><body> <div style=color:white;text-align:center> <h1>Amazon ECS Sample App</h1> <h2>Congratulations!</h2> <p>Your application is now running on a container in Amazon ECS.</p> </div></body></html>' >  /usr/local/apache2/htdocs/index.html && httpd-foreground\""
                ]
            }
        ],
        "requiresCompatibilities": [
            "FARGATE"
        ],
        "cpu": "256",
        "memory": "512",
        "executionRoleArn": "arn:aws:iam::aws_account_id:role/ecsTaskExecutionRole"
}

Kemudian daftarkan ketentuan tugas menggunakan file fargate-task.json yang Anda buat.


aws ecs register-task-definition \
     --cli-input-json file://fargate-task.json \
     --region us-east-1

Langkah 4: Buat layanan Amazon ECS

Gunakan perintah create-service untuk membuat layanan.

Pertama, buat file bernama service-bluegreen.json dengan konten berikut.


{
    "cluster": "tutorial-bluegreen-cluster",
    "serviceName": "service-bluegreen",
    "taskDefinition": "tutorial-task-def",
    "loadBalancers": [
        {
            "targetGroupArn": "arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4",
            "containerName": "sample-app",
            "containerPort": 80
        }
    ],
    "launchType": "FARGATE",
    "schedulingStrategy": "REPLICA",
    "deploymentController": {
        "type": "CODE_DEPLOY"
    },
    "platformVersion": "LATEST",
    "networkConfiguration": {
       "awsvpcConfiguration": {
          "assignPublicIp": "ENABLED",
          "securityGroups": [ "sg-abcd1234" ],
          "subnets": [ "subnet-abcd1234", "subnet-abcd5678" ]
       }
    },
    "desiredCount": 1
}

Kemudian buat layanan Anda menggunakan file service-bluegreen.json yang Anda buat.


aws ecs create-service \
     --cli-input-json file://service-bluegreen.json \
     --region us-east-1

Output tersebut mencakup ARN layanan, dengan format berikut:

arn:aws:ecs:region:aws_account_id:service/service-bluegreen

Langkah 5: Buat sumber daya AWS CodeDeploy

Gunakan langkah-langkah berikut untuk membuat CodeDeploy aplikasi Anda, grup target Application Load Balancer untuk grup CodeDeploy deployment, dan grup CodeDeploy deployment.

Untuk membuat CodeDeploy sumber daya

Gunakan perintah create-application untuk membuat CodeDeploy aplikasi. Tentukan platform komputasi ECS.


aws deploy create-application \
     --application-name tutorial-bluegreen-app \
     --compute-platform ECS \
     --region us-east-1

Output termasuk ID aplikasi, dengan format berikut:

{
    "applicationId": "b8e9c1ef-3048-424e-9174-885d7dc9dc11"
}

Gunakan create-target-groupperintah untuk membuat grup target Application Load Balancer kedua, yang akan digunakan saat membuat grup CodeDeploy penyebaran Anda.


aws elbv2 create-target-group \
     --name bluegreentarget2 \
     --protocol HTTP \
     --port 80 \
     --target-type ip \
     --vpc-id "vpc-0b6dd82c67d8012a1" \
     --region us-east-1

Output termasuk ARN untuk grup target, dengan format berikut:

arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/708d384187a3cfdc

Gunakan create-deployment-groupperintah untuk membuat grup CodeDeploy penyebaran.

Pertama, buat file bernama tutorial-deployment-group.json dengan konten berikut. Contoh ini menggunakan sumber daya yang Anda buat. UntukserviceRoleArn, tentukan ARN peran CodeDeploy IAM Amazon ECS Anda. Untuk informasi selengkapnya, lihat Peran CodeDeploy IAM Amazon ECS.


{
   "applicationName": "tutorial-bluegreen-app",
   "autoRollbackConfiguration": {
      "enabled": true,
      "events": [ "DEPLOYMENT_FAILURE" ]
   },
   "blueGreenDeploymentConfiguration": {
      "deploymentReadyOption": {
         "actionOnTimeout": "CONTINUE_DEPLOYMENT",
         "waitTimeInMinutes": 0
      },
      "terminateBlueInstancesOnDeploymentSuccess": {
         "action": "TERMINATE",
         "terminationWaitTimeInMinutes": 5
      }
   },
   "deploymentGroupName": "tutorial-bluegreen-dg",
   "deploymentStyle": {
      "deploymentOption": "WITH_TRAFFIC_CONTROL",
      "deploymentType": "BLUE_GREEN"
   },
   "loadBalancerInfo": {
      "targetGroupPairInfoList": [
        {
          "targetGroups": [
             {
                 "name": "bluegreentarget1"
             },
             {
                 "name": "bluegreentarget2"
             }
          ],
          "prodTrafficRoute": {
              "listenerArns": [
                  "arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4"
              ]
          }
        }
      ]
   },
   "serviceRoleArn": "arn:aws:iam::aws_account_id:role/ecsCodeDeployRole",
   "ecsServices": [
       {
           "serviceName": "service-bluegreen",
           "clusterName": "tutorial-bluegreen-cluster"
       }
   ]
}

Lalu buat grup CodeDeploy deployment.


aws deploy create-deployment-group \
     --cli-input-json file://tutorial-deployment-group.json \
     --region us-east-1

Output termasuk ID grup deployment, dengan format berikut:

{
    "deploymentGroupId": "6fd9bdc6-dc51-4af5-ba5a-0a4a72431c88"
}

Langkah 6: Buat dan pantau deployment CodeDeploy

Gunakan langkah-langkah berikut untuk membuat dan mengunggah file spesifikasi aplikasi (AppSpec file) dan CodeDeploy deployment.

Untuk membuat dan memantau CodeDeploy deployment

Buat dan unggah AppSpec file menggunakan langkah-langkah berikut.

Buat file bernama appspec.yaml dengan isi grup deployment CodeDeploy . Contoh ini menggunakan sumber daya yang Anda buat sebelumnya dalam tutorial.


version: 0.0
Resources:
  - TargetService:
      Type: AWS::ECS::Service
      Properties:
        TaskDefinition: "arn:aws:ecs:region:aws_account_id:task-definition/first-run-task-definition:7"
        LoadBalancerInfo:
          ContainerName: "sample-app"
          ContainerPort: 80
        PlatformVersion: "LATEST"

Gunakan perintah s3 mb untuk membuat bucket Amazon S3 untuk AppSpec file.
```
aws s3 mb s3://tutorial-bluegreen-bucket
```
Gunakan perintah s3 cp untuk mengunggah AppSpec file ke bucket Amazon S3.
```
aws s3 cp ./appspec.yaml s3://tutorial-bluegreen-bucket/appspec.yaml
```

Buat CodeDeploy deployment menggunakan langkah-langkah berikut.

Buat file bernamacreate-deployment.json dengan isi CodeDeploy deployment. Contoh ini menggunakan sumber daya yang Anda buat sebelumnya dalam tutorial.


{
    "applicationName": "tutorial-bluegreen-app",
    "deploymentGroupName": "tutorial-bluegreen-dg",
    "revision": {
        "revisionType": "S3",
        "s3Location": {
            "bucket": "tutorial-bluegreen-bucket",
            "key": "appspec.yaml",
            "bundleType": "YAML"
        }
    }
}

Gunakan perintah create-deployment untuk membuat deployment.


aws deploy create-deployment \
     --cli-input-json file://create-deployment.json \
     --region us-east-1

Output termasuk ID deployment, dengan format berikut:

{
    "deploymentId": "d-RPCR1U3TW"
}

Gunakan get-deployment-targetperintah untuk mendapatkan rincian penyebaran, menentukandeploymentId dari output sebelumnya.


aws deploy get-deployment-target \
     --deployment-id "d-IMJU3A8TW" \
     --target-id tutorial-bluegreen-cluster:service-bluegreen \
     --region us-east-1

Lanjutkan untuk mengambil detail deployment sampai status Succeeded, seperti yang ditunjukkan dalam output berikut.

{
    "deploymentTarget": {
        "deploymentTargetType": "ECSTarget",
        "ecsTarget": {
            "deploymentId": "d-RPCR1U3TW",
            "targetId": "tutorial-bluegreen-cluster:service-bluegreen",
            "targetArn": "arn:aws:ecs:region:aws_account_id:service/service-bluegreen",
            "lastUpdatedAt": 1543431490.226,
            "lifecycleEvents": [
                {
                    "lifecycleEventName": "BeforeInstall",
                    "startTime": 1543431361.022,
                    "endTime": 1543431361.433,
                    "status": "Succeeded"
                },
                {
                    "lifecycleEventName": "Install",
                    "startTime": 1543431361.678,
                    "endTime": 1543431485.275,
                    "status": "Succeeded"
                },
                {
                    "lifecycleEventName": "AfterInstall",
                    "startTime": 1543431485.52,
                    "endTime": 1543431486.033,
                    "status": "Succeeded"
                },
                {
                    "lifecycleEventName": "BeforeAllowTraffic",
                    "startTime": 1543431486.838,
                    "endTime": 1543431487.483,
                    "status": "Succeeded"
                },
                {
                    "lifecycleEventName": "AllowTraffic",
                    "startTime": 1543431487.748,
                    "endTime": 1543431488.488,
                    "status": "Succeeded"
                },
                {
                    "lifecycleEventName": "AfterAllowTraffic",
                    "startTime": 1543431489.152,
                    "endTime": 1543431489.885,
                    "status": "Succeeded"
                }
            ],
            "status": "Succeeded",
            "taskSetsInfo": [
                {
                    "identifer": "ecs-svc/9223370493425779968",
                    "desiredCount": 1,
                    "pendingCount": 0,
                    "runningCount": 1,
                    "status": "ACTIVE",
                    "trafficWeight": 0.0,
                    "targetGroup": {
                        "name": "bluegreentarget1"
                    }
                },
                {
                    "identifer": "ecs-svc/9223370493423413672",
                    "desiredCount": 1,
                    "pendingCount": 0,
                    "runningCount": 1,
                    "status": "PRIMARY",
                    "trafficWeight": 100.0,
                    "targetGroup": {
                        "name": "bluegreentarget2"
                    }
                }
            ]
        }
    }
}

Langkah 7: Bersihkan

Bila Anda telah menyelesaikan tutorial ini, bersihkan sumber daya yang terkait dengannya untuk menghindari biaya untuk sumber daya yang tidak Anda gunakan.

Membersihkan sumber daya tutorial

Gunakan delete-deployment-groupperintah untuk menghapus grup CodeDeploy penyebaran.


aws deploy delete-deployment-group \
     --application-name tutorial-bluegreen-app \
     --deployment-group-name tutorial-bluegreen-dg \
     --region us-east-1

Gunakan perintah delete-application untuk menghapus CodeDeploy aplikasi.


aws deploy delete-application \
     --application-name tutorial-bluegreen-app \
     --region us-east-1

Gunakan perintah delete-service untuk menghapus layanan Amazon ECS. Menggunakan bendera --force mengizinkan Anda untuk menghapus layanan bahkan jika itu tidak menurunkan skala ke tugas nol.
```
aws ecs delete-service \
     --service arn:aws:ecs:region:aws_account_id:service/service-bluegreen \
     --force \
     --region us-east-1
```

Gunakan perintah delete-cluster untuk menghapus klaster Amazon ECS.


aws ecs delete-cluster \
     --cluster tutorial-bluegreen-cluster \
     --region us-east-1

Gunakan perintah s3 rm untuk menghapus AppSpec file dari bucket Amazon S3.
```
aws s3 rm s3://tutorial-bluegreen-bucket/appspec.yaml
```
Gunakan perintah s3 rb untuk menghapus bucket Amazon S3.
```
aws s3 rb s3://tutorial-bluegreen-bucket
```

Gunakan delete-load-balancerperintah untuk menghapus Application Load Balancer.


aws elbv2 delete-load-balancer \
     --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
     --region us-east-1

Gunakan delete-target-groupperintah untuk menghapus dua grup target Application Load Balancer.


aws elbv2 delete-target-group \
     --target-group-arn arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4 \
     --region us-east-1


aws elbv2 delete-target-group \
     --target-group-arn arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/708d384187a3cfdc \
     --region us-east-1

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Tutorial: Membuat layanan menggunakan Service Discovery

Tutorial: Mendengarkan CloudWatch peristiwa Amazon ECS