Kubernetes
Avec cert-manager, local-cert se déclare comme un ClusterIssuer ACME. Les Ingress et les ressources Certificate s'en servent ensuite comme de n'importe quel émetteur.
| Valeur | Où la trouver | Dans ce guide |
|---|---|---|
| Directory ACME | fixe pour chaque instance | https://certs.example.com/acme/directory |
| Key ID (kid) | Clés & droits → Identifiants EAB | eab_XXXXXXXXXXXXXXXX |
| Clé HMAC | affichée une seule fois à la création | CLE_HMAC |
1. Le secret EAB
kubectl
kubectl -n cert-manager create secret generic local-cert-eab \
--from-literal=secret=CLE_HMACPour un ClusterIssuer, le secret doit se trouver dans l'espace de noms de cert-manager.
2. Le ClusterIssuer
local-cert-issuer.yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: local-cert
spec:
acme:
server: https://certs.example.com/acme/directory
email: ops@example.com
privateKeySecretRef:
name: local-cert-account
externalAccountBinding:
keyID: eab_XXXXXXXXXXXXXXXX
keySecretRef:
name: local-cert-eab
key: secret
solvers:
- http01:
ingress:
ingressClassName: nginxappliquer et vérifier
kubectl apply -f local-cert-issuer.yaml
kubectl get clusterissuer local-cert -o wide # READY doit passer à TrueRemplacez ingressClassName par celle de votre contrôleur (traefik sur k3s, par exemple).
3. Demander un certificat
Par annotation sur un Ingress :
ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: nas
annotations:
cert-manager.io/cluster-issuer: local-cert
spec:
ingressClassName: nginx
tls:
- hosts: [nas.home.example.com]
secretName: nas-tls
rules:
- host: nas.home.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: nas
port:
number: 80ou explicitement :
certificate.yaml
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: nas
spec:
secretName: nas-tls
dnsNames: [nas.home.example.com]
issuerRef:
kind: ClusterIssuer
name: local-certSuivre une émission
kubectl
kubectl get certificate,certificaterequest,order,challenge -A
kubectl describe challenge -A | tail -n 20Comptez une à trois minutes entre la présentation du challenge et le passage du Certificate à Ready. cert-manager renouvelle ensuite seul, aux deux tiers de la durée de vie.
Variantes
- Un émetteur par espace de noms : utilisez
Issuerà la place deClusterIssuer, avec le secret EAB dans le même espace de noms. Un identifiant EAB par équipe, limité à ses domaines, cloisonne proprement. - Gateway API : remplacez le solveur par
http01.gatewayHTTPRoute.parentRefs. - Sans cert-manager (k3s avec Traefik) : le resolver décrit dans Traefik se déclare dans les arguments du chart via un
HelmChartConfig. - Jokers : cert-manager refuse HTTP-01 pour un joker. Émettez-le par l'API et chargez-le comme secret TLS.