Route (маршрут)

Управлять объектами Route можно с помощью платформы Опеншифт для администратора.

Создание маршрута

  1. Перейдите в меню Networking → Routes.

  2. Нажмите на кнопку Create Route.

  3. Заполните поля:

    • Name — введите уникальное имя для маршрута.

    • Hostname — введите публичное имя хоста для маршрута.

    • Path — укажите путь, по которому маршрутизатор отслеживает маршрутизацию трафика к сервису.

    • Service — нажмите на кнопку b__role и, из раскрывающегося списка выберите существующую службу, в которую необходимо добавить маршрут.

    • Опционально, нажмите Add Alternate Service, чтобы добавить дополнительную службу для маршрута.

    • Target Port — укажите порт для трафика.

    • Secure — установите флаг Secure route, если необходимо установить защиту для маршрута.

  4. Нажмите на кнопку Create.

Изменение маршрута

  1. Перейдите в меню Networking → Routes.

  2. Выберите маршрут, который необходимо изменить, нажмите на кнопку b__delete, и выберите Edit Route.

  3. Внесите необходимые изменения в маршрут и нажмите Save.

Удаление маршрута

  1. Перейдите в меню Networking → Routes.

  2. Выберите маршрут, который необходимо удалить, нажмите на кнопку b__delete и выберите Delete Route.

Настройка времени ожидания маршрута

Настроить время ожидания по умолчанию для существующего маршрута можно с помощью команды oc annotate:

oc annotate route <route_name> \\
--overwrite haproxy.router.openshift.io/timeout=<timeout><time_unit>

Поддерживаются следующие единицы времени:

  • микросекунды (us);

  • миллисекунды (ms);

  • секунды (s);

  • минуты (m);

  • часы (h);

  • дни (d).

На примере ниже установлено время ожидания в две секунды для маршрута с именем myroute:

oc annotate route myroute --overwrite
haproxy.router.openshift.io/timeout=2s

Подключение HSTS

Подключение HSTS гарантирует, что на хосте разрешен только HTTPS-трафик. Любые HTTP-запросы отклоняются по умолчанию.

Подключить HSTS:

  1. Добавьте значение haproxy.router.openshift.io/hsts_header к маршруту.

  2. Добавьте параметры:

    • max-age — в качестве значения этого параметра укажите время в секундах, в течение которого действует HSTS;

    • includeSubDomain — если необходимо, чтобы все субдомены хоста обрабатывались так же, как хост, опционально;

    • preload — если значение параметра max-age больше 0, то добавление параметра preload=in позволит внешним службам включать сайт в списки предварительной загрузки HSTS, опционально.

    apiVersion: v1
kind: Route
metadata:
  annotations:
   haproxy.router.openshift.io/hsts_header:
maxage=31536000;
includeSubDomains;
preload

См.также

Подробнее о настройках маршрута здесь.