Настройка хостинга подкаталогов с помощью AWS CloudFront

Вы можете разместить свой центр поддержки Notiondesk на поддомене вашего основного домена, используя AWS CloudFront. Например, вместо использования поддомена типа help.yourdomain.com, вы можете разместить свой центр поддержки на следующих поддоменах: yourdomain.com/help, yourdomain.com/docs, yourdomain.com/support

Такая настройка полезна, если ваш основной веб-сайт уже использует CloudFront, и вы хотите, чтобы ваша документация или контент поддержки оставались в рамках одного домена.

Прежде чем начать

Перед настройкой хостинга подкаталогов в AWS CloudFront убедитесь, что у вас есть:

• Существующий справочный центр Notiondesk

• Доступ к вашей учетной записи WS

• Доступ к дистрибутиву CloudFront, используемому вашим основным веб-сайтом.

• Разрешение на редактирование источников и поведения CloudFront

• Подпуть, который вы хотите использовать для своего справочного центра, например:
  • __СОХРАНЕНО_22__

  • __СОХРАНЕНО_21__

  • __СОХРАНЕНО_20__

• В Notiondesk включено размещение подпутей.

Если ваш сайт использует другого провайдера, воспользуйтесь соответствующим руководством по хостингу подкаталогов .

Включите размещение подпутей в Notiondesk

Сначала включите хостинг подпутей в панели управления Notiondesk.

1. Откройте свою панель управления Notiondesk

2. Перейдите по ссылке Settings > General

3. Прокрутите до раздела Domains

4. Включите переключатель Subpath

5. Выберите AWS CloudFront в качестве поставщика установки.

6. Скопируйте сгенерированные значения настроек CloudFront.

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

Добавьте источник в CloudFront.

Далее добавьте свой справочный центр Notiondesk в качестве нового источника в CloudFront.

Источник — это место назначения, куда CloudFront отправляет запросы. В данном случае источником является ваш справочный центр Notiondesk.

1. Откройте консоль AWS

2. Перейдите к CloudFront

3. Откройте дистрибутив, используемый вашим основным веб-сайтом.

4. Перейдите на вкладку Origins

5. Нажмите __СОХРАНЕНО_13__

6. В поле Origin domain введите исходный домен Notiondesk, сгенерированный на вашей панели управления.

7. Установите значение Protocol равным HTTPS only

8. Добавьте пользовательские заголовки, сгенерированные Notiondesk

9. Сохраните источник

Добавить поведение CloudFront

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

Параметр поведения указывает CloudFront, какие URL-адреса должны быть отправлены на какой источник. В данном случае запросы к подкаталогу вашего справочного центра должны быть отправлены на источник Notiondesk.

Для справочного центра, размещенного по адресу /help, создайте следующие правила поведения:

• /help

• /help/*

• /_nd/*

Для всех трех вариантов поведения следует использовать источник Notiondesk, созданный вами ранее.

При настройке и тестировании конфигурации используйте политику кэширования CachingDisabled. Это упростит проверку изменений, поскольку старые кэшированные ответы не будут создавать помехи.

Например, если ваш справочный центр должен быть доступен по адресу /docs, создайте сценарии поведения для /docs, /docs/* и /_nd/*.

Дождитесь завершения развертывания CloudFront.

После сохранения исходных данных и настроек поведения дождитесь развертывания изменений в CloudFront.

Обновления CloudFront не происходят мгновенно. Для того чтобы ваш справочный центр стал доступен в подкаталоге, необходимо завершить процесс развертывания дистрибутива.

После завершения развертывания вы можете начать тестирование URL-адреса вашего центра поддержки.

Проверьте свою конфигурацию.

После завершения развертывания CloudFront протестируйте свой справочный центр в браузере.

Проверьте это:

• Центр поддержки загружается под вашим основным доменом.

• Страницы статей открываются корректно.

• Изображения, скрипты и стили загружаются корректно.

• URL-адрес в браузере остаётся на вашем собственном домене.

• Ваш основной сайт по-прежнему работает вне подкаталога справочного центра.

Иногда для отображения изменений в развертывании CloudFront и кэше может потребоваться некоторое время.