TLS مع Ingress و cert-manager

الهدف من الدرس

ستفهم كيف يربط Ingress بين host و Secret يحتوي certificate، وكيف يستخدم cert-manager Issuer أو ClusterIssuer لإدارة TLS.

الفكرة ببساطة

TLS في Ingress يحتاج Secret من نوع kubernetes.io/tls. cert-manager يستطيع إنشاء هذا Secret وتجديده تلقائيا من جهة إصدار مثل Let’s Encrypt.

Certificate flow

flowchart LR
  I[Ingress] --> C[Certificate]
  C --> CI[ClusterIssuer]
  CI --> CA[Certificate Authority]
  C --> S[TLS Secret]
  S --> IC[Ingress Controller]

YAML مختصر

cluster-issuer.yaml:

apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt-prod
spec:
  acme:
    server: https://acme-v02.api.letsencrypt.org/directory
    email: admin@example.com
    privateKeySecretRef:
      name: letsencrypt-prod
    solvers:
      - http01:
          ingress:
            class: nginx

ingress-tls.yaml:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: web
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt-prod
spec:
  ingressClassName: nginx
  tls:
    - hosts:
        - web.example.com
      secretName: web-tls
  rules:
    - host: web.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  name: http

أوامر الفحص

kubectl apply -f cluster-issuer.yaml
kubectl apply -f ingress-tls.yaml
kubectl get certificate
kubectl describe certificate web-tls
kubectl get secret web-tls

Expected output:

NAME      READY   SECRET    AGE
web-tls   True    web-tls   2m

Lab: فحص TLS readiness

المستوى: مبتدئ الوقت: 30 دقيقة الأدوات: kubectl

الهدف: قراءة Certificate و Secret وتشخيص سبب فشل الإصدار.

Prerequisites

cert-manager مثبت.
DNS حقيقي يشير إلى Ingress Controller إذا كنت ستستخدم Let’s Encrypt فعليا.

Steps

kubectl get clusterissuer
kubectl get certificate
kubectl describe certificate web-tls
kubectl get challenges,orders

Expected output

Status:
  Conditions:
    Type: Ready
    Status: True

Cleanup

kubectl delete -f ingress-tls.yaml
kubectl delete -f cluster-issuer.yaml

أخطاء شائعة

المشكلة	السبب
Certificate لا يصبح Ready	DNS لا يشير إلى Ingress أو challenge يفشل
Secret غير موجود	cert-manager لم يصدر الشهادة بعد
mixed content في browser	التطبيق يستخدم روابط HTTP داخل صفحة HTTPS