#Ingress Nginx Operator

#概述

Ingress Nginx Operator 用于简化对 Ingress-Nginx 部署的高级管理。 此 Operator 简化了 Ingress-Nginx 实例的部署、配置和维护流程。其运作架构如下：Ingress-Nginx Operator 会持续监控类型为 ingressnginxes.ingress-nginx.alauda.io (IngressNginx) 的自定义资源，并为每个已定义的 IngressNginx 资源自动创建对应的 Ingress-Nginx 实例。借助此架构，您可以直接操作 IngressNginx 自定义资源，以控制 Ingress-Nginx 的功能和行为。

#安装

1. 导航至 Administrator -> Marketplace -> OperatorHub
2. 找到 Alauda build of Ingress NGINX Controller 并点击 Install

#通过 Web Console 配置

我们通过用户界面提供基本配置选项，并为您生成相应的 YAML。对于更复杂的配置，您可以直接编辑 YAML。

完成 Ingress Nginx Operator 的安装后：

1. 导航至 All Instances 标签页
2. 点击 Create，然后在显示的对话框中找到 IngressNginx Instance Type 部分并点击 Create

#通过 YAML 配置

默认情况下，Ingress Nginx Operator 会在相应 IngressNginx 自定义资源所在的同一命名空间中部署 Ingress Nginx 实例。

#Ingress 分片

默认情况下，对于显式指定其 IngressClass 名称或未指定任何 IngressClass 的 Ingress，Ingress Nginx 会处理所有命名空间中的 Ingress 资源。您可以使用 .controller.scope.namespaceSelector 将实例限制为特定的命名空间。例如，以下 IngressNginx 资源 demo-scope 只处理带有标签 cpaas.io/project=demo 的命名空间中的 Ingress。

#创建处理所有命名空间中 Ingress 的 IngressNginx

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo-all
spec:
  controller:
    nodeSelector:
      kubernetes.io/os: linux
    replicaCount: 1

#创建处理特定命名空间中 Ingress 的 IngressNginx

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo-scope
spec:
  controller:
    scope:
      namespaceSelector: 'cpaas.io/project=demo'
    nodeSelector:
      kubernetes.io/os: linux
    replicaCount: 1

#通过 LoadBalancer 暴露

默认情况下，Ingress Controller 配置为 ClusterIP 服务类型。要使用 LoadBalancer 服务将 Ingress Controller 对外暴露，请应用以下配置：

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo
spec:
  controller:
    service:
      type: LoadBalancer

使用 MetalLB 时指定 LoadBalancer VIP：

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo
spec:
  controller:
    service:
      type: LoadBalancer
      annotations:
        metallb.universe.tf/loadBalancerIPs: '192.168.2.2' # Desired VIP
        metallb.universe.tf/address-pool: 'pool-name' # MetalLB address pool

#高级 Controller 部署设置

配置网络模式、副本数、资源限制、节点选择和污点容忍：

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo
spec:
  controller:
    hostNetwork: false
    replicaCount: 1
    nodeSelector:
      dedicated: ingress
    tolerations:
      - key: dedicated
        operator: Equal
        value: ingress
        effect: NoSchedule
    resources:
      limits:
        cpu: 200m
        memory: 256Mi
      requests:
        cpu: 200m
        memory: 256Mi

#SSL 透传

启用 SSL 透传功能：

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo
spec:
  controller:
    extraArgs:
      enable-ssl-passthrough: ''

#IPv4 和 IPv6 双栈支持

apiVersion: ingress-nginx.alauda.io/v1
kind: IngressNginx
metadata:
  name: demo
spec:
  controller:
    service:
      ipFamilyPolicy: PreferDualStack

#其他资源

IngressNginx 资源的 .spec 字段直接对应 Ingress Nginx 的 Helm Chart 值。有关其他配置选项，请参阅 官方 Ingress NGINX 文档。

#与官方 Chart 的默认值差异

1. 默认情况下，每个 IngressNginx 实例都会创建一个名称为 $ns-$name 且 controllerValue 为 ingress-nginx.cpaas.io/$ns-$name 的 IngressClass。您可以使用 .spec.controller.ingressClassResource.name 和 .spec.controller.ingressClassResource.controllerValue 参数自定义这些值。
2. 默认情况下，.spec.controller.service.type 设置为 ClusterIP。
3. 默认情况下，.spec.controller.watchIngressWithoutClass 设置为 true，这意味着 Controller 会处理未指定 IngressClass 的 Ingress 资源。