Tutorial: Buat pipeline dengan sumber dan ECS-to-CodeDeploy penerapan Amazon ECR

Untuk membuat gambar

1. Masuk ke instance Linux Anda di mana Anda telah menginstal Docker.

   Tarik gambar ke bawah untuknginx. Perintah ini menyediakan nginx:latest gambar:

   docker pull nginx

2. Jalankan docker images. Anda harus melihat gambar dalam daftar.

   docker images

Untuk membuat repositori Amazon ECR dan mendorong gambar Anda

1. Buat repositori Amazon ECR untuk menyimpan gambar Anda. Buat catatan repositoryUri di output.

   aws ecr create-repository --repository-name nginx

   Output:

   {
       "repository": {
           "registryId": "aws_account_id",
           "repositoryName": "nginx",
           "repositoryArn": "arn:aws:ecr:us-east-1:aws_account_id:repository/nginx",
           "createdAt": 1505337806.0,
           "repositoryUri": "aws_account_id.dkr.ecr.us-east-1.amazonaws.com/nginx"
       }
   }

2. Tandai gambar dengan repositoryUri nilai dari langkah sebelumnya.

   docker tag nginx:latest aws_account_id.dkr.ecr.us-east-1.amazonaws.com/nginx:latest

3. Jalankan aws ecr get-login-password perintah, seperti yang ditunjukkan dalam contoh ini untuk Wil us-west-2 ayah dan ID akun 111122223333.

   aws ecr get-login-password --region us-west-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-west-2.amazonaws.com/nginx

4. Dorong gambar ke Amazon ECR menggunakan repositoryUri dari langkah sebelumnya.

   docker push 111122223333.dkr.ecr.us-east-1.amazonaws.com/nginx:latest

Untuk membuat definisi tugas untuk gambar Anda

1. Buat file bernama taskdef.json dengan isi berikut ini. Untukimage, masukkan nama gambar Anda, seperti nginx. Nilai ini diperbarui saat pipeline Anda berjalan.

   catatan

   Pastikan bahwa peran eksekusi yang ditentukan dalam definisi tugas berisiAmazonECSTaskExecutionRolePolicy. Untuk informasi selengkapnya, lihat Per an IAM Eksekusi Tugas Amazon ECS di Panduan Pengembang Amazon ECS.

   {
       "executionRoleArn": "arn:aws:iam::account_ID:role/ecsTaskExecutionRole",
       "containerDefinitions": [
           {
               "name": "sample-website",
               "image": "nginx",
               "essential": true,
               "portMappings": [
                   {
                       "hostPort": 80,
                       "protocol": "tcp",
                       "containerPort": 80
                   }
               ]
           }
       ],
       "requiresCompatibilities": [
           "FARGATE"
       ],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512",
       "family": "ecs-demo"
   }

2. Daftarkan definisi tugas Anda dengan taskdef.json file.

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

3. Setelah definisi tugas terdaftar, edit file Anda untuk menghapus nama gambar dan sertakan teks <IMAGE1_NAME> placeholder di bidang gambar.

   {
       "executionRoleArn": "arn:aws:iam::account_ID:role/ecsTaskExecutionRole",
       "containerDefinitions": [
           {
               "name": "sample-website",
               "image": "<IMAGE1_NAME>",
               "essential": true,
               "portMappings": [
                   {
                       "hostPort": 80,
                       "protocol": "tcp",
                       "containerPort": 80
                   }
               ]
           }
       ],
       "requiresCompatibilities": [
           "FARGATE"
       ],
       "networkMode": "awsvpc",
       "cpu": "256",
       "memory": "512",
       "family": "ecs-demo"
   }

Untuk membuat AppSpec file

• AppSpec File ini digunakan untuk pener CodeDeploy apan. File, yang mencakup bidang opsional, menggunakan format ini:

  version: 0.0
  Resources:
    - TargetService:
        Type: AWS::ECS::Service
        Properties:
          TaskDefinition: "task-definition-ARN"
          LoadBalancerInfo:
            ContainerName: "container-name"
            ContainerPort: container-port-number
  # Optional properties
          PlatformVersion: "LATEST"
          NetworkConfiguration:
              AwsvpcConfiguration:
                Subnets: ["subnet-name-1", "subnet-name-2"]
                SecurityGroups: ["security-group"]
                AssignPublicIp: "ENABLED"
  Hooks:
  - BeforeInstall: "BeforeInstallHookFunctionName"
  - AfterInstall: "AfterInstallHookFunctionName"
  - AfterAllowTestTraffic: "AfterAllowTestTrafficHookFunctionName"
  - BeforeAllowTraffic: "BeforeAllowTrafficHookFunctionName"
  - AfterAllowTraffic: "AfterAllowTrafficHookFunctionName"

  Untuk informasi selengkapnya tentang AppSpec file, termasuk contoh, lihat Refer CodeDeploy AppSpec ensi File.

  Buat file bernama appspec.yaml dengan isi berikut ini. UntukTaskDefinition, jangan mengubah teks <TASK_DEFINITION> placeholder. Nilai ini diperbarui saat pipeline Anda berjalan.

  version: 0.0
  Resources:
    - TargetService:
        Type: AWS::ECS::Service
        Properties:
          TaskDefinition: <TASK_DEFINITION>
          LoadBalancerInfo:
            ContainerName: "sample-website"
            ContainerPort: 80

Untuk mendorong file ke CodeCommit repositori Anda

1. Dorong atau unggah file ke CodeCommit repositori Anda. File-file ini adalah artefak sumber yang dibuat oleh wizard Buat pipeline untuk tindakan penerapan Anda di CodePipeline. File Anda akan terlihat seperti ini di direktori lokal Anda:

   /tmp
     |my-demo-repo
       |-- appspec.yaml
       |-- taskdef.json

2. Pilih metode yang ingin Anda gunakan untuk mengunggah file Anda:

   1. Untuk menggunakan baris perintah git Anda dari repositori kloning di komputer lokal Anda:

      1. Ubah direktori ke repositori lokal Anda:

         (For Linux, macOS, or Unix) cd /tmp/my-demo-repo
         (For Windows) cd c:\temp\my-demo-repo

      2. Jalankan perintah berikut untuk mementaskan semua file Anda sekaligus:

         git add -A

      3. Jalankan perintah berikut untuk mengkomit file dengan pesan commit:

         git commit -m "Added task definition files"

      4. Jalankan perintah berikut untuk mendorong file dari repo lokal Anda ke CodeCommit repositori Anda:

         git push

   2. Untuk menggunakan CodeCommit konsol untuk mengunggah file Anda:

      1. Buka CodeCommit konsol, dan pilih repositori Anda dari daftar Repositories.

      2. Pilih Tambah file, lalu pilih Unggah file.

      3. Pilih Pilih file, lalu telusuri file Anda. Lakukan perubahan dengan memasukkan nama pengguna dan alamat email Anda. Pilih Perubahan commit.

      4. Ulangi langkah ini untuk setiap file yang ingin Anda unggah.

Untuk memverifikasi VPC default dan subnet publik

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon VPC di https://console.aws.amazon.com/vpc/.

2. Verifikasi VPC default yang akan digunakan. Pada panel navigasi, pilih VPC Anda. Perhatikan VPC mana yang menampilkan Ya di kolom VPC Default. Ini adalah VPC default. Ini berisi subnet default untuk Anda pilih.

3. Pilih Subnets. Pilih dua subnet yang menampilkan Ya di kolom subnet default.

   catatan

   Catat ID subnet Anda. Anda membutuhkannya nanti dalam tutorial ini.

4. Pilih subnet, lalu pilih tab Deskripsi. Pastikan subnet yang ingin Anda gunakan berada di Zona Ketersediaan yang berbeda.

5. Pilih subnet, lalu pilih tab Tabel Rute. Untuk memverifikasi bahwa setiap subnet yang ingin Anda gunakan adalah subnet publik, konfirmasikan bahwa baris gateway disertakan dalam tabel rute.

Cara membuat Penyeimbang Beban Aplikasi Amazon EC2

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di https://console.aws.amazon.com/ec2/.

2. Di panel navigasi, pilih Load Balancers.

3. Pilih Buat Penyeimbang Beban.

4. Pilih Application Load Balancer, lalu pilih Buat.

5. Di Nama, masukkan nama penyeimbang beban Anda.

6. Di Skema, pilih menghadap ke internet.

7. Dalam jenis alamat IP, pilih ipv4.

8. Konfigurasikan dua port pendengar untuk penyeimbang beban Anda:

   1. Di bawah Protokol Penyeimbang B eb an, pilih HTTP. Di bawah Port Penyeimbang Beban, masukkan80.

   2. Pilih Tambahkan pendengar.

   3. Di bawah Load Balancer Protocol untuk pendengar kedua, pilih HTTP. Di bawah Port Penyeimbang Beban, masukkan8080.

9. Di bawah Zona Ketersediaan, di VPC, pilih VPC default. Selanjutnya, pilih dua subnet default yang ingin Anda gunakan.

10. Pilih Selanjutnya: Konfigurasikan Pengaturan Keamanan.

11. Pilih Selanjutnya: Konfigurasikan Grup Keamanan.

12. Pilih Pilih grup keamanan yang ada, dan catat ID grup keamanan.

13. Pilih Selanjutnya: Konfigurasi Perutean.

14. Di Grup Target, pilih Grup target baru dan konfigurasikan kelompok target pertama Anda:

    1. Di Nama, masukkan nama grup target (misalnya,target-group-1).

    2. Di Jenis Target, pilih IP.

    3. Dalam Protokol pilih HTTP. Di Port, masukkan80.

    4. Pilih Selanjutnya: Daftarkan Target.

15. Pilih Berikutnya: Tinjau, lalu pilih Buat.

Untuk membuat grup target kedua untuk penyeimbang beban Anda

1. Setelah penyeimbang beban Anda disediakan, buka konsol Amazon EC2. Di panel navigasi, pilih Target Groups.

2. PilihBuat grup target.

3. Di Nama, masukkan nama grup target (misalnya,target-group-2).

4. Di Jenis Target, pilih IP.

5. Dalam Protokol pilih HTTP. Di Port, masukkan8080.

6. Di VPC, pilih VPC default.

7. Pilih Buat.

   catatan

   Anda harus memiliki dua grup target yang dibuat untuk penyeimbang beban agar penerapan Anda dapat berjalan. Anda hanya perlu mencatat ARN kelompok sasaran pertama Anda. ARN ini digunakan dalam file create-service JSON pada langkah berikutnya.

Untuk memperbarui penyeimbang beban Anda untuk menyertakan grup target kedua Anda

1. Buka konsol Amazon EC2. Di panel navigasi, pilih Load Balancers.

2. Pilih penyeimbang beban Anda, lalu pilih tab List ers. Pilih pendengar dengan port 8080, lalu pilih Edit.

3. Pilih ikon pensil di sebelah Maj u ke. Pilih kelompok target kedua Anda, lalu pilih tanda centang. Pilih Perbarui untuk menyimpan pembaruan.

Cara membuat cluster Amazon ECS

1. Buka konsol klasik Amazon ECS di https://console.aws.amazon.com/ecs/.

2. Di panel navigasi, pilih Kluster.

3. Pilih Buat kluster.

4. Pilih template cluster Networking only yang menggunakan AWS Fargate, lalu pilih Langkah berikutnya.

5. Masukkan nama cluster pada halaman Konfigurasi cluster. Anda dapat menambahkan tag opsional untuk sumber daya Anda. Pilih Buat.

Cara membuat layanan Amazon ECS

Gunakan AWS CLI untuk membuat layanan Anda di Amazon ECS.

1. Buat file JSON dan beri namacreate-service.json. Tempelkan berikut ini ke dalam file JSON.

   Untuk taskDefinition bidang tersebut, saat Anda mendaftarkan definisi tugas di Amazon ECS, Anda memberikannya keluarga. Ini mirip dengan nama untuk beberapa versi definisi tugas, ditentukan dengan nomor revisi. Dalam contoh ini, gunakan "ecs-demo:1" untuk keluarga dan nomor revisi dalam file Anda. Gunakan nama subnet, grup keamanan, dan nilai grup target yang Anda buat dengan penyeimbang beban Anda. Langkah 3: Buat Penyeimbang Beban Aplikasi dan kelompok sasaran

   catatan

   Anda perlu menyertakan kelompok target ARN Anda dalam file ini. Buka konsol Amazon EC2 dan dari panel navigasi, di bawah LO AD BALANCING, pilih Grup Target. Pilih kelompok sasaran pertama Anda. Salin ARN Anda dari tab Deskripsi.

   {
       "taskDefinition": "family:revision-number",
       "cluster": "my-cluster",
       "loadBalancers": [
           {
               "targetGroupArn": "target-group-arn",
               "containerName": "sample-website",
               "containerPort": 80
           }
       ],
       "desiredCount": 1,
       "launchType": "FARGATE",
       "schedulingStrategy": "REPLICA",
       "deploymentController": {
           "type": "CODE_DEPLOY"
       },
       "networkConfiguration": {
           "awsvpcConfiguration": {
               "subnets": [
                   "subnet-1",
                   "subnet-2"
               ],
               "securityGroups": [
                   "security-group"
               ],
               "assignPublicIp": "ENABLED"
           }
       }
   }

2. Jalan create-service kan perintah, tentukan file JSON:

   penting

   Pastikan untuk menyertakan file:// sebelum nama file. Diperlukan dalam perintah ini.

   Contoh ini membuat layanan bernamamy-service.

   catatan

   Perintah contoh ini membuat layanan bernama my-service. Jika Anda sudah memiliki layanan dengan nama ini, perintah mengembalikan kesalahan.

   aws ecs create-service --service-name my-service --cli-input-json file://create-service.json

   Output mengembalikan bidang deskripsi untuk layanan Anda.

3. Jalan describe-services kan perintah untuk memverifikasi bahwa layanan Anda telah dibuat.

   aws ecs describe-services --cluster cluster-name --services service-name

Untuk membuat CodeDeploy aplikasi

1. Buka CodeDeploy konsol dan pilih Buat aplikasi.

2. Di Nama aplikasi, masukkan nama yang ingin Anda gunakan.

3. Di platform Compute, pilih Amazon EC S.

4. Pilih Create application (Buat aplikasi).

Untuk membuat grup CodeDeploy penerapan

1. Pada tab Grup penerapan halaman aplikasi Anda, pilih Buat grup penerapan.

2. Di Nama grup pener apan, masukkan nama yang menjelaskan grup penerapan.

3. Di Peran layanan, pilih peran layanan yang memberikan CodeDeploy akses ke Amazon ECS. Untuk membuat peran layanan baru, ikuti langkah-langkah berikut:

   1. Buka konsol IAM di https://console.aws.amazon.com/iam/.

   2. Dari dasbor konsol, pilih Per an.

   3. Pilih Buat peran.

   4. Di bawah Pilih jenis entitas tepercaya, pilih Layanan AWS. Di bawah Pilih kasus penggunaan, pilih CodeDeploy. Di bawah Pilih kasus penggunaan Anda, pilih CodeDeploy - ECS. Pilih Berikutnya: Izin. Kebijakan yang AWSCodeDeployRoleForECS dikelola sudah melekat pada peran.

   5. Pilih Berikutnya: Tag, dan Berikutnya: Review.

   6. Masukkan nama untuk peran (misalnya,CodeDeployECSRole), lalu pilih Buat peran.

4. Di Konfigurasi Lingkungan, pilih nama cluster Amazon ECS dan nama layanan Anda.

5. Dari Load penyeim bang, pilih nama penyeimbang beban yang melayani lalu lintas ke layanan Amazon ECS Anda.

6. Dari port pendengar produksi, pilih port dan protokol untuk pendengar yang melayani lalu lintas produksi ke layanan Amazon ECS Anda. Dari Port pendengar uji, pilih port dan protokol untuk pendengar uji.

7. Dari Nama grup Target 1 dan Nama grup Target 2, pilih grup target yang digunakan untuk merutekan lalu lintas selama penerapan Anda. Pastikan bahwa ini adalah grup target yang Anda buat untuk penyeimbang beban Anda.

8. Pilih Ubah ulang lalu lintas segera untuk menentukan berapa lama setelah penerapan berhasil mengalihkan lalu lintas ke tugas Amazon ECS Anda yang diperbarui.

9. Pilih Buat grup penerapan.

Untuk membuat pipa dua tahap dengan wizard

1. Masuk ke Konsol Manajemen AWS dan buka CodePipeline konsol di http://console.aws.amazon.com/codesuite/codepipeline/home.

2. Pada halaman Selamat Datang, halaman Mem ulai, atau halaman Pipelines, pilih Buat pipeline.

3. Pada Langkah 1: Pilih halaman opsi pembuatan, di bawah Opsi pembuatan, pilih opsi Build custom pipeline. Pilih Berikutnya.

4. Di Langkah 2: Pilih pengaturan pipa, di Nama Pipeline, masukkanMyImagePipeline.

5. CodePipeline menyediakan pipa tipe V1 dan V2, yang berbeda dalam karakteristik dan harga. Jenis V2 adalah satu-satunya jenis yang dapat Anda pilih di konsol. Untuk informasi selengkapnya, lihat Jenis jalur. Untuk informasi tentang penetapan harga untuk CodePipeline, lihat Harga.

6. Di Peran layanan, pilih Peran layanan baru untuk memungkinkan CodePipeline untuk membuat peran layanan di IAM.

7. Biarkan pengaturan di bawah Peng aturan lanj utan pada defaultnya, lalu pilih Ber ikutnya.

8. Pada Langkah 3: Tambahkan tahap sumber, di Penye dia Sumber, pilih AWS CodeCommit. Di Nama Repositori, pilih nama CodeCommit repositori yang Anda buatLangkah 1: Buat CodeCommit repositori. Di Nama cabang, pilih nama cabang yang berisi pembaruan kode terbaru Anda.

   Pilih Berikutnya.

9. Pada Langkah 4: Tambahkan tahap build, pilih Lewati tahap build, lalu terima pesan peringatan dengan memilih Le wati lagi. Pilih Berikutnya.

10. Pada Langkah 5: Tambahkan tahap pengujian, pilih Lewati tahap pengujian, lalu terima pesan peringatan dengan memilih Le wati lagi.

    Pilih Berikutnya.

11. Pada Langkah 6: Tambahkan tahap penerapan:

    1. Di Penye dia De ploy, pilih Amazon ECS (Blue/Green). Di Nama aplikasi, masukkan atau pilih nama aplikasi dari daftar, seperticodedeployapp. Di grup Deployment, masukkan atau pilih nama grup penerapan dari daftar, seperticodedeploydeplgroup.

       catatan

       Nama “Deploy” adalah nama yang diberikan secara default ke tahap yang dibuat pada langkah Langkah 4: Deploy, sama seperti “Sumber” adalah nama yang diberikan untuk tahap pertama pipeline.

    2. Di bawah definisi tugas Amazon ECS, pilih SourceArtifact. Di lapangan, masukkantaskdef.json.

    3. Di bawah AWS CodeDeploy AppSpec file, pilih SourceArtifact. Di lapangan, masukkanappspec.yaml.

       catatan

       Pada titik ini, jangan mengisi informasi apa pun di bawah Perbarui gambar definisi tugas secara dinamis.

    4. Pilih Berikutnya.

12. Pada Langkah 7: Tinjau, tinjau informasi, lalu pilih Buat pipeline.

Untuk menambahkan tindakan sumber Amazon ECR ke pipeline Anda

Lihat pipeline Anda dan tambahkan tindakan sumber Amazon ECR ke pipeline Anda.

1. Pilih pipa Anda. Di kiri atas, pilih Edit.

2. Pada tahap sumber, pilih Edit stage.

3. Tambahkan tindakan paralel dengan memilih + Tambahkan tindakan di sebelah tindakan CodeCommit sumber Anda.

4. Di Nama tindakan, masukkan nama (misalnya,Image).

5. Di penyedia Action, pilih Amazon ECR.

   

6. Di Nama Repositori, pilih nama repositori Amazon ECR Anda.

7. Di Tag gambar, tentukan nama gambar dan versi, jika berbeda dari yang terbaru.

8. Di Artefak keluaran, pilih default artefak keluaran (misalnya,MyImage) yang berisi nama gambar dan informasi URI repositori yang ingin digunakan tahap selanjutnya.

9. Pilih Simpan di layar tindakan. Pilih Selesai di layar panggung. Pilih Simpan di pipa. Sebuah pesan menunjukkan aturan Amazon CloudWatch Events yang akan dibuat untuk tindakan sumber Amazon ECR.

Untuk menghubungkan artefak sumber Anda ke tindakan penerapan

1. Pilih Edit pada tahap Deploy Anda dan pilih ikon untuk mengedit tindakan Amazon ECS (Blue/Green).

2. Gulir ke bagian bawah panel. Di Artefak masukan, pilih Tambah. Tambahkan artefak sumber dari repositori Amazon ECR baru Anda (misalnya,MyImage).

3. Di Task Definition SourceArtifact, pilih, dan kemudian taskdef.json verifikasi dimasukkan.

4. Di AWS CodeDeploy AppSpec File, pilih SourceArtifact, dan kemudian appspec.yaml verifikasi dimasukkan.

5. Di Perbarui gambar definisi tugas secara dinamis, di Input Artifact dengan URI Gambar MyImage, pilih, lalu masukkan teks placeholder yang digunakan dalam file:. taskdef.json IMAGE1_NAME Pilih Simpan.

6. Di AWS CodePipeline panel, pilih S impan perubahan pipeline, lalu pilih S impan perubahan. Lihat pipeline Anda yang diperbarui.

   Setelah contoh pipeline ini dibuat, konfigurasi tindakan untuk entri konsol muncul dalam struktur pipeline sebagai berikut:

   "configuration": {
     "AppSpecTemplateArtifact": "SourceArtifact",
     "AppSpecTemplatePath": "appspec.yaml",
     "TaskDefinitionTemplateArtifact": "SourceArtifact",
     "TaskDefinitionTemplatePath": "taskdef.json",
     "ApplicationName": "codedeployapp",
     "DeploymentGroupName": "codedeploydeplgroup",
     "Image1ArtifactName": "MyImage",
     "Image1ContainerName": "IMAGE1_NAME"
   },
   

7. Untuk mengirimkan perubahan dan memulai pembuatan pipeline, pilih R ilis perubahan, lalu pilih R ilis.

8. Pilih tindakan penerapan untuk melihatnya CodeDeploy dan melihat kemajuan pergeseran lalu lintas.

   catatan

   Anda mungkin melihat langkah penerapan yang menunjukkan waktu tunggu opsional. Secara default, CodeDeploy menunggu satu jam setelah penerapan berhasil sebelum mengakhiri set tugas asli. Anda dapat menggunakan waktu ini untuk memutar kembali atau mengakhiri tugas, tetapi penerapan Anda akan selesai ketika set tugas dihentikan.