1.3. 配置路由

流程

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

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

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

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个路由定义，并将它保存到名为 app-example-route.yaml 的文件中：

   使用 HTTP 标头指令创建路由的 YAML 定义

   apiVersion: route.openshift.io/v1
   kind: Route
   # ...
   spec:
     host: app.example.com
     tls:
       termination: edge
     to:
       kind: Service
       name: app-example
     httpHeaders:
       actions: 

   1

   
         response: 

   2

   
         - name: Content-Location 

   3

   
           action:
             type: Set 

   4

   
             set:
               value: /lang/en-us 

   5

   Copy to Clipboard Toggle word wrap

   1

   要在 HTTP 标头上执行的操作列表。

   2

   您要更改的标头类型。在本例中，响应标头。

   3

   您要更改的标头的名称。有关您可以设置或删除的可用标头列表，请参阅 HTTP 标头配置。

   4

   在标头中执行的操作类型。此字段可以具有 Set 或 Delete 的值。

   5

   在设置 HTTP 标头时，您必须提供一个 value。该值可以是该标头的可用指令列表中的字符串，如 DENY，也可以是使用 HAProxy 的动态值语法来解释的动态值。在这种情况下，该值被设置为内容的相对位置。

2. 使用新创建的路由定义，创建到现有 Web 应用程序的路由：

   $ oc -n app-example create -f app-example-route.yaml

   Copy to Clipboard Toggle word wrap

1. 默认情况下，路由器会每 5 秒重新加载一次，它会从头重置容器集之间的平衡连接。因此，roundrobin 状态不会在重新加载后保留。当 pod 具有几乎相同的计算能力和存储容量时，此算法效果最佳。如果您的应用程序或服务会持续更改端点，例如，由于使用了 CI/CD 管道，可能会出现不平衡的结果。如果是这种情况下，可以使用不同的算法。

2. 如果允许列表中的 IP 地址和 CIDR 范围超过 61，它们将被写入到一个独立的文件中，haproxy.config 会引用这个文件。此文件存储在 /var/lib/haproxy/router/allowlists 文件夹中。

   注意

   为确保地址被写入允许列表，请检查 Ingress Controller 配置文件中是否列出了 CIDR 范围的完整列表。etcd 对象大小限制了路由注解的大小。因此，它实际上是为您可以在允许列表中包含的 IP 地址和 CIDR 范围的最大数量创建一个阈值。

流程

1. 要使 Ingress Controller 为工作负载提供通过 IPv4/IPv6 的流量，您可以通过设置 ipFamilies 和 ipFamilyPolicy 字段来创建服务 YAML 文件，或通过设置 ipFamilies 和 ipFamilyPolicy 字段来修改现有服务 YAML 文件。例如：

   服务 YAML 文件示例

   apiVersion: v1
   kind: Service
   metadata:
     creationTimestamp: yyyy-mm-ddT00:00:00Z
     labels:
       name: <service_name>
       manager: kubectl-create
       operation: Update
       time: yyyy-mm-ddT00:00:00Z
     name: <service_name>
     namespace: <namespace_name>
     resourceVersion: "<resource_version_number>"
     selfLink: "/api/v1/namespaces/<namespace_name>/services/<service_name>"
     uid: <uid_number>
   spec:
     clusterIP: 172.30.0.0/16
     clusterIPs: 

   1

   
     - 172.30.0.0/16
     - <second_IP_address>
     ipFamilies: 

   2

   
     - IPv4
     - IPv6
     ipFamilyPolicy: RequireDualStack 

   3

   
     ports:
     - port: 8080
       protocol: TCP
       targetport: 8080
     selector:
       name: <namespace_name>
     sessionAffinity: None
     type: ClusterIP
   status:
     loadbalancer: {}

   Copy to Clipboard Toggle word wrap

   1

   在双栈实例中，提供了两个不同的 clusterIP。

   2

   对于单堆栈实例，输入 IPv4 或 IPv6。对于双栈实例，请输入 IPv4 和 IPv6。

   3

   对于单堆栈实例，请输入 SingleStack。对于双栈实例，请输入 RequireDualStack。

   这些资源生成对应的端点。Ingress Controller 现在监视 endpointslices。

2. 要查看端点，请输入以下命令：

   $ oc get endpoints

   Copy to Clipboard Toggle word wrap

3. 要查看endpointslices，输入以下命令：

   $ oc get endpointslices

   Copy to Clipboard Toggle word wrap