Стадия жизненного цикла модуля: General Availability
Пример заказа сертификата
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: example-com # Имя сертификата, через него потом можно смотреть статус.
namespace: default
spec:
secretName: example-com-tls # Название Secret'а, в который положить приватный ключ и сертификат.
issuerRef:
kind: ClusterIssuer # Ссылка на "выдаватель" сертификатов, см. подробнее ниже.
name: letsencrypt
commonName: example.com # Основной домен сертификата.
dnsNames: # Дополнительные домены сертификата (как минимум одно DNS-имя или IP-адрес должны быть указаны).
- www.example.com
- admin.example.com
При этом:
- создается отдельный Ingress-ресурс на время прохождения challenge’а (соответственно, аутентификация и whitelist основного Ingress не будут мешать);
- можно заказать один сертификат на несколько Ingress-ресурсов (и он не отвалится при удалении того, в котором была аннотация
tls-acme); - можно заказать сертификат с дополнительными именами (как в примере);
- можно валидировать разные домены, входящие в один сертификат, через разные Ingress-контроллеры.
Подробнее можно прочитать в документации cert-manager.
Заказ wildcard-сертификата с DNS в Cloudflare
- Получим
Global API KeyиEmail Address:- Заходим на страницу: https://dash.cloudflare.com/profile.
- В самом верху страницы написана ваша почта под
Email Address. - В самом низу страницы жмем на кнопку
ViewнапротивGlobal API Key.
В результате этого мы получаем ключ для взаимодействия с API Cloudflare и почту, на которую зарегистрирован аккаунт.
-
Редактируем настройки модуля cert-manager и добавляем такую секцию:
settings: cloudflareGlobalAPIKey: APIkey cloudflareEmail: some@mail.somedomainили
settings: cloudflareAPIToken: some-token cloudflareEmail: some@mail.somedomainПосле этого Deckhouse автоматически создаст ClusterIssuer и Secret для Cloudflare в namespace
d8-cert-manager.- Конфигурация с помощью APIToken является рекомендуемой и более безопасной.
-
Создаем Certificate с проверкой с помощью провайдера Cloudflare. Данная возможность появится только при указании настройки
cloudflareGlobalAPIKeyиcloudflareEmailв Deckhouse:apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: domain-wildcard namespace: app-namespace spec: secretName: tls-wildcard issuerRef: name: cloudflare kind: ClusterIssuer commonName: "*.domain.com" dnsNames: - "*.domain.com" -
Создаем Ingress:
apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: domain-wildcard namespace: app-namespace spec: ingressClassName: nginx rules: - host: "*.domain.com" http: paths: - backend: service: name: svc-web port: number: 80 path: / tls: - hosts: - "*.domain.com" secretName: tls-wildcard
Заказ wildcard-сертификата с DNS в Route53
-
Создаем пользователя с необходимыми правами.
-
Заходим на страницу управления политиками. Создаем политику с такими правами:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "route53:GetChange", "Resource": "arn:aws:route53:::change/*" }, { "Effect": "Allow", "Action": "route53:ChangeResourceRecordSets", "Resource": "arn:aws:route53:::hostedzone/*" }, { "Effect": "Allow", "Action": "route53:ListHostedZonesByName", "Resource": "*" } ] } -
Заходим на страницу управления пользователями. Создаем пользователя с созданной ранее политикой.
-
-
Редактируем настройки модуля cert-manager и добавляем такую секцию:
settings: route53AccessKeyID: <ACCESS_KEY_ID> route53SecretAccessKey: <SECRET_ACCESS_KEY>После этого Deckhouse автоматически создаст ClusterIssuer и Secret для route53 в namespace
d8-cert-manager. -
Создаем Certificate с проверкой с помощью провайдера route53. Данная возможность появится только при указании настроек
route53AccessKeyIDиroute53SecretAccessKeyв Deckhouse:apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: domain-wildcard namespace: app-namespace spec: secretName: tls-wildcard issuerRef: name: route53 kind: ClusterIssuer commonName: "*.domain.com" dnsNames: - "*.domain.com"
Заказ wildcard-сертификата с DNS в Google
-
Создаем ServiceAccount с необходимой ролью:
- Заходим на страницу управления политиками.
- Выбираем нужный проект.
- Создаем ServiceAccount с желаемым названием, например
dns01-solver. - Заходим в созданный ServiceAccount.
- Создаем ключ по кнопке «Добавить ключ».
- Будет скачан
.json-файл с данными ключа имени. -
Закодируем полученный файл в строку base64:
base64 project-209317-556c656b81c4.json
-
Сохраняем полученную base64-строку в параметр модуля
cloudDNSServiceAccount.После этого Deckhouse автоматически создаст ClusterIssuer и Secret для cloudDNS в namespace
d8-cert-manager. -
Создаем Certificate с валидацией через cloudDNS:
apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: domain-wildcard namespace: app-namespace spec: secretName: tls-wildcard issuerRef: name: clouddns kind: ClusterIssuer dnsNames: - "*.domain.com"
Заказ wildcard-сертификата с DNS в Yandex Cloud DNS
Чтобы выпустить wildcard-сертификат с проверкой DNS-01 в Yandex Cloud DNS,
задайте параметры модуля и создайте Certificate со ссылкой на ClusterIssuer yandex.
Если ранее вы устанавливали upstream Helm-чарт cert-manager-webhook-yandex вручную, удалите этот чарт и cluster-scoped APIService v1alpha1.acme.cloud.yandex.com до включения параметров модуля ниже. Встроенный вебхук регистрирует то же имя APIService; оставленная ручная установка может сломать весь релиз cert-manager или тихо остановить продление сертификатов у существующего пользовательского ClusterIssuer.
Встроенный ClusterIssuer yandex использует production-каталог Let’s Encrypt (как issuers Cloudflare, Route53 и CloudDNS в этом модуле). Перед созданием Certificate убедитесь, что верны folder ID, роль сервисного аккаунта (dns.editor) и публичная DNS-зона — иначе неудачные попытки расходуют production rate limit. Чтобы сначала проверить настройку на staging, создайте временный ClusterIssuer с сервером https://acme-staging-v02.api.letsencrypt.org/directory и тем же webhook-solver.
-
Создайте сервисный аккаунт в Yandex Cloud и назначьте ему роль
dns.editor(или эквивалентную) на каталог, в котором находится публичная DNS-зона. -
Создайте авторизованный ключ для сервисного аккаунта и закодируйте полученный JSON-файл в Base64:
base64 authorized_key.json -
Укажите параметры модуля:
apiVersion: deckhouse.io/v1alpha1 kind: ModuleConfig metadata: name: cert-manager spec: version: 1 enabled: true settings: yandexFolderID: <FOLDER_ID> yandexServiceAccountJSON: <AUTHORIZED_KEY_JSON_BASE64>После этого Deckhouse Kubernetes Platform автоматически развернёт ACME-вебхук для Yandex Cloud DNS и создаст ClusterIssuer и Secret для Yandex в неймспейсе
d8-cert-manager.Где:
<FOLDER_ID>— идентификатор каталога Yandex Cloud с публичной DNS-зоной;<AUTHORIZED_KEY_JSON_BASE64>— содержимое файлаauthorized_key.json, закодированное в Base64.
-
Создайте Certificate с валидацией через Yandex Cloud DNS:
apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: domain-wildcard namespace: app-namespace spec: secretName: tls-wildcard issuerRef: name: yandex kind: ClusterIssuer dnsNames: - "*.domain.com"
Заказ self-signed-сертификата
Все еще проще, чем с LetsEncrypt. Просто меняем letsencrypt на selfsigned:
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: example-com # Имя сертификата, через него потом можно смотреть статус.
namespace: default
spec:
secretName: example-com-tls # Название Secret'а, в который положить приватный ключ и сертификат.
issuerRef:
kind: ClusterIssuer # Ссылка на ClusterIssuer.
name: selfsigned
commonName: example.com # Основной домен сертификата.
dnsNames: # Дополнительные домены сертификата. Требуется, как минимум, дублирование записи из commonName.
- example.com
- www.example.com
- admin.example.com
Пример создания самоподписанного сертификата вручную, без использования утилиты cert-manager, доступен в разделе FAQ.