google:search{queries:[kubernetes cert-manager letsencrypt setup guide,cert-manager nginx ingress letsencrypt setup,cert-manager ClusterIssuer vs Issuer,k8s ingress tls configuration example]} Kubernetes에서 Let’s Encrypt 인증서를 적용하는 표준적인 방법은 cert-manager를 사용하는 것입니다. 다음은 3단계 요약입니다.
1. cert-manager 설치
클러스터에 인증서 관리 도구를 설치합니다.
Bash
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/latest/download/cert-manager.yaml
2. ClusterIssuer 생성
인증서를 발급해줄 주체(Let’s Encrypt)를 정의합니다. 아래 내용을 cluster-issuer.yaml로 저장 후 적용(kubectl apply -f ...)하세요.
YAML
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt-prod
spec:
acme:
# Let's Encrypt 프로덕션 서버 주소
server: https://acme-v02.api.letsencrypt.org/directory
email: [email protected] # 본인 이메일로 변경 (만료 알림용)
privateKeySecretRef:
name: letsencrypt-prod
solvers:
- http01:
ingress:
class: nginx # 사용 중인 인그레스 컨트롤러 클래스 (예: nginx)
3. Ingress 설정 수정
웹 앱의 Ingress 리소스에 annotations와 tls 설정을 추가합니다.
YAML
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-web-app-ingress
annotations:
# 위에서 만든 ClusterIssuer 이름 지정
cert-manager.io/cluster-issuer: letsencrypt-prod
spec:
ingressClassName: nginx
tls:
- hosts:
- my-app.example.com
secretName: my-app-tls # 인증서가 저장될 시크릿 이름 (자동 생성됨)
rules:
- host: my-app.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: my-web-service
port:
number: 80
설정 후 잠시 기다리면 cert-manager가 자동으로 인증서를 발급하고 my-app-tls 시크릿을 생성하여 HTTPS를 활성화합니다.
Kubernetes HTTPS with cert-manager and Let’s Encrypt
이 영상은 cert-manager 설치부터 Let’s Encrypt 인증서 발급 및 적용까지의 전체 과정을 단계별 데모로 보여주어 이해를 돕습니다.