Triển khai ứng dụng với helm chart qua ArgoCD

Tổng quan

Yêu cầu

• Đã cài đặt ArgoCD (Tham khảo tại đây)
• Đã cài đặt Harbor Registry (Tham khảo tại phần 6 trong seri docker)

Workflow CI/CD Tổng thể

Nội dung bài lab

PHẦN I – Làm việc thủ công với Helm: Tạo Helm Chart template, cấu hình các file manifest (deployment, service, ingress), đóng gói và đẩy lên Harbor Registry để hiểu rõ cấu trúc cơ bản.

PHẦN II – Cấu hình Harbor: Tạo Project trên Harbor, cấu hình quyền truy cập và thực hiện push Helm Chart lên Registry một cách thủ công.

PHẦN III – Tự động hóa với Jenkins & ArgoCD: Xây dựng pipeline Jenkins để tự động build, đóng gói và push artifacts. Sau đó sử dụng ArgoCD để tự động triển khai ứng dụng lên Kubernetes theo phương pháp GitOps.

# 1. Cài đặt plugin helm(nếu chưa có)
iadmin@srv025-aio:~$ cd ~/devops/
iadmin@srv025-aio:~/devops$ mkdir helm-chart
iadmin@srv025-aio:~/devops$ cd helm-chart
iadmin@srv025-aio:~/devops/helm-chart$ wget https://get.helm.sh/helm-v4.0.1-linux-amd64.tar.gz
iadmin@srv025-aio:~/devops/helm-chart$ tar xvfz helm-v4.0.1-linux-amd64.tar.gz
iadmin@srv025-aio:~/devops/helm-chart$ sudo cp linux-amd64/helm  /usr/local/bin/

# Kiểm tra
iadmin@srv025-aio:~/devops/helm-chart$ helm version
version.BuildInfo{Version:"v4.0.1", GitCommit:"12500dd401faa7629f30ba5d5bff36287f3e94d3", GitTreeState:"clean", GoVersion:"go1.25.4", KubeClientVersion:"v1.34"}

# 2. Cài đặt plugin helm 
iadmin@srv025-aio:~/devops/helm-chart$ helm plugin install https://github.com/chartmuseum/helm-push --verify=false

# 3. Đăng nhập vào Harbor Registry
# (Đăng nhập bằng user "admin" đã được cấp quyền "Project Admin")
iadmin@srv025-aio:~/devops$ helm registry login harbor.diendo.pro.vn -u beobeo
Password: 
Login Succeeded

# 1. Tạo thư mục làm việc
mkdir ~/devops/helm-chart/
cd ~/devops/helm-chart/

# 2. Tạo chart mẫu với tên "helm create template-ha-config"
helm create template-ha-config

# 3. Dọn dẹp các file YAML mẫu (Cách làm "chuẩn")
echo "" > template-ha-config/templates/service.yaml
echo "" > template-ha-config/templates/deployment.yaml
echo "" > template-ha-config/templates/ingress.yaml

kubectl create namespace ha-config

kubectl create secret docker-registry harbor-registry-creds \
--docker-server=harbor.diendo.pro.vn \
--docker-username=beobeo \
--docker-password=your-password \
--namespace=ha-config

helm install ha-config ./template-ha-config --namespace=ha-config

cat <<EOF | tee template-ha-config/templates/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ .Values.deployment.name }}
  namespace: {{ .Release.Namespace }} # <-- Tự động lấy namespace lúc cài
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: {{ .Values.deployment.name }}
  template:
    metadata:
      labels:
        app: {{ .Values.deployment.name }}
    spec:
      {{- with .Values.imagePullSecrets }}
      imagePullSecrets:
        {{- toYaml . | nindent 8 }}
      {{- end }}
      containers:
      - name: ha-config-frontend
        image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
        imagePullPolicy: {{ .Values.image.pullPolicy }}
        ports:
        - containerPort: {{ .Values.service.targetPort }}
        env:
        {{- if .Values.secret.enabled }}
        - name: REACT_APP_GEMINI_API_KEY
          valueFrom:
            secretKeyRef:
              name: {{ .Values.secret.name }}
              key: {{ .Values.secret.key }}
        {{- end }}
EOF

cat <<EOF | tee template-ha-config/templates/service.yaml
apiVersion: v1
kind: Service
metadata:
  name: {{ .Values.service.name }}
  namespace: {{ .Release.Namespace }}
spec:
  type: {{ .Values.service.type }}
  selector:
    app: {{ .Values.deployment.name }}  # <-- Phải khớp với label của Deployment
  ports:
    - protocol: TCP
      port: {{ .Values.service.port }}
      targetPort: {{ .Values.service.targetPort }}
EOF

cat <<EOF | tee template-ha-config/templates/ingress.yaml
apiVersion: v1
kind: Service
metadata:
  name: {{ .Values.service.name }}
  namespace: {{ .Release.Namespace }}
spec:
  type: {{ .Values.service.type }}
  selector:
    app: {{ .Values.deployment.name }} 
  ports:
    - protocol: TCP
      port: {{ .Values.service.port }}
      targetPort: {{ .Values.service.targetPort }}
EOF

cat <<EOF | tee template-ha-config/values.yaml
replicaCount: 1

deployment:
  name: ha-config

imagePullSecrets:
  - name: harbor-registry-creds

image:
  repository: harbor.diendo.pro.vn/haproxy-ops/ai-ha-config
  # Tag này sẽ được Jenkins cập nhật tự động khi build (ví dụ: "1.0.8")
  tag: "latest"
  pullPolicy: Always

service:
  name: ha-config-svc
  type: NodePort
  port: 80
  targetPort: 80
  # NodePort range: 30000-32767
  nodePort: 30007

ingress:
  enabled: true
  name: ha-config-ingress
  className: nginx
  host: "ha-config.diendo.pro.vn"

# Cấu hình Secret cho API Key
secret:
  enabled: true
  name: "gemini-api-key"   # Tên Secret trong Kubernetes
  key: "apiKey"            # Tên Key trong Secret
EOF

Bước 5: Tạo Secret trên Kubernetes để chạy app

# Thay thế YOUR_REAL_API_KEY bằng key thật của bạn
kubectl create secret generic gemini-api-key \
  --from-literal=apiKey=YOUR_REAL_API_KEY \
  --namespace haproxy-ops

🔧 PART II Cấu hình Harbor & Push Chart

# 1. Đóng gói thư mục thành file .tgz
# (Đang đứng ở thư mục project-helm-build)
helm package ./template-ha-config
# > Kết quả: Successfully packaged chart and saved it to: .../template-ha-config-0.1.0.tgz

# 2. Đẩy (Push) file .tgz lên Harbor
# (Fix lỗi 401: URL chuẩn OCI là: oci://[HOST]/[PROJECT]/[CHART_NAME])
helm push template-ha-config-0.1.0.tgz oci://harbor.diendo.pro.vn/template-ha-config/ha-config

# 1. Truy cập vào container Jenkins
# docker exec -it container_id_Jenkins_cua_Bạn /bin/bash
iadmin@srv025-aio:~$ docker exec -it devops-jenkins-1 /bin/bash

# Sau đó tiến hành cài wget bằng lệnh:
apt-get update && apt-get install -y wget
# 2. Cài Helm Chart
wget https://get.helm.sh/helm-v3.17.4-linux-amd64.tar.gz
tar vxf helm-v3.17.4-linux-amd64.tar.gz
sudo mv linux-amd64/helm /usr/bin/
# 3. Cài helm push
helm plugin install https://github.com/chartmuseum/helm-push

# Start from the official Jenkins LTS image using JDK 17
FROM jenkins/jenkins:lts-jdk17
# Switch to root user to install packages
USER root
# Install prerequisites and Docker GPG key
RUN apt-get update && apt-get install -y ca-certificates curl gnupg
RUN install -m 0755 -d /etc/apt/keyrings
RUN curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
RUN chmod a+r /etc/apt/keyrings/docker.asc
# Add Docker repository
RUN echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  tee /etc/apt/sources.list.d/docker.list > /dev/null
# Install Docker CLI
RUN apt-get update && apt-get install -y docker-ce-cli
RUN curl -fsSL "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl" -o /usr/local/>
        && chmod +x /usr/local/bin/kubectl /usr/bin/docker || true \
        && apt-get clean && rm -rf /var/lib/apt/lists/*

ENV HELM_VERSION=v3.17.4
RUN curl -L "https://get.helm.sh/helm-${HELM_VERSION}-linux-amd64.tar.gz" | tar -xz \
    && mv linux-amd64/helm /usr/local/bin/helm \
    && chmod +x /usr/local/bin/helm \
    && helm plugin install https://github.com/chartmuseum/helm-push

# Switch back to jenkins user
USER jenkins

# Final verification check
RUN kubectl version --client && helm version