Tutorial: Membuat pipeline dengan ECR sumber Amazon dan ECS -to- deployment CodeDeploy

Untuk membuat gambar

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

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

   docker pull nginx

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

   docker images

Untuk membuat ECR repositori Amazon dan mendorong gambar Anda

1. Buat ECR repositori Amazon 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 us-west-2 Region 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 IAMPeran Eksekusi ECS Tugas Amazon di Panduan ECS Pengembang Amazon.

   {
       "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 CodeDeploy penerapan. 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 Referensi CodeDeploy AppSpec 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 Create pipeline untuk tindakan penerapan Anda. 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 komit:

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

      2. Pilih Tambahkan 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 subnet default VPC dan publik

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

2. Verifikasi default VPC untuk digunakan. Di panel navigasi, pilih Your VPCs. Catatan yang VPC menunjukkan Ya di VPC kolom Default. Ini adalah defaultnyaVPC. Ini berisi subnet default untuk Anda pilih.

3. Pilih Subnet. Pilih dua subnet yang menunjukkan Ya di kolom subnet Default.

   catatan

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

4. Pilih subnet, lalu pilih tab Deskripsi. Verifikasi bahwa subnet yang ingin Anda gunakan berada di Availability Zone yang berbeda.

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

Untuk membuat EC2 Application Load Balancer Amazon

1. Masuk ke AWS Management Console dan buka EC2 konsol Amazon 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 Create.

5. Di Nama, masukkan nama penyeimbang beban Anda.

6. Dalam Skema, pilih yang menghadap ke internet.

7. Dalam jenis alamat IP, pilih ipv4.

8. Konfigurasikan dua port pendengar untuk penyeimbang beban Anda:

   1. Di bawah Protokol Load Balancer, pilih. HTTP Di bawah Port Load Balancer, masukkan. 80

   2. Pilih Tambahkan pendengar.

   3. Di bawah Protokol Load Balancer untuk pendengar kedua, pilih. HTTP Di bawah Port Load Balancer, masukkan. 8080

9. Di bawah Availability Zones VPC, di, pilih defaultVPC. 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 buat catatan ID grup keamanan.

13. Pilih Selanjutnya: Konfigurasi Perutean.

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

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

    2. Pada tipe Target, pilih IP.

    3. Dalam Protokol pilih HTTP. Di Pelabuhan, 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. Pada tipe Target, pilih IP.

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

6. Di VPC, pilih defaultVPC.

7. Pilih Buat.

   catatan

   Anda harus memiliki dua grup target yang dibuat untuk penyeimbang beban Anda agar penerapan Anda berjalan. Anda hanya perlu membuat catatan ARN dari kelompok target pertama Anda. ARNIni digunakan dalam create-service JSON file pada langkah berikutnya.

Untuk memperbarui penyeimbang beban Anda untuk memasukkan grup target kedua Anda

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

2. Pilih penyeimbang beban Anda, lalu pilih tab Listeners. Pilih listener dengan port 8080, lalu pilih Edit.

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

Untuk membuat ECS cluster Amazon

1. Buka konsol ECS klasik Amazon 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 Next step.

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

Untuk membuat ECS layanan Amazon

Gunakan AWS CLI untuk membuat layanan Anda di AmazonECS.

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

   Untuk taskDefinition bidang tersebut, saat Anda mendaftarkan definisi tugas di AmazonECS, Anda memberinya 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 Application Load Balancer dan grup target

   catatan

   Anda perlu memasukkan grup target Anda ARN dalam file ini. Buka EC2 konsol Amazon dan dari panel navigasi, di bawah LOADBALANCING, pilih Grup Target. Pilih kelompok target pertama Anda. Salin Anda ARN 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. Jalankan create-service perintah, tentukan JSON file:

   penting

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

   Contoh ini menciptakan 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 kolom deskripsi untuk layanan Anda.

3. Jalankan describe-services 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 ECS.

4. Pilih Create application (Buat aplikasi).

Untuk membuat CodeDeploy grup penyebaran

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

2. Dalam nama grup Deployment, masukkan nama yang menjelaskan grup penyebaran.

3. Dalam peran Layanan, pilih peran layanan yang memberikan CodeDeploy akses ke AmazonECS. Untuk membuat peran layanan baru, ikuti langkah-langkah berikut:

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

   2. Dari dasbor konsol, pilih Peran.

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

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

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

4. Dalam konfigurasi Lingkungan, pilih nama ECS klaster Amazon dan nama layanan Anda.

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

6. Dari port pendengar Produksi, pilih port dan protokol untuk pendengar yang menyajikan jalur produksi ke layanan Amazon Anda. ECS Dari port Test listener, pilih port dan protokol untuk test listener.

7. Dari nama grup target 1 dan nama Grup target 2, pilih grup target yang digunakan untuk merutekan lalu lintas selama penyebaran Anda. Pastikan bahwa ini adalah kelompok target yang Anda buat untuk penyeimbang beban Anda.

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

9. Pilih Buat grup penyebaran.

Untuk membuat pipeline dua tahap dengan wizard

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

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

3. Di Langkah 1: Pilih pengaturan alur, di Nama alur, masukkan MyImagePipeline.

4. Dalam tipe Pipeline, pilih V2. Untuk informasi selengkapnya, lihat Jenis pipa. Pilih Berikutnya.

5. Di peran Layanan, pilih Peran layanan baru CodePipeline untuk memungkinkan membuat peran layananIAM.

6. Biarkan pengaturan di bawah Pengaturan lanjutan pada defaultnya, lalu pilih Berikutnya.

7. Pada Langkah 2: Tambahkan tahap sumber, di penyedia Sumber, pilih AWS CodeCommit. Dalam nama Repositori, pilih nama CodeCommit repositori yang Anda buat. Langkah 1: Buat CodeCommit repositori Di Nama cabang, pilih nama cabang yang berisi pembaruan kode terbaru Anda.

   Pilih Berikutnya.

8. Pada Langkah 3: Tambahkan tahap build, pilih Lewati tahap build, lalu terima pesan peringatan dengan memilih Lewati lagi. Pilih Berikutnya.

9. Pada Langkah 4: Tambahkan tahap penerapan:

   1. Di penyedia Deploy, pilih Amazon ECS (Biru/Hijau). Di Nama aplikasi, masukkan atau pilih nama aplikasi dari daftar, seperticodedeployapp. Di grup Deployment, masukkan atau pilih nama grup penyebaran dari daftar, seperti. codedeploydeplgroup

      catatan

      Nama “Deploy” adalah nama yang diberikan secara default ke tahap yang dibuat di Langkah 4: Deploy step, sama seperti “Source” adalah nama yang diberikan untuk tahap pertama pipeline.

   2. Di bawah definisi ECS tugas Amazon, 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 Gambar definisi tugas perbarui secara dinamis.

   4. Pilih Berikutnya.

10. Pada Langkah 5: Tinjau, tinjau informasinya, lalu pilih Buat pipeline.

Untuk menambahkan tindakan ECR sumber Amazon ke pipeline Anda

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

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

2. Pada tahap sumber, pilih Edit tahap.

3. Tambahkan aksi 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. Dalam nama Repositori, pilih nama repositori Amazon ECR Anda.

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

8. Di artefak Output, pilih artefak keluaran default (misalnya,MyImage) yang berisi nama gambar dan URI informasi repositori yang Anda inginkan untuk digunakan pada tahap berikutnya.

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

Untuk menghubungkan artefak sumber Anda ke tindakan penerapan

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

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

3. Dalam Definisi Tugas SourceArtifact, pilih, lalu verifikasi taskdef.json dimasukkan.

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

5. Dalam Perbarui gambar definisi tugas secara dinamis, di Input Artifact with URI Image, MyImagepilih, lalu masukkan teks placeholder yang digunakan dalam file:. taskdef.json IMAGE1_NAME Pilih Simpan.

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

   Setelah contoh pipeline ini dibuat, konfigurasi tindakan untuk entri konsol muncul di 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 Rilis perubahan, lalu pilih Rilis.

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 menghentikan set tugas asli. Anda dapat menggunakan waktu ini untuk memutar kembali atau menghentikan tugas, tetapi penerapan Anda akan selesai saat set tugas dihentikan.