Terapkan beban kerja dari DevOps pipeline Azure ke kluster Amazon EKS pribadi

Temukan GUID DevOps organisasi Azure.

Masuk ke DevOps akun Azure Anda, lalu gunakan URL berikut untuk menemukan GUID organisasi: https://dev.azure.com/{DevOps_Org_ID}/_apis/projectCollections?api-version=6.0 Di URL, ganti {DevOps_org_ID} dengan ID organisasi Azure DevOps Anda.

Konfigurasikan iDP di file. Akun AWS

Untuk mengonfigurasi penyedia Identitas (iDP) di Akun AWS sambungan layanan Azure, gunakan langkah-langkah berikut:

Untuk detail selengkapnya, lihat Cara federasi AWS dari Azure menggunakan DevOps OpenID Connect.

Buat kebijakan IAM di. Akun AWS

Untuk membuat kebijakan IAM guna memberikan izin yang diperlukan ke peran IAM yang digunakan oleh DevOps pipeline Azure, gunakan langkah-langkah berikut:

Buat peran IAM di. Akun AWS

Untuk mengonfigurasi peran IAM dalam Akun AWS koneksi layanan Azure, gunakan langkah-langkah berikut:

{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Federated": "arn:aws:iam::{account_id}:oidc-provider/vstoken.dev.azure.com/{OrganizationGUID}"
      },
      "Action": "sts:AssumeRoleWithWebIdentity",
      "Condition": {
        "StringEquals": {
          "vstoken.dev.azure.com/{OrganizationGUID}:aud": "api://AzureADTokenExchange",
          "vstoken.dev.azure.com/{OrganizationGUID}:sub": "sc://{OrganizationName}/{ProjectName}/{ServiceConnectionName}"
        }
      }
    }
  ]
}

Dalam kebijakan, berikan informasi Anda untuk placeholder berikut:

Buat koneksi layanan di DevOps akun Azure.

Untuk mengonfigurasi koneksi layanan Azure, gunakan langkah-langkah berikut:

Untuk detail selengkapnya, lihat Membuat sambungan layanan di dokumentasi Microsoft.

Tambahkan peran IAM ke file konfigurasi Amazon EKS.

Peran IAM harus memiliki izin yang diperlukan untuk melakukan operasi yang diperlukan di cluster Amazon EKS. Karena ini adalah peran pipeline, peran IAM harus dapat mengelola hampir semua jenis sumber daya di cluster. Oleh karena itu, izin system:masters grup sesuai untuk peran ini.

Untuk menambahkan konfigurasi yang diperlukan ke aws-auth ConfigMap dalam Kubernetes, gunakan kode berikut:

- groups:
  - system:masters
  rolearn: arn:aws:iam::{account_id}:role/ADO-role
  username: ADO-role

Ganti {account_id} dengan Akun AWS ID Anda.

Untuk informasi selengkapnya, lihat Cara Amazon EKS bekerja dengan IAM di dokumentasi Amazon EKS.

Buat kumpulan agen yang dihosting sendiri.

Untuk mengonfigurasi kumpulan agen yang dihosting sendiri di DevOps akun Azure, gunakan langkah-langkah berikut:

Untuk detail selengkapnya, lihat Membuat dan mengelola kumpulan agen di dokumentasi Microsoft.

Buat repositori Amazon ECR.

Gambar Docker yang digunakan untuk menyebarkan DevOps agen Azure dan aplikasi sampel (webapp) pada kluster Amazon EKS pribadi harus disimpan dalam repositori Amazon ECR. Untuk membuat repositori Amazon ECR, gunakan langkah-langkah berikut:

Untuk detail selengkapnya, lihat Membuat repositori pribadi Amazon ECR untuk menyimpan gambar dalam dokumentasi Amazon ECR.

Buat Dockerfile untuk membangun agen DevOps Azure.

Buat Dockerfile untuk membangun image Docker yang telah menginstal agen DevOps Azure. Simpan konten berikut dalam file bernamaDockerfile:

FROM ubuntu:22.04 
ENV TARGETARCH="linux-x64"
RUN apt update && apt upgrade -y && apt install -y curl git jq libicu70 unzip wget

RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
RUN unzip awscliv2.zip
RUN ./aws/install
RUN rm -rf aws awscliv2.zip

RUN curl -sSL https://get.docker.com/ | sh

RUN curl -sL https://aka.ms/InstallAzureCLIDeb | bash
RUN mkdir -p azp 
WORKDIR /azp/

COPY ./start.sh ./ 
RUN chmod +x ./start.sh

RUN useradd -m -d /home/agent agent 
RUN chown -R agent:agent /azp /home/agent
RUN groupadd -f docker 
RUN usermod -aG docker agent
USER agent

ENTRYPOINT [ "./start.sh" ]

Buat skrip untuk DevOps agen Azure.

Untuk membuat start.sh skrip, gunakan langkah-langkah berikut:

Buat gambar Docker dengan agen Azure DevOps .

Untuk membuat image Docker untuk menginstal DevOps agen Azure, gunakan Dockerfile yang Anda buat sebelumnya untuk membangun image. Di direktori yang sama tempat Dockerfile disimpan, jalankan perintah berikut:

aws ecr get-login-password --region region | docker login --username AWS --password-stdin aws_account_id.dkr.ecr.region.amazonaws.com

docker build --platform linux/amd64 -t ado-agent:latest .

docker tag ado-agent:latest aws_account_id.dkr.ecr.region.amazonaws.com/webapp:latest

docker push aws_account_id.dkr.ecr.region.amazonaws.com/webapp:latest

Ganti aws_account_id dan region dengan Akun AWS ID Anda dan Wilayah AWS.

Hasilkan token akses pribadi Azure.

Agen yang berjalan di kluster Amazon EKS pribadi memerlukan token akses pribadi (PAT) sehingga dapat mengautentikasi dengan akun Azure DevOps . Untuk menghasilkan PAT, gunakan langkah-langkah berikut:

apiVersion: v1
kind: Secret
metadata:
  name: azdevops-pat
  namespace: default
type: Opaque
stringData:
  AZP_TOKEN: <PAT Token>

kubectl create -f ado-secret.yaml

Untuk detail selengkapnya, lihat Mendaftarkan agen menggunakan token akses pribadi (PAT) di dokumentasi Microsoft.

Gunakan file manifes Kubernetes untuk penerapan agen.

Untuk menerapkan DevOps agen Azure di kluster Amazon EKS pribadi, salin file manifes berikut dan simpan file sebagai: agent-deployment.yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: azure-pipelines-agent-eks
  labels:
    app: azure-pipelines-agent
spec:
  replicas: 1
  selector:
    matchLabels:
      app: azure-pipelines-agent
  template:
    metadata:
      labels:
        app: azure-pipelines-agent
    spec:
      containers:
      - name: docker
        image: docker:dind
        securityContext: 
          privileged: true
        volumeMounts:
        - name: shared-workspace
          mountPath: /workspace
        - name: dind-storage
          mountPath: /var/lib/docker
        env:
        - name: DOCKER_TLS_CERTDIR
          value: ""
      - name: azure-pipelines-agent
        image: aws_account_id.dkr.ecr.region.amazonaws.com/webapp:latest
        env:
        - name: AZP_URL
          value: "<Azure account URL>"
        - name: AZP_POOL
          value: "eks-agent"
        - name: AZP_TOKEN
          valueFrom:
            secretKeyRef:
              name: azdevops-pat
              key: AZP_TOKEN
        - name: AZP_AGENT_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        - name: DOCKER_HOST
          value: tcp://localhost:2375
        volumeMounts:
        - mountPath: /workspace
          name: shared-workspace
      volumes:
      - name: dind-storage
        emptyDir: {}
      - name: shared-workspace
        emptyDir: {}

Ganti aws_account_id dan <Azure account URL> dengan Akun AWS ID dan URL DevOps akun Azure Anda.

Terapkan agen di cluster Amazon EKS pribadi.

Untuk menerapkan agen Azure Devops di klaster Amazon EKS pribadi, gunakan perintah berikut:

kubectl create -f agent-deployment.tf

Verifikasi agen sedang berjalan.

Untuk memverifikasi bahwa DevOps agen Azure sedang berjalan, gunakan perintah berikut:

kubectl get deploy azure-pipelines-agent-eks

Output yang diharapkan harus serupa dengan yang berikut:

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
azure-pipelines-agent-eks   1/1     1            1           58s

Pastikan bahwa READY kolom menunjukkan1/1.

Verifikasi agen terdaftar di kolam DevOps agen Azure.

Untuk memverifikasi bahwa agen dikerahkan di klaster Amazon EKS pribadi dan terdaftar di kumpulan ageneks-agent, gunakan langkah-langkah berikut:

Anda harus melihat satu agen terdaftar dengan Status Online, dan nama agen harus dimulai dengan azure-pipelines-agent-eks-*.

Garpu repositori aplikasi sampel ke akun Anda GitHub .

Lakukan fork repositori AWS Sampel berikut ke akun Anda GitHub :

https://github.com/aws-samples/deploy-kubernetes-resources-to- amazon-eks-using-azure -devops

Buat pipa.

Untuk membuat pipeline di DevOps akun Azure Anda, gunakan langkah-langkah berikut:

pool:
  name: eks-agent
#pool: self-hosted # If you are running self-hosted Azure DevOps Agents

stages:
# Refering the pipeline template, input parameter that are not specified will be added with defaults
- template: ./pipeline_templates/main_template.yaml
  parameters:
    serviceConnectionName: aws-sc
    awsRegion: <your region>
    awsEKSClusterName: <name of your EKS cluster>
    projectName: webapp

Verifikasi bahwa aplikasi sampel digunakan.

Setelah pipeline selesai, verifikasi keberhasilan penerapan aplikasi sampel dengan memeriksa repositori Amazon ECR dan kluster Amazon EKS.

Untuk memverifikasi artefak di repositori Amazon ECR, gunakan langkah-langkah berikut:

Misalnya, 20250501.1-image dan 20250501.1-helm.

Untuk memverifikasi penerapan pada kluster Amazon EKS pribadi di namespacewebapp, gunakan perintah berikut:

kubectl get deploy -n webapp 

Output yang diharapkan adalah sebagai berikut:

NAME     READY   UP-TO-DATE   AVAILABLE
webapp   1/1     1            1           

Catatan: Jika ini adalah proses pipeline pertama Anda, Anda mungkin perlu mengotorisasi koneksi layanan dan kumpulan agen. Cari permintaan izin di antarmuka DevOps pipeline Azure, dan setujui untuk melanjutkan.