#Alauda Container Platform Ingress Controller

#概述

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 Container Platform Ingress Controller，然后点击 Install

#通过 Web 控制台配置

我们通过用户界面提供基本配置选项，并为你生成相应的 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 Service 类型。若要使用 LoadBalancer Service 在外部暴露 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

nodeSelector 和 tolerations 设置控制 Ingress Nginx controller pod 的调度位置。默认情况下，Ingress Nginx controller 不容忍任何污点。

#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 values，包括 .spec.controller.nodeSelector 和 .spec.controller.tolerations。有关其他配置选项，请参阅官方 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 资源。

#商标声明

NGINX® 是 F5, Inc. 在美国及其他国家/地区的注册商标。

MetalLB™ 是 The Linux Foundation 的商标。

Alauda 是独立供应商。本产品与 The Linux Foundation 或 F5, Inc. 没有关联，也未获得其认可或赞助。所有商标均归其各自所有者所有，此处仅用于标识目的。