2.3. 使用 Kubernetes 网关 API 公开服务

流程

1. 运行以下命令，创建一个名为 httpbin 的命名空间：

   $ oc create namespace httpbin

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，部署名为 httpbin 的示例服务：

   $ oc apply -n httpbin -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/httpbin/httpbin.yaml

   Copy to Clipboard Toggle word wrap

3. 创建名为 httpbin-gw.yaml 的 YAML 文件，用于定义 Kubernetes 网关资源。此资源将网关代理配置为为主机公开端口 80 (HTTP)，即 httpbin.example.com。

   网关资源文件示例

   apiVersion: gateway.networking.k8s.io/v1
   kind: Gateway
   metadata:
     name: httpbin-gateway
     namespace: httpbin
   spec:
     gatewayClassName: istio
     listeners:
     - name: default
       hostname: "httpbin.example.com" 

   1

   
       port: 80
       protocol: HTTP
       allowedRoutes:
         namespaces:
           from: All

   Copy to Clipboard Toggle word wrap

   1

   指定客户端在尝试访问关联端口上网格服务时使用的虚拟主机名。

4. 运行以下命令来应用 YAML 文件：

   $ oc apply -f httpbin-gw.yaml

   Copy to Clipboard Toggle word wrap

5. 创建名为 httpbin-hr.yaml 的 YAML 文件，该文件定义 HTTPRoute 资源。HTTPRoute 资源指定将网关代理的流量路由到 httpbin 服务的规则。

   HTTPRoute 文件示例

   apiVersion: gateway.networking.k8s.io/v1
   kind: HTTPRoute
   metadata:
     name: httpbin
     namespace: httpbin
   spec:
     parentRefs: 

   1

   
     - name: httpbin-gateway
       namespace: httpbin
     rules:
     - matches:
       - path:
           type: PathPrefix
           value: /status
       - path:
           type: PathPrefix
           value: /headers
       backendRefs: 

   2

   
       - name: httpbin
         port: 8000

   Copy to Clipboard Toggle word wrap

   1

   通过将网关资源的名称添加到网关列表中，将 HTTPROUTE 资源绑定到上一步中创建的 Kubernetes 网关资源。

   2

   通过定义包含 httpbin 服务的名称和端口的 backendRefs 将匹配的流量路由到 httpbin 服务。

6. 运行以下命令来应用 YAML 文件：

   $ oc apply -f httpbin-hr.yaml

   Copy to Clipboard Toggle word wrap

7. 运行以下命令，确保网关 API 服务已就绪，并且为该服务分配了地址：

   $ oc wait --for=condition=programmed gtw httpbin-gateway -n httpbin

   Copy to Clipboard Toggle word wrap

验证

1. 运行以下命令，为 curl 客户端创建命名空间：

   $ oc create namespace curl

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来部署 curl 客户端：

   $ oc apply -n curl -f https://raw.githubusercontent.com/openshift-service-mesh/istio/refs/heads/master/samples/curl/curl.yaml

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，使用 curl pod 的名称设置 CURL_POD 变量：

   $ CURL_POD=$(oc get pods -n curl -l app=curl -o jsonpath='{.items[*].metadata.name}')

   Copy to Clipboard Toggle word wrap

4. 使用 curl 客户端，通过入口网关服务资源向 httpbin 应用程序的 /headers 端点发送请求。将请求的 Host 标头设置为 httpbin.example.com，以匹配 Kubernetes 网关和 HTTPROUTE 资源指定的主机。运行以下命令来发送 curl 请求：

   $ oc exec $CURL_POD -n curl -- \
     curl -s -I \
       -H Host:httpbin.example.com \
       <gateway_name>-istio.<gateway_namespace>.svc.cluster.local/headers

   Copy to Clipboard Toggle word wrap

   响应应返回 200 OK HTTP 状态，这表示请求成功。

   输出示例

   HTTP/1.1 200 OK
   server: istio-envoy
   ...

   Copy to Clipboard Toggle word wrap

5. 运行以下命令，向没有相应 Uniform Resource Identifier (URI)前缀匹配 的端点 发送 curl 请求：

   $ oc exec $CURL_POD -n curl -- \
     curl -s -I \
       -H Host:httpbin.example.com \
       <gateway_name>-istio.<gateway_namespace>.svc.cluster.local/get

   Copy to Clipboard Toggle word wrap

   响应返回 404 Not Found 状态。这是正常的，因为 /get 端点在 httpbin HTTPROUTE 资源中没有匹配的 URI 前缀。

   输出示例

   HTTP/1.1 404 Not Found
   server: istio-envoy
   ...

   Copy to Clipboard Toggle word wrap

6. 通过将 Service 类型设置为 LoadBalancer，将网关代理公开给集群外的流量。运行以下命令:

   $ oc patch service <gateway_name>-istio -n <gateway_namespace> -p '{"spec": {"type": "LoadBalancer"}}'

   Copy to Clipboard Toggle word wrap
   注意

   网关也可以使用 OpenShift 路由公开给集群外部的流量。如需更多信息，请参阅"使用 OpenShift 路由向集群外的流量扩展网关"。

7. 使用网关服务资源的外部主机名或 IP 地址，验证可以从集群外部访问 httpbin 服务。确保为运行集群的环境正确设置了 INGRESS_HOST 变量。

   1. 运行以下命令设置 INGRESS_HOST 变量：

      $ export INGRESS_HOST=$(oc get gtw <gateway_name> -n <gateway_namespace> -o jsonpath='{.status.addresses[0].value}')

      Copy to Clipboard Toggle word wrap

   2. 运行以下命令设置 INGRESS_PORT 变量：

      $ INGRESS_PORT=$(oc get gtw <gateway_name> -n <gateway_namespace> -o jsonpath='{.spec.listeners[?(@.name=="http")].port}')

      Copy to Clipboard Toggle word wrap

   3. 使用网关主机，运行以下命令来向 httpbin 服务发送 curl 请求：

      $ curl -s -I -H Host:httpbin.example.com http://$INGRESS_HOST:$INGRESS_PORT/headers

      Copy to Clipboard Toggle word wrap
8. 验证响应是否具有 HTTP/1.1 200 OK 状态，这表示请求是否成功。