# Использование с Ingress

Вы можете использовать Global Server через прокси-сервер, поднятый [подсистемой Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) кластера Kubernetes.

В основе такой подсистемы лежит Ingress-контроллер, который поставляется отдельно от Kubernetes или `gs-ctk`.

![Обложка](img/Ingress.png)

Схема отображает типичную схему, которая может отличаться для выбранного вами Ingress-контроллера. Пользователи при подключении к кластеру распределяются [балансировщиком нагрузки на нодах кластера](https://kubernetes.io/docs/concepts/services-networking/service/#loadbalancer) на один из подов с прокси-сервером контроллера (на уровне протокола TCP). Тот в свою очередь распределяет запросы на нужные сервисы на уровне протокола HTTP(S) на основе заголовка Host HTTP и пути ресурса (работа Global гарантируется лишь на отдельном домене/IP-адресе, поэтому используется только поле Host). Запросы к Global ERP дополнительно распределяются внутренним HAProxy, тесно связанным с работой серверов.

## HTTP/HTTPS и TLS

Пользовательский доступ к Global ERP может быть организован по HTTP или HTTPS. Для продуктивных контуров рекомендуется использовать HTTPS с TLS 1.2 или выше; открытый HTTP обычно применяется только для перенаправления на HTTPS либо по отдельному согласованию с заказчиком.

При публикации через Ingress TLS, как правило, завершается на Ingress-контроллере, а внутренний HAProxy продолжает распределять HTTP(S)-запросы между серверами приложений. В этом сценарии сертификат указывается в `ingress_tls_secret`, а `haproxy_tls_secret` не задаётся. Если HAProxy публикуется напрямую без Ingress, TLS настраивается на стороне HAProxy через `haproxy_tls_secret`. Для соединений между компонентами за пределами доверенного сетевого контура также следует использовать TLS 1.2+ или иной защищённый транспорт, согласованный с заказчиком.

Базовые варианты включения TLS и перенаправления HTTP на HTTPS в HAProxy приведены в официальной документации: [Basics of enabling TLS](https://www.haproxy.com/documentation/haproxy-configuration-tutorials/security/ssl-tls/basics-enable-tls/).

Чтобы начать использовать Ingress, [выберите и установите](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/#additional-controllers) Ingress-контроллер (рекомедуем [ingress-nginx](https://kubernetes.github.io/ingress-nginx/deploy/)), укажите при настройке значений для книги HAProxy:

```text
Использовать Ingress?[да,нет]:да
```

Затем введите настройки для ресурса Ingress:

```text
Введите класс Ingress:nginx
Введите хост Ingress:globalerp.example.ru
Введите дополнительную аннотацию Ingress (или пропустите поле): ingress.appscode.com/default-timeout={"connect": "28800s"}
Введите дополнительную аннотацию Ingress (или пропустите поле): haproxy-ingress.github.io/timeout-connect=28800s
Введите дополнительную аннотацию Ingress (или пропустите поле):
Введите TLS-секрет Ingress: my-tls-secret
```

```yaml
apiVersion: global-system.ru/v1
kind: GlobalConfiguration
spec:
  resgroups:
  - resbooks:
    - name: haproxy
      type: haproxy
      service:
        annotations:
          ingress.appscode.com/default-timeout: '{"connect": "28800s"}'
          haproxy-ingress.github.io/timeout-connect: "28800s"
        host: globalerp.example.ru
        ingress_class: nginx
        type: ingress
        ingress_tls_secret: my-tls-secret
      haproxy_tls_secret: ""
      ...
```

```{warning}
Обратите внимание, что для книги ресурсов `haproxy` можно указать `haproxy_tls_secret`. Этот параметр не стоит указывать, если вы используете Ingress, так как в таком случае Ingress ответственен за терминирование TLS. Используйте `ingress_tls_secret`.
```

Название используемого класса Ingress должно быть ясно из документации и настроек Ingress-контроллера.

Хост соответствует полю Host в протоколе HTTP. По нему прокси-сервер определяет, к какой службе запрашивается подключения. Если указывается пустое значение, то доступ осуществляется с любого домена.

Аннотации указываются те, что нужны для полной настройки вашего Ingress-контроллера. Если вы не знаете нужны ли вам дополнительные аннотации, то пропускайте поле. Вам скорее всего не нужно его заполнять.

Аналогично заполняются и Ingress-ресурсы для панелей администратора Grafana и RabbitMQ.

## Таймауты

Пользователи при работе с GlobalERP могут встретить сообщение о разрыве соединения. Помимо обычных причин (физический разрыв соединения, перебои сети, переход оборудования в энергосберегающий режим), такое сообщение может возникать в результате закрытия прокси-сервером соединения из-за таймаутов.

У многих Ingress-контроллеров есть аннотации, которые позволяют указать таймауты. Из коробки уже указаны аннотации для следующих контроллеров:

- ingress-nginx (предлагается в документации VK Cloud)/.
- NGINX Ingress Controller (предлагается в документации Yandex Cloud).
- Voyager.
- haproxy-ingress.

Для контроллера Traefik аннотации не требуются.

Вот пример аннотаций, используемых в ingress-nginx:

```yaml
nginx.ingress.kubernetes.io/proxy-connect-timeout: "28800"
nginx.ingress.kubernetes.io/proxy-send-timeout: "28800"
nginx.ingress.kubernetes.io/proxy-read-timeout: "28800"
```

Вы можете переопределить эти настройки указав их при конфигурации группы ресурсов.

Обращаем внимание, что не все Ingress-контроллеры позволяют изменить таймауты при помощи аннотаций. В таком случае, необходимо изменить таймауты при помощи конфигурации контроллера, или отказаться от использования Ingress для GlobalERP, или начать использовать другой контроллер.
