Создание Ingress

Правила Ingress (Kubernetes Ingress) открывают HTTP/HTTPS маршруты снаружи кластера для внутренней маршрутизации (Kubernetes Service), что позволяет контролировать внешний доступ к вычислительным компонентам.

Создайте Ingress для управления внешним HTTP/HTTPS доступом к Service.

WARNING

При создании нескольких ingress в одном и том же namespace разные ingress НЕ ДОЛЖНЫ иметь одинаковые Domain, Protocol и Path (то есть дублирование точек доступа не допускается).

Содержание

Метод реализации

Правила Ingress зависят от реализации Ingress Controller, который отвечает за отслеживание изменений в Ingress и Service. После создания нового правила Ingress внутри Ingress Controller автоматически создаётся правило переадресации, соответствующее правилу Ingress. Когда Ingress Controller получает запрос, он сопоставляет правило переадресации с правилом Ingress и распределяет трафик по указанным внутренним маршрутам, как показано на схеме ниже.

NOTE

Для протокола HTTP Ingress поддерживает только порт 80 в качестве внешнего порта. Для протокола HTTPS Ingress поддерживает только порт 443 в качестве внешнего порта. Балансировщик нагрузки платформы автоматически добавит порты 80 и 443 для прослушивания.

Быстрый старт

Далее мы используем community-версию Ingress-NGINX, чтобы продемонстрировать, как получить доступ к вашему приложению с помощью контроллера NGINX.

Разверните контроллер Ingress-NGINX.

kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.12.2/deploy/static/provider/cloud/deploy.yaml

После выполнения этой команды автоматически создаются следующие ресурсы:

Вид	Имя	Описание
`Namespace`	`ingress-nginx`	Ресурсы для изоляции контроллеров
`ServiceAccount`	`ingress-nginx`	Сервисный аккаунт для контроллера
`ClusterRole`	`ingress-nginx`	Разрешения на уровне кластера
`ClusterRoleBinding`	`ingress-nginx`	Привязка ClusterRole к SA
`ConfigMap`	`ingress-nginx-controller`	Настройка поведения контроллера (например, уровни логирования, таймаут прокси и т.д.)
`ValidatingWebhookConfig`	`ingress-nginx-admission`	Вебхук для проверки легитимности конфигурации Ingress (опционально)
`Service` (TCP/UDP)	`ingress-nginx-controller`	Тип по умолчанию `LoadBalancer`, можно изменить на `NodePort`.
`Deployment`	`ingress-nginx-controller`
`Pod`	`ingress-nginx-controller-xxx`
`Role`/`RoleBinding`	связанные с admission	Поддержка вебхука
`Job`	`ingress-nginx-admission-create`	Регистрация вебхука

Если вы хотите изменить адрес реестра по умолчанию, можно скачать YAML-файл с помощью curl, изменить его и затем применить.

curl -O https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.12.2/deploy/static/provider/cloud/deploy.yaml

Ожидайте запуска Pod ingress-nginx-controller-xxx.

Локальное тестирование
- Создайте простой веб-сервер и связанный с ним сервис:
  kubectl create deployment demo --image=nginx --port=80 kubectl expose deployment demo
- Создайте ресурс ingress. В этом примере используется хост, который сопоставляется с localhost:
  kubectl create ingress demo-localhost --class=nginx \ --rule="demo.local/*=demo:80"
- Пробросьте локальный порт к контроллеру ingress:
  kubectl port-forward --namespace=ingress-nginx service/ingress-nginx-controller 8080:80
- Получите доступ к вашему развертыванию с помощью curl:
  curl --resolve demo.local:8080:127.0.0.1 http://demo.local:8080
  Примечание: Этот параметр временно разрешает доменное имя demo.local в IP 127.0.0.1 и используется на порту 8080. При посещении http://demo.local:8080 вы фактически посещаете http://127.0.0.1:8080 . С другой стороны, следует настроить hosts:
  echo "127.0.0.1 demo.local" | sudo tee -a /etc/hosts
  В итоге вы должны увидеть HTML-ответ с текстом вроде "Welcome to nginx!".
  
  После этого вы можете получить доступ к сайту по адресу http://demo.local:8080/.
INFO
Тип по умолчанию для ingress-nginx-controller — LoadBalancer. Если поле EXTERNAL-IP показывает pending, это означает, что вашему Kubernetes кластеру не удалось создать балансировщик нагрузки.
Если вы интегрируетесь с провайдером, который поддерживает указание IP-адресов балансировщика нагрузки для Service через (специфичные для провайдера) аннотации, рекомендуется использовать этот способ.
Онлайн-тестирование

Когда у вашего ingress-nginx-controller (Service типа LoadBalancer) появляется EXTERNAL-IP, вы можете создать ресурс ingress. В следующем примере предполагается, что вы настроили DNS-запись для www.developer.io:
```
kubectl create ingress demo --class=nginx \
  --rule="www.developer.io/*=demo:80"
```
Вы можете получить доступ к http://www.developer.io и увидеть тот же вывод.

Предварительные требования

В текущем namespace должен быть доступен Service.
Убедитесь у администратора, что для проекта, связанного с текущим namespace, выделено используемое доменное имя.
Для доступа к домену через HTTPS необходимо предварительно сохранить HTTPS-сертификат в виде TLS-секрета.

Пример Ingress:

# nginx-ingress.yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx-ingress
  namespace: k-1
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
    - host: demo.local
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: nginx-service
                port:
                  number: 80

Для получения дополнительных настроек смотрите nginx-configuration.
Используется контроллер ingress-nginx.
Если вы хотите запускать ingress только локально, предварительно настройте hosts.