Tutorial: Menyebarkan aplikasi ke Amazon EKS

Untuk meluncurkan Lingkungan Dev

1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

2. Arahkan ke proyek Anda,codecatalyst-eks-project.

3. Di panel navigasi, pilih Kode, lalu pilih Repositori sumber.

4. Pilih nama repositori sumber Anda,. codecatalyst-eks-source-repository

5. Di dekat bagian atas pilih Create Dev Environment, lalu pilih AWS Cloud9 (di browser).

6. Pastikan bahwa Work di cabang dan main yang ada dipilih, lalu pilih Buat.

   Lingkungan Dev Anda diluncurkan di tab browser baru, dan repositori (codecatalyst-eks-source-repository) Anda dikloning ke dalamnya.

Untuk menginstal dan mengkonfigurasi kubectl

1. Di terminal Dev Environment, masukkan:

   curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl

2. Masukkan:

   chmod +x ./kubectl

3. Masukkan:

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin

4. Masukkan:

   echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

5. Masukkan:

   kubectl version --short --client

6. Periksa apakah ada versi yang muncul.

   Anda sekarang telah menginstalkubectl.

Untuk menginstal dan mengkonfigurasi eksctl

1. Di terminal Dev Environment, masukkan:

   curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp

2. Masukkan:

   sudo cp /tmp/eksctl /usr/bin

3. Masukkan:

   eksctl version

4. Periksa apakah ada versi yang muncul.

   Anda sekarang telah menginstaleksctl.

Untuk memverifikasi bahwa AWS CLI sudah diinstal

1. Di terminal Dev Environment, masukkan:

   aws --version

2. Periksa apakah versi muncul untuk memverifikasi bahwa AWS CLI sudah diinstal.

   Lengkapi prosedur yang tersisa untuk mengkonfigurasi AWS CLI dengan izin yang diperlukan untuk mengakses AWS.

1. Buat pengguna Pusat IAM Identitas, sebagai berikut:

   1. Masuk ke AWS Management Console dan buka AWS IAM Identity Center konsol di https://console.aws.amazon.com/singlesignon/.

      (Anda mungkin perlu memilih Aktifkan jika Anda belum pernah masuk ke Pusat IAM Identitas sebelumnya.)

      catatan

      Pastikan Anda masuk menggunakan Akun AWS yang terhubung ke CodeCatalyst ruang Anda. Anda dapat memverifikasi akun mana yang terhubung dengan menavigasi ke ruang Anda dan memilih tab AWSakun. Untuk informasi selengkapnya, lihat Menciptakan ruang.

   2. Pada panel navigasi, silakan pilih Pengguna, lalu pilih Tambahkan pengguna.

   3. Di Nama Pengguna, masukkan:

      codecatalyst-eks-user

   4. Di bawah Kata Sandi, pilih Buat kata sandi satu kali yang dapat Anda bagikan dengan pengguna ini.

   5. Di Alamat email dan Konfirmasi alamat email, masukkan alamat email yang belum ada di Pusat IAM Identitas.

   6. Di Nama depan, masukkan:

      codecatalyst-eks-user

   7. Di Nama belakang, masukkan:

      codecatalyst-eks-user

   8. Di Nama tampilan, simpan:

      codecatalyst-eks-user codecatalyst-eks-user

   9. Pilih Berikutnya.

   10. Pada halaman Tambahkan pengguna ke grup, pilih Berikutnya.

   11. Pada halaman Tinjau dan tambahkan pengguna, tinjau informasi dan pilih Tambah pengguna.

       Kotak dialog kata sandi satu kali muncul.

   12. Pilih Salin lalu tempel informasi masuk ke file teks. Informasi masuk terdiri dari portal AWS akses, nama penggunaURL, dan kata sandi satu kali.

   13. Pilih Tutup.

2. Buat set izin, sebagai berikut:

   1. Di panel navigasi, pilih Set izin, lalu pilih Buat set izin.

   2. Pilih Set izin yang telah ditentukan sebelumnya dan kemudian pilih AdministratorAccess. Kebijakan ini memberikan izin penuh untuk semua layanan AWS.

   3. Pilih Berikutnya.

   4. Dalam nama set Izin, hapus AdministratorAccess dan masukkan:

      codecatalyst-eks-permission-set

   5. Pilih Berikutnya.

   6. Pada halaman Tinjau dan buat, tinjau informasi dan pilih Buat.

3. Tetapkan izin yang disetel kecodecatalyst-eks-user, sebagai berikut:

   1. Di panel navigasi, pilih Akun AWS, lalu pilih kotak centang di Akun AWS samping tempat Anda masuk saat ini.

   2. Pilih Tetapkan pengguna atau grup.

   3. Pilih tab Pengguna.

   4. Pilih kotak centang di sebelahcodecatalyst-eks-user.

   5. Pilih Berikutnya.

   6. Pilih kotak centang di sebelahcodecatalyst-eks-permission-set.

   7. Pilih Berikutnya.

   8. Tinjau informasi dan pilih Kirim.

      Anda sekarang telah menetapkan codecatalyst-eks-user dan codecatalyst-eks-permission-set untuk Anda Akun AWS, mengikat mereka bersama-sama.

4. Dapatkan codecatalyst-eks-user kunci akses dan token sesi, sebagai berikut:

   1. Pastikan Anda memiliki portal AWS akses dan nama pengguna URL dan kata sandi satu kali untukcodecatalyst-eks-user. Anda seharusnya menyalin informasi ini ke editor teks sebelumnya.

      catatan

      Jika Anda tidak memiliki informasi ini, buka halaman codecatalyst-eks-user detail di Pusat IAM Identitas, pilih Atur ulang kata sandi, Hasilkan kata sandi satu kali [...] , dan Atur ulang kata sandi lagi untuk menampilkan informasi di layar.

   2. Keluar dari AWS.

   3. Tempelkan portal AWS akses URL ke bilah alamat browser Anda.

   4. Masuk dengan:

      • Nama Pengguna:

        codecatalyst-eks-user

      • Kata Sandi:

        one-time-password

   5. Di Tetapkan kata sandi baru, masukkan kata sandi baru dan pilih Atur kata sandi baru.

      Sebuah Akun AWSkotak muncul di layar.

   6. Pilih Akun AWS, lalu pilih nama yang Akun AWS Anda tetapkan codecatalyst-eks-user pengguna dan set izin.

   7. Di sampingcodecatalyst-eks-permission-set, pilih Baris perintah atau akses terprogram.

   8. Salin perintah di tengah halaman. Mereka terlihat mirip dengan yang berikut:

      export AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE" 
      export AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" 
      export AWS_SESSION_TOKEN="session-token"

      ... dimana session-token adalah string acak panjang.

5. Tambahkan kunci akses dan token sesi ke AWS CLI, sebagai berikut:

   1. Kembali ke Lingkungan CodeCatalyst Pengembang Anda.

   2. Pada prompt terminal, tempel perintah yang Anda salin. Tekan Enter.

      Anda sekarang telah mengonfigurasi tombol akses AWS CLI dengan dan token sesi. Anda sekarang dapat menggunakan AWS CLI untuk menyelesaikan tugas-tugas yang diperlukan oleh tutorial ini.

      penting

      Jika sewaktu-waktu selama tutorial ini Anda melihat pesan yang mirip dengan:

      Unable to locate credentials. You can configure credentials by running "aws configure".

      Atau:

      ExpiredToken: The security token included in the request is expired

      ... itu karena AWS CLI sesi Anda telah kedaluwarsa. Dalam hal ini, jangan jalankan aws configure perintah. Sebagai gantinya, gunakan instruksi pada langkah 4 dari prosedur ini yang dimulai dengan Obtain codecatalyst-eks-user's access key and session token untuk menyegarkan sesi Anda.

Untuk membuat klaster DB

1. Pergi ke Lingkungan Pengembang Anda.

2. Buat cluster dan node:

   eksctl create cluster --name codecatalyst-eks-cluster --region us-west-2

   Di mana:

   • codecatalyst-eks-cluster diganti dengan nama yang ingin Anda berikan pada cluster Anda.

   • us-west-2 diganti dengan wilayah Anda.

   Setelah 10-20 menit, pesan yang mirip dengan yang berikut ini muncul:

   EKS cluster "codecatalyst-eks-cluster" in "us-west-2" region is ready

   catatan

   Anda akan melihat beberapa waiting for CloudFormation stack pesan saat AWS membuat cluster Anda. Ini yang diharapkan.

3. Verifikasi bahwa klaster Anda berhasil dibuat:

   kubectl cluster-info

   Anda akan melihat pesan yang mirip dengan berikut ini, yang menunjukkan pembuatan cluster yang berhasil:

   Kubernetes master is running at https://long-string.gr7.us-west-2.eks.amazonaws.com
   CoreDNS is running at https://long-string.gr7.us-west-2.eks.amazonaws.com/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy

Untuk membuat repositori gambar di Amazon ECR

1. Pergi ke Lingkungan Pengembang Anda.

2. Buat repositori kosong di Amazon: ECR

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

   Ganti codecatalyst-eks-image-repo dengan nama yang ingin Anda berikan pada ECR repositori Amazon.

   Tutorial ini mengasumsikan Anda menamai codecatalyst-eks-image-repo repositori Anda.

3. Tampilkan detail ECR repositori Amazon:

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

4. Perhatikan “repositoryUri”: nilainya, misalnya,111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo.

   Anda membutuhkannya nanti saat menambahkan repositori ke alur kerja Anda.

Untuk menambahkan file index.html

1. Pergi ke Lingkungan Pengembang Anda.

2. Dicodecatalyst-eks-source-repository, buat folder bernamapublic-html.

3. Di/public-html, buat file yang disebut index.html dengan konten berikut:

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

4. Pada prompt terminal, masukkan:

   cd /projects/codecatalyst-eks-source-repository

5. Tambahkan, komit, dan dorong:

   git add .
   git commit -m "add public-html/index.html"
   git push

   Ditambahkan ke repositori Anda dalam folder. index.html public-html

Untuk menambahkan Dockerfile

1. Dicodecatalyst-eks-source-repository, buat file yang disebut Dockerfile dengan konten berikut:

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

   Jangan sertakan ekstensi file.

   penting

   Dockerfile harus berada di folder root repositori Anda. Docker buildPerintah alur kerja mengharapkannya ada di sana.

2. Tambahkan, komit, dan dorong:

   git add .
   git commit -m "add Dockerfile"
   git push

   Dockerfile ditambahkan ke repositori Anda.

Untuk menambahkan berkas deployment.yaml

1. Dicodecatalyst-eks-source-repository, buat folder bernamaKubernetes.

2. Di/Kubernetes, buat file yang disebut deployment.yaml dengan konten berikut:

   apiVersion: v1
   kind: Service
   metadata:
     name: my-service
     labels:
       app: my-app
   spec:
     type: LoadBalancer
     selector:
       app: my-app
     ports:
       - protocol: TCP
         port: 80
         targetPort: 80
   ---
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: my-deployment
     labels:
       app: my-app
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: my-app
     template:
       metadata:
         labels:
           app: my-app
       spec:
         containers:
         - name: codecatalyst-eks-container
           # The $REPOSITORY_URI and $IMAGE_TAG placeholders will be replaced by actual values supplied by the build action in your workflow
           image: $REPOSITORY_URI:$IMAGE_TAG
           ports:
           - containerPort: 80

3. Tambahkan, komit, dan dorong:

   git add .
   git commit -m "add Kubernetes/deployment.yaml"
   git push

   deployment.yamlFile ditambahkan ke repositori Anda dalam folder bernama. Kubernetes

1. Untuk membuat kebijakan kepercayaan untuk kedua peran

1. Pergi ke Lingkungan Pengembang Anda.

2. Di Cloud9-long-string direktori, buat file yang disebut codecatalyst-eks-trust-policy.json dengan konten berikut:

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

2. Untuk membuat kebijakan build untuk peran build

• Di Cloud9-long-string direktori, buat file yang disebut codecatalyst-eks-build-policy.json dengan konten berikut:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "ecr:*",
                  "ec2:*"
              ],
              "Resource": "*"
          }
      ]
  }

  catatan

  Pertama kali peran digunakan untuk menjalankan tindakan alur kerja, gunakan wildcard dalam pernyataan kebijakan sumber daya dan kemudian cakup kebijakan dengan nama sumber daya setelah tersedia.

  "Resource": "*"

3. Untuk membuat kebijakan penerapan untuk peran penerapan

• Di Cloud9-long-string direktori, buat file yang disebut codecatalyst-eks-deploy-policy.json dengan konten berikut:

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "eks:DescribeCluster",
                  "eks:ListClusters"
              ],
              "Resource": "*"
          }
      ]
  }

  catatan

  Pertama kali peran digunakan untuk menjalankan tindakan alur kerja, gunakan wildcard dalam pernyataan kebijakan sumber daya dan kemudian cakup kebijakan dengan nama sumber daya setelah tersedia.

  "Resource": "*"

4. Untuk menambahkan kebijakan build ke AWS

1. Di terminal Dev Environment, masukkan:

   cd /projects

2. Masukkan:

   aws iam create-policy \
       --policy-name codecatalyst-eks-build-policy \
       --policy-document file://codecatalyst-eks-build-policy.json

3. Tekan Enter.

4. Dalam output perintah, perhatikan "arn": nilainya, misalnya,arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy. Kau butuh ini ARN nanti.

5. Untuk menambahkan kebijakan penerapan ke AWS

1. Masukkan:

   aws iam create-policy \
       --policy-name codecatalyst-eks-deploy-policy \
       --policy-document file://codecatalyst-eks-deploy-policy.json

2. Tekan Enter.

3. Dalam output perintah, perhatikan "arn": nilai kebijakan penerapan, misalnya,arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy. Kau butuh ini ARN nanti.

6. Untuk membuat peran build

1. Masukkan:

   aws iam create-role \
         --role-name codecatalyst-eks-build-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Tekan Enter.

3. Masukkan:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-build-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy

   Di mana arn:aws:iam::111122223333:policy/codecatalyst-eks-build-policy diganti dengan kebijakan build ARN yang Anda sebutkan sebelumnya.

4. Tekan Enter.

5. Pada prompt terminal, masukkan:

   aws iam get-role \
         --role-name codecatalyst-eks-build-role

6. Tekan Enter.

7. Perhatikan "Arn": nilai peran, misalnya,arn:aws:iam::111122223333:role/codecatalyst-eks-build-role. Kau butuh ini ARN nanti.

7. Untuk membuat peran penerapan

1. Masukkan:

   aws iam create-role \
         --role-name codecatalyst-eks-deploy-role \
         --assume-role-policy-document file://codecatalyst-eks-trust-policy.json

2. Tekan Enter.

3. Masukkan:

   aws iam attach-role-policy \
         --role-name codecatalyst-eks-deploy-role \
         --policy-arn arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy

   Di mana arn:aws:iam::111122223333:policy/codecatalyst-eks-deploy-policy diganti dengan kebijakan ARN penerapan yang Anda sebutkan sebelumnya.

4. Tekan Enter.

5. Masukkan:

   aws iam get-role \
         --role-name codecatalyst-eks-deploy-role

6. Tekan Enter.

7. Perhatikan "Arn": nilai peran, misalnya,arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role. Kau butuh ini ARN nanti.

Untuk menambahkan peran build dan deploy ke Akun AWS

1. Di CodeCatalyst konsol, navigasikan ke ruang Anda.

2. Di bagian atas, pilih Pengaturan.

3. Di panel navigasi, pilih AWS akun. Daftar akun muncul.

4. Di kolom nama CodeCatalyst tampilan Amazon, salin nama tampilan Akun AWS tempat Anda membuat peran build dan deploy. (Bisa jadi angka.) Anda akan membutuhkan nilai ini nanti, saat membuat alur kerja Anda.

5. Pilih nama tampilan.

6. Pilih Kelola peran dari konsol AWS manajemen.

   Halaman CodeCatalyst ruang Tambahkan IAM peran ke Amazon muncul. Anda mungkin perlu masuk untuk mengakses halaman.

7. Pilih Tambahkan peran yang sudah Anda buat IAM.

   Daftar drop-down muncul. Daftar ini menampilkan peran build dan deploy, serta IAM peran lainnya dengan kebijakan trust yang mencakup prinsip codecatalyst-runner.amazonaws.com dan codecatalyst.amazonaws.com service principal.

8. Dari daftar drop-down, tambahkan:

   • codecatalyst-eks-build-role

   • codecatalyst-eks-deploy-role

   catatan

   Jika Anda melihatThe security token included in the request is invalid, itu mungkin karena Anda tidak memiliki izin yang tepat. Untuk memperbaiki masalah ini, keluar dari AWS sebagai masuk kembali dengan AWS akun yang Anda gunakan saat membuat CodeCatalyst ruang.

9. Kembali ke CodeCatalyst konsol dan segarkan halaman.

   Peran build dan deploy sekarang akan muncul di bawah IAMperan.

   Peran ini sekarang tersedia untuk digunakan dalam CodeCatalyst alur kerja.

Untuk mengkonfigurasi file Kubernetes ConfigMap menggunakan eksctl

• Di terminal Dev Environment, masukkan:

  eksctl create iamidentitymapping --cluster codecatalyst-eks-cluster --arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role --group system:masters --username codecatalyst-eks-deploy-role --region us-west-2

  Di mana:

  • codecatalyst-eks-cluster diganti dengan nama cluster EKS cluster Amazon.

  • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role diganti dengan peran ARN penerapan yang Anda buat. Langkah 5: Buat AWS peran

  • codecatalyst-eks-deploy-role (di sebelah--username) diganti dengan nama peran penerapan yang Anda buat. Langkah 5: Buat AWS peran

    catatan

    Jika Anda memutuskan untuk tidak membuat peran penerapan, ganti codecatalyst-eks-deploy-role dengan nama CodeCatalystWorkflowDevelopmentRole-spaceName peran. Untuk informasi selengkapnya tentang peran ini, silakan lihat Langkah 5: Buat AWS peran.

  • us-west-2 diganti dengan wilayah Anda.

  Untuk detail tentang perintah ini, lihat Mengelola IAM pengguna dan peran.

  Pesan yang mirip dengan berikut ini muncul:

  2023-06-09 00:58:29 [ℹ]  checking arn arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role against entries in the auth ConfigMap
  2023-06-09 00:58:29 [ℹ]  adding identity "arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role" to auth ConfigMap

Untuk mengkonfigurasi file Kubernetes ConfigMap menggunakan kubectl

1. Di terminal Dev Environment, masukkan:

   kubectl edit configmap -n kube-system aws-auth

   ConfigMap File muncul di layar.

2. Tambahkan teks dengan huruf miring merah:

   # Please edit the object below. Lines beginning with a '#' will be ignored,
   # and an empty file will abort the edit. If an error occurs while saving this file will be
   # reopened with the relevant failures.
   #
   apiVersion: v1
   data:
     mapRoles: |
       - groups:
         - system:bootstrappers
         - system:nodes
         rolearn: arn:aws:iam::111122223333:role/eksctl-codecatalyst-eks-cluster-n-NodeInstanceRole-16BC456ME6YR5
         username: system:node:{{EC2PrivateDNSName}}
       - groups:
         - system:masters
         rolearn: arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role
         username: codecatalyst-eks-deploy-role
     mapUsers: |
       []
   kind: ConfigMap
   metadata:
     creationTimestamp: "2023-06-08T19:04:39Z"
     managedFields:
     ...

   Di mana:

   • arn:aws:iam::111122223333:role/codecatalyst-eks-deploy-role diganti dengan peran ARN penerapan yang Anda buat. Langkah 5: Buat AWS peran

   • codecatalyst-eks-deploy-role (di sebelahusername:) diganti dengan nama peran penerapan yang Anda buat. Langkah 5: Buat AWS peran

     catatan

     Jika Anda memutuskan untuk tidak membuat peran penerapan, ganti codecatalyst-eks-deploy-role dengan nama CodeCatalystWorkflowDevelopmentRole-spaceName peran. Untuk informasi selengkapnya tentang peran ini, silakan lihat Langkah 5: Buat AWS peran.

   Untuk detailnya, lihat Mengaktifkan akses IAM utama ke klaster Anda di Panduan EKS Pengguna Amazon.

Untuk membuat alur kerja

1. Pergi ke CodeCatalyst konsol.

2. Arahkan ke proyek Anda (codecatalyst-eks-project).

3. Di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

4. Pilih Buat alur kerja.

5. Untuk repositori Sumber, pilih. codecatalyst-eks-source-repository

6. Untuk Cabang, pilihmain.

7. Pilih Buat.

8. Hapus kode YAML sampel.

9. Tambahkan YAML kode berikut untuk membuat file definisi alur kerja baru:

   catatan

   Untuk informasi selengkapnya tentang file definisi alur kerja, lihatDefinisi alur kerja YAML.

   catatan

   Dalam YAML kode berikut, Anda dapat menghilangkan Connections: bagian jika Anda mau. Jika Anda menghilangkan bagian ini, Anda harus memastikan bahwa peran yang ditentukan dalam bidang IAMperan default di lingkungan Anda mencakup izin dan kebijakan kepercayaan dari kedua peran yang dijelaskan. Langkah 6: Tambahkan AWS peran CodeCatalyst Untuk informasi selengkapnya tentang menyiapkan lingkungan dengan IAM peran default, lihatPembuatan lingkungan.

   Name: codecatalyst-eks-workflow
   SchemaVersion: 1.0
   
   Triggers:
     - Type: PUSH
       Branches:
         - main
   Actions:
     BuildBackend:
       Identifier: aws/build@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-build-role
       Inputs:
         Sources:
           - WorkflowSource
         Variables:
           - Name: REPOSITORY_URI
             Value: 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-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 deployment.yaml
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$REPOSITORY_URI|$REPOSITORY_URI|g"
           - Run: find Kubernetes/ -type f | xargs sed -i "s|\$IMAGE_TAG|$IMAGE_TAG|g"
           - Run: cat Kubernetes/*
           # The output artifact will be a zip file that contains Kubernetes manifest files.
       Outputs:
         Artifacts:
           - Name: Manifests
             Files: 
               - "Kubernetes/*"
     DeployToEKS:
       DependsOn: 
         - BuildBackend
       Identifier: aws/kubernetes-deploy@v1
       Environment:
         Name: codecatalyst-eks-environment
         Connections:
           - Name: codecatalyst-account-connection
             Role: codecatalyst-eks-deploy-role
       Inputs:
         Artifacts:
           - Manifests
       Configuration:
         Namespace: default
         Region: us-west-2
         Cluster: codecatalyst-eks-cluster
         Manifests: Kubernetes/

   Pada kode sebelumnya, ganti:

   • Kedua contoh codecatalyst-eks-environment dengan nama lingkungan yang Anda buatPrasyarat.

   • Kedua contoh codecatalyst-account-connection dengan nama tampilan koneksi akun Anda. Nama tampilan mungkin nomor. Untuk informasi selengkapnya, lihat Langkah 6: Tambahkan AWS peran CodeCatalyst.

   • codecatalyst-eks-build-role dengan nama peran build yang Anda buatLangkah 5: Buat AWS peran.

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-eks-image-repo (di Value: properti) dengan URI ECR repositori Amazon yang Anda buat. Langkah 3: Buat repositori ECR gambar Amazon

   • 111122223333.dkr.ecr.us-west-2.amazonaws.com (dalam Run: aws ecr perintah) dengan ECR repositori Amazon tanpa akhiran gambar (). URI /codecatalyst-eks-image-repo

   • codecatalyst-eks-deploy-role dengan nama peran penerapan yang Anda buat. Langkah 5: Buat AWS peran

   • Kedua contoh us-west-2 dengan kode AWS Region Anda. Untuk daftar kode Region, lihat Titik akhir Regional di. Referensi Umum AWS

   catatan

   Jika Anda memutuskan untuk tidak membuat peran build dan deploy, ganti codecatalyst-eks-build-role and codecatalyst-eks-deploy-role dengan nama CodeCatalystWorkflowDevelopmentRole-spaceName peran. Untuk informasi selengkapnya tentang peran ini, silakan lihat Langkah 5: Buat AWS peran.

10. (Opsional) Pilih Validasi untuk memastikan bahwa YAML kode tersebut valid sebelum melakukan.

11. Pilih Terapkan.

12. Dalam kotak dialog Commit workflow, masukkan yang berikut ini:

    1. Untuk pesan Commit, hapus teks dan masukkan:

       Add first workflow

    2. Untuk Repositori, pilih. codecatalyst-eks-source-repository

    3. Untuk nama Branch, pilih main.

    4. Pilih Terapkan.

    Anda sekarang telah membuat alur kerja. Jalankan alur kerja dimulai secara otomatis karena pemicu yang ditentukan di bagian atas alur kerja. Khususnya, ketika Anda melakukan (dan mendorong) workflow.yaml file ke repositori sumber Anda, pemicu memulai alur kerja dijalankan.

Untuk melihat alur kerja, jalankan kemajuan

1. Di panel navigasi CodeCatalyst konsol, pilih CI/CD, lalu pilih Alur kerja.

2. Pilih alur kerja yang baru saja Anda buat,codecatalyst-eks-workflow.

3. Pilih BuildBackenduntuk melihat kemajuan pembangunan.

4. Pilih DeployToEKSuntuk melihat kemajuan penerapan.

   Untuk informasi selengkapnya tentang melihat detail run, lihatMelihat status dan detail alur kerja.

Untuk memverifikasi penyebaran

1. Buka EC2 konsol Amazon di https://console.aws.amazon.com/ec2/.

2. Di sebelah kiri, dekat bagian bawah, pilih Load Balancers.

3. Pilih load balancer yang dibuat sebagai bagian dari penerapan Kubernetes Anda. Jika Anda tidak yakin penyeimbang beban mana yang harus dipilih, cari tag berikut di bawah tab Tag:

   • kubernetes.io/service-name

   • kubernetes.io/cluster/ekstutorialcluster

4. Dengan penyeimbang beban yang benar dipilih, pilih tab Deskripsi.

5. Salin dan tempel nilai DNSnama ke bilah alamat browser Anda.

   'Halo, Dunia! ' halaman web muncul di browser Anda, menunjukkan bahwa Anda berhasil menerapkan aplikasi Anda.

Untuk mengubah index.html

1. Pergi ke Lingkungan Pengembang Anda.

2. Pada prompt terminal, ubah ke repositori sumber Anda:

   cd /projects/codecatalyst-eks-source-repository

3. Tarik perubahan alur kerja terbaru:

   git pull

4. Buka codecatalyst-eks-source-repository/public-html/index.html.

5. Pada baris 14, ubah Hello, World! teks menjadiTutorial complete!.

6. Tambahkan, komit, dan dorong:

   git add .
   git commit -m "update index.html title"
   git push

   Jalankan alur kerja dimulai secara otomatis.

7. (Opsional) Masukkan:

   git show HEAD

   Perhatikan ID komit untuk index.html perubahan tersebut. ID komit ini akan ditandai ke image Docker yang akan digunakan oleh alur kerja yang baru saja Anda mulai.

8. Perhatikan kemajuan penerapan:

   1. Di CodeCatalyst konsol, di panel navigasi, pilih CI/CD, lalu pilih Alur kerja.

   2. Pilih codecatalyst-eks-workflow untuk melihat proses terbaru.

   3. Pilih BuildBackend, dan DeployToEKSuntuk melihat alur kerja berjalan kemajuan.

9. Verifikasi bahwa aplikasi Anda telah diperbarui, sebagai berikut:

   1. Buka EC2 konsol Amazon di https://console.aws.amazon.com/ec2/.

   2. Di sebelah kiri, dekat bagian bawah, pilih Load Balancers.

   3. Pilih load balancer yang dibuat sebagai bagian dari penerapan Kubernetes Anda.

   4. Salin dan tempel nilai DNSnama ke bilah alamat browser Anda.

      'Tutorial Lengkap! ' halaman web muncul di browser Anda, menunjukkan bahwa Anda berhasil menerapkan revisi baru aplikasi Anda.

10. (Opsional) Di AWS, alihkan ke ECR konsol Amazon dan verifikasi bahwa image Docker baru ditandai dengan ID komit dari langkah 7 prosedur ini.

Untuk membersihkan

1. Hapus klaster Anda:

   1. Di terminal Dev Environment, masukkan:

      eksctl delete cluster --region=us-west-2 --name=codecatalyst-eks-cluster

      Di mana:

      • us-west-2 diganti dengan wilayah Anda.

      • codecatalyst-eks-cluster diganti dengan nama cluster yang Anda buat.

      Setelah 5-10 menit, cluster dan sumber daya terkait dihapus, termasuk namun tidak terbatas pada AWS CloudFormation tumpukan, grup node (di AmazonEC2), dan penyeimbang beban.

   penting

   Jika eksctl delete cluster perintah tidak berfungsi, Anda mungkin perlu me-refresh kredensyal atau AWS kredensyal Andakubectl. Jika Anda tidak yakin kredensyal mana yang akan disegarkan, segarkan kredensialnya terlebih AWS dahulu. Untuk menyegarkan AWS kredensyal Anda, lihat. Bagaimana cara memperbaiki kesalahan “Tidak dapat menemukan kredensil” dan “ExpiredToken”? Untuk menyegarkan kubectl kredensyal Anda, lihat. Bagaimana cara memperbaiki kesalahan “Tidak dapat terhubung ke server”?

2. Di AWS konsol, bersihkan sebagai berikut:

   1. Di AmazonECR, hapuscodecatalyst-eks-image-repo.

   2. Di Pusat IAM Identitas, hapus:

      1. codecatalyst-eks-user

      2. codecatalyst-eks-permission-set

   3. DalamIAM, hapus:

      • codecatalyst-eks-build-role

      • codecatalyst-eks-deploy-role

      • codecatalyst-eks-build-policy

      • codecatalyst-eks-deploy-policy

3. Di CodeCatalyst konsol, bersihkan sebagai berikut:

   1. Hapuscodecatalyst-eks-workflow.

   2. Hapuscodecatalyst-eks-environment.

   3. Hapuscodecatalyst-eks-source-repository.

   4. Hapus Lingkungan Pengembang Anda.

   5. Hapuscodecatalyst-eks-project.