Имена пользовательских доменов и создание собственных сертификатов в приложениях контейнеров Azure

1. Перейдите к приложению-контейнеру в портал Azure

2. Убедитесь, что в приложении включен входящий трафик, выбрав входящий трафик в разделе "Параметры ". Если входящий трафик не включен, включите его с помощью следующих действий:

   1. Установите для параметра "Входящий трафик HTTP" значение "Включено".
   2. Выберите нужный параметр трафика входящего трафика .
   3. Введите целевой порт.
   4. Выберите Сохранить.

3. В разделе "Параметры" выберите "Личные домены".

4. Нажмите кнопку "Добавить личный домен ".

5. В окне "Добавление личного домена и сертификата" в TLS/SSL-сертификате выберите "Добавить собственный сертификат".

6. В домене введите домен, который вы хотите добавить.

7. Выберите " Добавить сертификат".

8. В окне "Добавление сертификата" в поле "Имя сертификата" введите имя этого сертификата.

9. В разделе "Файл сертификата" найдите файл сертификата, который требуется отправить.

10. Выберите Проверить.

11. После успешной проверки нажмите кнопку "Добавить".

12. В окне "Добавление личного домена и сертификата" в окне "Сертификат" выберите только что добавленный сертификат.

13. Выберите тип записи hostname в зависимости от типа домена.

    Тип домена	Тип записей	Примечания.
    Вершинный домен	Запись A	Основной домен — это домен на корневом уровне домена. Например, если зона DNS (система доменных имен) имеет значение contoso.com, то contoso.com является доменом вершины.
    Поддомен	CNAME	Поддомен — это домен, который является частью другого домена. Например, если ваша зона DNS является contoso.com, то www.contoso.com это пример поддомена, который можно настроить в зоне.

14. Используя поставщик DNS, на котором размещен домен, создайте записи DNS на основе выбранного типа записи имени узла, используя значения, показанные в разделе проверки домена. Записи указывают домен в приложение контейнера и убедитесь, что вы владеете им. Настройка зависит от того, используете ли вы пользовательские домены с функцией частной конечной точки:

    • Общие сведения
    • Частная конечная точка

    • Если выбрана запись A, создайте следующие записи DNS:

      Тип записей	Хост	Значение
      а	@	IP-адрес среды приложений контейнеров.
      ТЕКСТ	asuid	Код проверки домена.

    • Если вы выбрали CNAME, создайте следующие записи DNS:

      Тип записей	Хост	Значение
      CNAME	Поддомен (например, www)	Созданный домен приложения-контейнера.
      ТЕКСТ	asuid. за которым следует поддомен (например, asuid.www)	Код проверки домена.

15. Нажмите кнопку "Проверить ".

16. После успешной проверки нажмите кнопку "Добавить ".

17. После завершения операции вы увидите доменное имя в списке пользовательских доменов с состоянием Secured. Перейдите к домену, чтобы убедиться, что он доступен.

Контейнерные приложения поддерживают домены вершин и поддомены. Для каждого типа домена требуется другой тип записи DNS и метод проверки.

1. Войдите в Azure с помощью Azure CLI.

   az login
   

2. Затем установите расширение Контейнеров приложений Azure для CLI.

   az extension add --name containerapp --upgrade
   

3. Задайте следующие переменные среды. Замените <PLACEHOLDERS> значения своими значениями.

   RESOURCE_GROUP = "<RESOURCE_GROUP>"
   CONTAINER_APP = "<CONTAINER_APP>"
   ENVIRONMENT = "<ENVIRONMENT>"
   TARGET_PORT = "<TARGET_PORT>"
   DOMAIN_NAME = "<DOMAIN_NAME>"
   CERTIFICATE_LOWERCASE_NAME = "<CERTIFICATE_LOWERCASE_NAME>"
   CERTIFICATE_LOCAL_PATH = "<CERTIFICATE_LOCAL_PATH>"
   CERTIFICATE_PASSWORD = "<CERTIFICATE_PASSWORD>"
   

   • Замените <CERTIFICATE_LOCAL_PATH> локальный путь к файлу сертификата.
   • Замените <CERTIFICATE_LOWERCASE_NAME> нижним регистром имя сертификата, уникальное в среде.
   • Замените <TARGET_PORT> портом, на который прослушивается приложение контейнера.

4. Убедитесь, что в приложении-контейнере включена входящий трафик HTTP.

   az containerapp ingress show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP
   

   Если входящий трафик не включен, включите его с помощью следующих действий:

   az containerapp ingress enable \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       --type external \
       --target-port $TARGET_PORT \
       --transport auto
   

5. Если вы настраиваете домен вершины, получите IP-адрес среды приложений контейнеров.

   az containerapp env show \
       -n $ENVIRONMENT \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.staticIp"
   

6. Если вы настраиваете поддомен, получите автоматически созданный домен приложения контейнера.

   az containerapp show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.configuration.ingress.fqdn"
   

7. Получите код проверки домена.

   az containerapp show \
       -n $CONTAINER_APP \
       -g $RESOURCE_GROUP \
       -o tsv \
       --query "properties.customDomainVerificationId"
   

8. Используя поставщик DNS, на котором размещен домен, создайте записи DNS на основе выбранного типа записи, используя значения, отображаемые в разделе проверки домена. Записи указывают домен в приложение контейнера и убедитесь, что вы владеете им. Настройка зависит от того, используете ли вы пользовательские домены с функцией частной конечной точки:

   • Общие сведения
   • Частная конечная точка

   • Если выбрана запись A, создайте следующие записи DNS:

     Тип записей	Хост	Значение
     а	@	IP-адрес среды приложений контейнеров.
     ТЕКСТ	asuid	Код проверки домена.

   • Если вы выбрали CNAME, создайте следующие записи DNS:

     Тип записей	Хост	Значение
     CNAME	Поддомен (например, www)	Созданный домен приложения-контейнера.
     ТЕКСТ	asuid. за которым следует поддомен (например, asuid.www)	Код проверки домена.

9. Отправьте сертификат в среду.

   az containerapp env certificate upload \
       -g $RESOURCE_GROUP \
       --name $ENVIRONMENT \
       --certificate-file $CERTIFICATE_LOCAL_PATH \
       --password $CERTIFICATE_PASSWORD \
       --certificate-name $CERTIFICATE_LOWERCASE_NAME
   

10. Привязка сертификата и домена к приложению контейнера.

    az containerapp hostname bind \
        --hostname $DOMAIN_NAME \
        -g $RESOURCE_GROUP \
        -n $CONTAINER_APP \
        --environment $ENVIRONMENT \
        --certificate $CERTIFICATE_LOWERCASE_NAME \
        --validation-method <VALIDATION_METHOD>
    

    • Если вы настраиваете запись A, замените <VALIDATION_METHOD> на HTTP.

    • Если вы настраиваете CNAME, замените <VALIDATION_METHOD> на CNAME.

    Может потребоваться несколько минут для выдачи сертификата и добавления домена в приложение контейнера.

11. После завершения операции перейдите к домену, чтобы убедиться, что она доступна.