27.6. 在 AWS 上配置集群入口流量

流程

1. 使用 oc annotate 命令，为路由添加超时：

   $ oc annotate route <route_name> \
       --overwrite haproxy.router.openshift.io/timeout=<timeout><time_unit> 1

   1

   支持的时间单位是微秒 (us)、毫秒 (ms)、秒钟 (s)、分钟 (m)、小时 (h)、或天 (d)。

   以下示例在名为 myroute 的路由上设置两秒的超时：

   $ oc annotate route myroute --overwrite haproxy.router.openshift.io/timeout=2s

流程

1. 运行以下命令，为默认的 ingresscontroller 设置 AWS 连接闲置超时：

   $ oc -n openshift-ingress-operator patch ingresscontroller/default \
       --type=merge --patch='{"spec":{"endpointPublishingStrategy": \
       {"type":"LoadBalancerService", "loadBalancer": \
       {"scope":"External", "providerParameters":{"type":"AWS", "aws": \
       {"type":"Classic", "classicLoadBalancer": \
       {"connectionIdleTimeout":"5m"}}}}}}}'

2. 可选：运行以下命令来恢复超时的默认值：

   $ oc -n openshift-ingress-operator patch ingresscontroller/default \
       --type=merge --patch='{"spec":{"endpointPublishingStrategy": \
       {"loadBalancer":{"providerParameters":{"aws":{"classicLoadBalancer": \
       {"connectionIdleTimeout":null}}}}}}}'

流程

1. 修改您要使用 NLB 切换到的现有 Ingress Controller。这个示例假定您的默认 Ingress Controller 具有外部范围，且没有其他自定义：

   ingresscontroller.yaml 文件示例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: NLB
       type: LoadBalancerService

   注意

   如果您没有为 spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.type 字段指定值，Ingress Controller 会使用在安装过程中设置的集群 Ingress 配置中的 spec.loadBalancer.platform.aws.type 值。

   提示

   如果您的 Ingress Controller 有其他要更新的自定义（如更改域），请考虑强制替换 Ingress Controller 定义文件。

2. 运行以下命令，将更改应用到 Ingress Controller YAML 文件：

   $ oc apply -f ingresscontroller.yaml

   当 Ingress Controller 更新时，可能会有几分钟的停机。

流程

1. 修改您要切换为使用 CLB 的现有 Ingress Controller。这个示例假定您的默认 Ingress Controller 具有外部范围，且没有其他自定义：

   ingresscontroller.yaml 文件示例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: Classic
       type: LoadBalancerService

   注意

   如果您没有为 spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.type 字段指定值，Ingress Controller 会使用在安装过程中设置的集群 Ingress 配置中的 spec.loadBalancer.platform.aws.type 值。

   提示

   如果您的 Ingress Controller 有其他要更新的自定义（如更改域），请考虑强制替换 Ingress Controller 定义文件。

2. 运行以下命令，将更改应用到 Ingress Controller YAML 文件：

   $ oc apply -f ingresscontroller.yaml

   当 Ingress Controller 更新时，可能会有几分钟的停机。

流程

1. 创建一个新的默认 Ingress Controller 文件。以下示例假定您的默认 Ingress Controller 具有外部范围，且没有其他自定义：

   ingresscontroller.yml 文件示例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: NLB
       type: LoadBalancerService

   如果您的默认 Ingress Controller 有其他自定义，请确定您相应地修改该文件。

   提示

   如果您的 Ingress Controller 没有其他自定义，且您只更新负载均衡器类型，请考虑 "Switch the Ingress Controller from using an Classic Load Balancer to a Network Load Balancer" 中详述的步骤。

2. 强制替换 Ingress Controller YAML 文件：

   $ oc replace --force --wait -f ingresscontroller.yml

   等待 Ingress Controller 已被替换。预计会有几分钟的停机时间。

1. 创建 Ingress Controller 清单：

    $ cat ingresscontroller-aws-nlb.yaml

   输出示例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: $my_ingress_controller1
     namespace: openshift-ingress-operator
   spec:
     domain: $my_unique_ingress_domain2
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: External3
         providerParameters:
           type: AWS
           aws:
             type: NLB

   1

   将 $my_ingress_controller 替换为 Ingress Controller 的唯一名称。

   2

   将 $my_unique_ingress_domain 替换为集群中所有 Ingress Controller 的唯一域名。此变量需要是 DNS 名的子域 <clustername>.<domain>。

   3

   您可以将 External 替换为 Internal，以使用内部 NLB。

2. 在集群中创建资源：

   $ oc create -f ingresscontroller-aws-nlb.yaml

1. 进入包含安装程序的目录并创建清单：

   $ ./openshift-install create manifests --dir <installation_directory> 1

   1

   对于 <installation_directory>，请指定含有集群的 install-config.yaml 文件的目录的名称。

2. 在 <installation_directory>/manifests/ 目录中创建一个名为 cluster-ingress-default-ingresscontroller.yaml 的文件：

   $ touch <installation_directory>/manifests/cluster-ingress-default-ingresscontroller.yaml 1

   1

   对于 <installation_directory>，请指定包含集群的 manifests/ 目录的目录名称。

   创建该文件后，几个网络配置文件位于 manifests/ 目录中，如下所示：

   $ ls <installation_directory>/manifests/cluster-ingress-default-ingresscontroller.yaml

   输出示例

   cluster-ingress-default-ingresscontroller.yaml

3. 在编辑器中打开 cluster-ingress-default-ingresscontroller.yaml 文件，并输入描述您想要的 Operator 配置的自定义资源（CR）：

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: NLB
       type: LoadBalancerService

4. 保存 cluster-ingress-default-ingresscontroller.yaml 文件并退出文本编辑器。
5. 可选：备份 manifests/cluster-ingress-default-ingresscontroller.yaml 文件。创建集群时，安装程序会删除 manifests/ 目录。