Ingress в Kubernetes

• Установка nginx-ingress через helm: helm install ingress-nginx ingress-nginx/ingress-nginx
• cert-manager + ClusterIssuer выписывает сертификаты автоматически
• Path-based routing: /api → api-svc, /web → web-svc
• Rate-limit: nginx.ingress.kubernetes.io/limit-rps: "10"
• Alternatives: Gateway API (K8s 1.29+) — более выразительный, заменит Ingress

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: api
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt
    nginx.ingress.kubernetes.io/limit-rps: "10"
spec:
  ingressClassName: nginx
  tls:
    - hosts: [api.example.com]
      secretName: api-tls
  rules:
    - host: api.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service: { name: api-svc, port: { number: 80 } }

• K8s Gateway API
• CDN setup

Ingress в Kubernetes позволяет управлять внешним доступом к сервисам в кластере, обеспечивая маршрутизацию и балансировку нагрузки. Для настройки Ingress необходимо создать ресурс Ingress с использованием специального контроллера, такого как NGINX Ingress Controller. Основные шаги включают установку контроллера, создание правил маршрутизации и применение конфигурации через манифесты YAML.

Первым шагом в настройке Ingress является установка NGINX Ingress Controller. Это можно сделать с помощью Helm или манифеста Kubernetes. Рассмотрим оба варианта:

Установка с помощью Helm

Для установки через Helm, выполните следующие команды:

helm repo add ingress-nginx https://charts.helm.sh/stable
helm repo update
helm install my-nginx ingress-nginx/ingress-nginx

После выполнения этих команд Ingress Controller будет установлен в ваш кластер Kubernetes. Вы можете проверить его статус с помощью:

kubectl get pods -n ingress-nginx

Установка с помощью манифеста

Если вы предпочитаете установить Ingress Controller вручную, используйте следующий манифест:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-ingress-controller
  namespace: ingress-nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx-ingress-controller
  template:
    metadata:
      labels:
        app: nginx-ingress-controller
    spec:
      containers:
      - name: nginx-ingress-controller
        image: quay.io/kubernetes-ingress-controller/nginx-ingress-controller:latest
        ports:
        - containerPort: 80
        - containerPort: 443

После создания манифеста, примените его командой:

kubectl apply -f nginx-ingress-controller.yaml

Теперь Ingress Controller работает, и вы можете настроить маршруты для вашего приложения.

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

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: myapp.example.com
    http:
      paths:
      - path: /api
        pathType: Prefix
        backend:
          service:
            name: my-api-service
            port:
              number: 80
      - path: /
        pathType: Prefix
        backend:
          service:
            name: my-web-service
            port:
              number: 80

В этом примере мы создаем ресурс Ingress, который направляет трафик на два разных сервиса в зависимости от пути. Запросы к /api будут перенаправлены на my-api-service, а все остальные запросы — на my-web-service.

Примените манифест с помощью команды:

kubectl apply -f my-ingress.yaml

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