cvando/kube-nginx-letsencrypt

kube-nginx-letsencrypt镜像说明

镜像概述

该镜像旨在为Kubernetes集群中的Ingress资源提供Let's Encrypt SSL证书的自动化管理能力，帮助用户快速实现服务的HTTPS加密访问，降低证书申请、绑定及续期的手动操作成本。

核心功能

• 自动向Let's Encrypt申请免费SSL证书
• 与Kubernetes Ingress资源无缝集成，支持证书绑定
• 自动监测证书有效期并完成续期操作
• 简化证书配置流程，减少人工干预

使用场景

• Kubernetes集群中需要为Ingress资源配置HTTPS的场景
• 希望自动化管理SSL证书生命周期的开发者或运维人员
• 小型至中型Kubernetes部署中快速实现加密通信的需求

配置说明

需根据实际环境配置关键参数（如环境变量或配置文件），常见配置项包括：

• ACME服务器地址（生产环境：https://acme-v02.api.letsencrypt.org/directory；测试环境：https://acme-staging-v02.api.letsencrypt.org/directory）
• Kubernetes集群访问凭证（如kubeconfig路径）
• 目标Ingress资源的标签或名称过滤规则

详细配置可参考官方镜像文档：https://hub.docker.com/r/sjenning/kube-nginx-letsencrypt/

部署示例

Docker Run命令（本地测试）

bash
docker run -d \
  --name kube-nginx-letsencrypt \
  -e KUBECONFIG=/root/.kube/config \
  -e ACME_SERVER=https://acme-staging-v02.api.letsencrypt.org/directory \
  -v ~/.kube:/root/.kube \
  -v ./certs:/certs \
  cvando/kube-nginx-letsencrypt

Kubernetes Deployment示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: kube-nginx-letsencrypt
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kube-nginx-letsencrypt
  template:
    metadata:
      labels:
        app: kube-nginx-letsencrypt
    spec:
      containers:
      - name: cert-manager
        image: cvando/kube-nginx-letsencrypt
        env:
        - name: ACME_SERVER
          value: "[***]"
        volumeMounts:
        - name: kubeconfig
          mountPath: /root/.kube/config
          subPath: config
        - name: cert-storage
          mountPath: /certs
      volumes:
      - name: kubeconfig
        secret:
          secretName: kubeconfig-secret
      - name: cert-storage
        persistentVolumeClaim:
          claimName: certs-pvc