9.3. 为 Knative 服务配置路由

流程

1. 创建包含 service.knative.openshift.io/disableRoute=true 注解的 Knative 服务：

   重要

   service.knative.openshift.io/disableRoute=true 注解指示 OpenShift Serverless 不自动为您创建路由。但是，该服务仍然会显示 URL 并达到 Ready 状态。除非使用与 URL 中主机名相同的主机名创建自己的路由，此 URL 才能在外部工作。

   1. 创建 Knative Service 资源：

      资源示例

      apiVersion: serving.knative.dev/v1
      kind: Service
      metadata:
        name: <service_name>
        annotations:
          serving.knative.openshift.io/disableRoute: "true"
      spec:
        template:
          spec:
            containers:
            - image: <image>
      ...

   2. 应用 Service 资源：

      $ oc apply -f <filename>

   3. 可选。使用 kn service create 命令创建 Knative 服务：

      kn 命令示例

      $ kn service create <service_name> \
        --image=gcr.io/knative-samples/helloworld-go \
        --annotation serving.knative.openshift.io/disableRoute=true

2. 验证没有为服务创建 OpenShift Container Platform 路由：

   示例命令

   $ $ oc get routes.route.openshift.io \
     -l serving.knative.openshift.io/ingressName=$KSERVICE_NAME \
     -l serving.knative.openshift.io/ingressNamespace=$KSERVICE_NAMESPACE \
     -n knative-serving-ingress

   您将看到以下输出：

   No resources found in knative-serving-ingress namespace.

3. 在 knative-serving-ingress 命名空间中创建 Route 资源：

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     annotations:
       haproxy.router.openshift.io/timeout: 600s 1
     name: <route_name> 2
     namespace: knative-serving-ingress 3
   spec:
     host: <service_host> 4
     port:
       targetPort: http2
     to:
       kind: Service
       name: kourier
       weight: 100
     tls:
       insecureEdgeTerminationPolicy: Allow
       termination: edge 5
       key: |-
         -----BEGIN PRIVATE KEY-----
         [...]
         -----END PRIVATE KEY-----
       certificate: |-
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE-----
       caCertificate: |-
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE----
     wildcardPolicy: None

   1

   OpenShift Container Platform 路由的超时值。您必须设置与 max-revision-timeout-seconds 设置相同的值（默认为 600s ）。

   2

   OpenShift Container Platform 路由的名称。

   3

   OpenShift Container Platform 路由的命名空间。这必须是 knative-serving-ingress。

   4

   用于外部访问的主机名。您可以将其设置为 <service_name>-<service_namespace>.<domain>。

   5

   您要使用的证书。目前，只支持 边缘（edge） 终止。

4. 应用 Route 资源：

   $ oc apply -f <filename>