study.

cert-manager로 인증서 발급과 갱신 상태 확인하기 · Kubernetes

Certificate가 Ready가 되는 것과 브라우저가 그 인증서를 신뢰하는 것은 다릅니다.

← Kubernetes

진도·퀴즈와 함께 학습하기

먼저, 개념을 잡아볼게요.

TLS 인증서와 개인 키

인증서는 서버 이름과 공개 키 등의 정보를 담고 개인 키는 서버가 소유합니다. tls.crt는 공개 인증서, tls.key는 비밀 키입니다. 유효 기간·SAN의 DNS 이름·신뢰 체인이 연결 상대의 검증에 중요합니다.

Issuer·ClusterIssuer·Certificate

Issuer는 같은 namespace에서 사용하는 발급자이고 ClusterIssuer는 클러스터 범위의 발급자입니다. Certificate는 원하는 DNS 이름·저장 Secret·issuerRef를 선언하며 cert-manager 컨트롤러가 발급과 갱신을 조정합니다. CRD만 설치해선 이 동작이 실행되지 않습니다.

자동 갱신과 소비자

인증서 유효 기간과 renewBefore를 기반으로 갱신이 예약되며 status.renewalTime을 확인할 수 있습니다. Secret이 갱신돼도 앱이나 프록시가 새 인증서를 다시 읽는지는 별도로 검증해야 합니다. 개인 키 변경에도 대응해야 합니다.

ACME와 자체 서명의 차이

자체 서명은 외부 도메인 없이 객체 흐름을 배우는 용도입니다. 공개 CA의 ACME 발급은 도메인 소유 검증을 거치며 HTTP-01은 HTTP 경로, DNS-01은 TXT 레코드를 이용합니다. DNS-01은 wildcard 발급에도 사용되며 DNS 권한을 제한해 관리해야 합니다.

왜 필요한가요?

인증서 만료를 사람이 수동으로 추적하면 갱신을 놓치기 쉽습니다. 원하는 인증서 상태를 선언하고 발급·갱신을 조정하게 하되, 클라이언트 신뢰와 서버의 인증서 재로딩은 별도 책임으로 확인해야 합니다.

차례대로 이해하기

발급 흐름 읽기

Certificate의 issuerRef와 secretName을 먼저 읽습니다. CertificateRequest는 개별 발급 요청이고 Issuer는 그 요청을 처리할 발급 설정입니다. ACME는 여기에 Order·Challenge가 더해지지만 SelfSigned에서는 이 두 객체를 찾을 필요가 없습니다.

갱신과 재발급 구분

status.notAfter와 renewalTime은 만료와 갱신 예정 시각입니다. 실습은 DNS 이름 변경으로 revision 증가를 확인하므로 예약 시간이 지나 자동 갱신된 실험과는 다릅니다. 공개 인증서 SAN을 읽고 비밀 키는 출력하지 않습니다.

직접 실행하며 익혀보세요.

kubectl과 개인 실습용 Kubernetes 클러스터, POSIX 셸이 필요합니다. cert-manager와 VPA 실습은 각 레슨에 명시한 사전 설치가 필요합니다. 노드 변경 실습은 폐기 가능한 전용 worker에서만 수행하며 전용 namespace를 사용합니다.

개인 실습 클러스터에 호환되는 cert-manager 컨트롤러·webhook·CRD가 설치되고 준비돼 있어야 합니다. 공식 설치 문서를 먼저 확인하세요. kubectl·openssl·base64가 필요합니다. 아래 코드는 전용 namespace에 자체 서명 인증서를 만들고 DNS 이름 변경으로 재발급을 확인합니다. 실제 도메인·DNS 변경이나 공개 CA 요청은 하지 않습니다.

(
set -eu
kubectl config current-context
kubectl get crd certificates.cert-manager.io issuers.cert-manager.io
kubectl create namespace study-cert-manager --dry-run=client -o yaml | kubectl apply -f -
kubectl apply -n study-cert-manager -f - <<'YAML'
apiVersion: cert-manager.io/v1
kind: Issuer
metadata:
  name: lab-selfsigned
spec:
  selfSigned: {}
---
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: lab-tls
spec:
  secretName: lab-tls
  duration: 24h
  renewBefore: 8h
  subject:
    organizations: [GreatJIN Study Lab]
  dnsNames: [app.example.test]
  privateKey:
    algorithm: ECDSA
    size: 256
    rotationPolicy: Always
  issuerRef:
    name: lab-selfsigned
    kind: Issuer
YAML
kubectl wait -n study-cert-manager --for=condition=Ready issuer/lab-selfsigned --timeout=120s
kubectl wait -n study-cert-manager --for=condition=Ready certificate/lab-tls --timeout=180s
kubectl get certificate lab-tls -n study-cert-manager -o jsonpath='{.status.revision}{"\n"}{.status.notAfter}{"\n"}{.status.renewalTime}{"\n"}'
kubectl get secret lab-tls -n study-cert-manager -o jsonpath='{.type}{"\n"}'
kubectl get secret lab-tls -n study-cert-manager -o jsonpath='{.data.tls\.crt}' | base64 -d | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
kubectl patch certificate lab-tls -n study-cert-manager --type=merge -p '{"spec":{"dnsNames":["app.example.test","api.example.test"]}}'
kubectl wait -n study-cert-manager --for=jsonpath='{.status.revision}'=2 certificate/lab-tls --timeout=180s
kubectl wait -n study-cert-manager --for=condition=Ready certificate/lab-tls --timeout=120s
kubectl get secret lab-tls -n study-cert-manager -o jsonpath='{.data.tls\.crt}' | base64 -d | openssl x509 -noout -ext subjectAltName
)

이렇게 확인하세요

Certificate Ready=True, Secret type=kubernetes.io/tls, SAN의 app.example.test를 확인합니다. 변경 뒤 revision=2와 api.example.test가 포함돼야 합니다. renewalTime은 예정 시각이며 실제 시간 경과 갱신을 기다린 결과는 아닙니다. 실패하면 Certificate → CertificateRequest → Issuer의 conditions·Events를 읽습니다. ACME를 쓸 때만 Order·Challenge도 조사합니다.

실습 리소스 정리

결과 확인을 마친 뒤 실행하세요. 이 실습에서 만든 리소스와 보존할 데이터가 없는지 확인합니다.

kubectl delete namespace study-cert-manager

응용해보기

자체 서명 실습은 성공했는데 실제 ACME HTTP-01 발급이 Pending입니다. 무엇을 추가 조사할까요?

생각해본 뒤 풀이 보기

CertificateRequest 이후 Order·Challenge 상태와 이벤트를 읽고 도메인의 실제 DNS, 지정한 ingress class와 solver 경로, CA에서 HTTP 검증 경로로 도달 가능한지 확인합니다. DNS-01이라면 TXT 전파·권한을 조사합니다. 공개 CA 테스트는 staging 환경부터 구성하며 이 실습만으로 공개 발급을 검증했다고 판단하지 않습니다.

잠깐, 이해했는지 확인해볼까요?

이 실습의 자체 서명 Certificate가 Ready=True일 때 맞는 설명은?

  1. 인터넷 브라우저가 자동으로 신뢰한다
  2. 발급은 됐지만 클라이언트 신뢰와 HTTPS 서버 설정은 별도다
  3. 실제 DNS 레코드가 자동 생성됐다
  4. 개인 키를 공개해도 안전하다
생각해본 뒤 풀이 보기

발급은 됐지만 클라이언트 신뢰와 HTTPS 서버 설정은 별도다

발급 성공, 신뢰 체인, DNS, TLS를 제공하는 서버 설정은 별도입니다. 자체 서명 인증서를 만들었다고 브라우저 신뢰나 HTTPS 엔드포인트가 자동 생성되지 않습니다.

공식 문서 · cert-manager로 인증서 발급과 갱신 상태 확인하기 · cert-manager 설치 · 공식 문서 · ACME 발급 · 공식 문서