Добавить сертификат от Let's Encrypt®

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды:

   yc certificate-manager certificate request --help
   

2. Выполните команду:

   yc certificate-manager certificate request \
     --name mymanagedcert \
     --domains example.com
   

   Где:

   • --name — имя сертификата.
   • --domains — домены сертификатов.

   Результат:

   id: fpq6gvvm6piu********
   folder_id: b1g7gvsi89m3********
   created_at: "2020-09-15T08:49:11.533771Z"
   ...
   - example.com
   status: VALIDATING
   updated_at: "2020-09-15T08:49:11.533771Z"
   

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

1. Опишите в конфигурационном файле Terraform параметры ресурса, который необходимо создать:

   resource "yandex_cm_certificate" "le-certificate" {
     name    = "<имя_сертификата>"
     domains = ["<домен>"]
   
     managed {
     challenge_type = "<тип_проверки>"
     }
   }
   

   Где:

   • domains — список доменов, для которых нужно создать сертификат.
   • challenge_type — тип проверки прав на домен, которую нужно пройти владельцу домена. Возможные значения:
     • DNS_CNAME — необходимо создать DNS-запись в формате CNAME с указанным значением. Рекомендуемый способ для автоматического продления сертификата.
     • DNS_TXT — необходимо создать DNS-запись в формате TXT с указанным значением.
     • HTTP — необходимо поместить указанное значение в указанный URL.

   Подробную информацию о параметрах ресурса yandex_cm_certificate см. в документации провайдера Terraform.

2. Создайте ресурсы:

   1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

   2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого в указанном каталоге будет создан сертификат. Проверить появление сертификата и его настройки можно в консоли управления или с помощью команды CLI:

yc certificate-manager certificate get <имя_сертификата>

Чтобы добавить сертификат, воспользуйтесь методом REST API requestNew для ресурса Certificate или вызовом gRPC API CertificateService/RequestNew.