第 1 章 Routes

流程

1. 运行以下命令，创建一个名为 hello-openshift 的项目：

   $ oc new-project hello-openshift

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，在项目中创建 pod：

   $ oc create -f https://raw.githubusercontent.com/openshift/origin/master/examples/hello-openshift/hello-pod.json

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，创建名为 hello-openshift 的服务：

   $ oc expose pod/hello-openshift

   Copy to Clipboard Toggle word wrap

4. 运行以下命令，创建一个没有安全安全的路由到 hello-openshift 应用程序：

   $ oc expose svc hello-openshift

   Copy to Clipboard Toggle word wrap

流程

1. 运行以下命令，创建一个名为 hello-openshift 的项目：

   $ oc new-project hello-openshift

   Copy to Clipboard Toggle word wrap

2. 运行以下命令，在项目中创建 pod：

   $ oc create -f https://raw.githubusercontent.com/openshift/origin/master/examples/hello-openshift/hello-pod.json

   Copy to Clipboard Toggle word wrap

3. 运行以下命令，创建名为 hello-openshift 的服务：

   $ oc expose pod/hello-openshift

   Copy to Clipboard Toggle word wrap

4. 创建名为 hello-openshift-route.yaml 的路由定义：

   为分片创建的路由的 YAML 定义

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     labels:
       type: sharded 

   1

   
     name: hello-openshift-edge
     namespace: hello-openshift
   spec:
     subdomain: hello-openshift 

   2

   
     tls:
       termination: edge
     to:
       kind: Service
       name: hello-openshift

   Copy to Clipboard Toggle word wrap

   1

   标签键及其对应标签值必须与 Ingress Controller 中指定的标签值匹配。在本例中，Ingress Controller 具有标签键和值 type: sharded。

   2

   路由将使用 subdomain 字段的值公开。指定 subdomain 字段时，您必须保留主机名未设置。如果您同时指定了 host 和 subdomain 字段，则路由将使用 host 字段的值，并忽略 subdomain 字段。

5. 通过运行以下命令，使用 hello-openshift-route.yaml 创建到 hello-openshift 应用程序的路由：

   $ oc -n hello-openshift create -f hello-openshift-route.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 在 OpenShift Container Platform 控制台中或通过 oc create 命令来定义 Ingress 对象：

   Ingress 的 YAML 定义

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: frontend
     annotations:
       route.openshift.io/termination: "reencrypt" 

   1

   
       route.openshift.io/destination-ca-certificate-secret: secret-ca-cert 

   2

   
   spec:
     rules:
     - host: www.example.com 

   3

   
       http:
         paths:
         - backend:
             service:
               name: frontend
               port:
                 number: 443
           path: /
           pathType: Prefix
     tls:
     - hosts:
       - www.example.com
       secretName: example-com-tls-certificate

   Copy to Clipboard Toggle word wrap

   1

   route.openshift.io/termination 注解可用于配置 Route 的 spec.tls.termination 字段，因为 Ingress 没有此字段。可接受的值为 edge、passthrough 和 reencrypt。所有其他值都会被静默忽略。当注解值未设置时，edge 是默认路由。模板文件中必须定义 TLS 证书详细信息，才能实现默认的边缘路由。

   3

   在使用 Ingress 对象时，您必须指定一个显式主机名，这与使用路由时不同。您可以使用 <host_name>.<cluster_ingress_domain> 语法（如 apps.openshiftdemos.com）以利用 *.<cluster_ingress_domain> 通配符 DNS 记录，为集群提供证书。否则，您必须确保有一个用于所选主机名的 DNS 记录。

   1. 如果您在 route.openshift.io/termination 注解中指定 passthrough 值，在 spec 中将 path 设置为 ''，将 pathType 设置为 ImplementationSpecific：

        spec:
          rules:
          - host: www.example.com
            http:
              paths:
              - path: ''
                pathType: ImplementationSpecific
                backend:
                  service:
                    name: frontend
                    port:
                      number: 443

      Copy to Clipboard Toggle word wrap

      $ oc apply -f ingress.yaml

      Copy to Clipboard Toggle word wrap

   2

   route.openshift.io/destination-ca-certificate-secret 可用于 Ingress 对象来定义带有自定义目的地证书(CA)的路由。该注解引用一个 kubernetes secret，secret-ca-cert 将插入到生成的路由中。

   1. 要从 ingress 对象使用目标 CA 指定路由对象，您必须在 secret 的 data.tls.crt specifier 中创建一个带有 PEM 编码格式的证书的 kubernetes.io/tls 或 Opaque 类型 secret。

2. 列出您的路由：

   $ oc get routes

   Copy to Clipboard Toggle word wrap

   结果包括一个自动生成的路由，其名称以 frontend- 开头：

   NAME             HOST/PORT         PATH    SERVICES    PORT    TERMINATION          WILDCARD
   frontend-gnztq   www.example.com           frontend    443     reencrypt/Redirect   None

   Copy to Clipboard Toggle word wrap

   如果您检查这个路由，它会类似于：

   自动生成的路由的 YAML 定义

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     name: frontend-gnztq
     ownerReferences:
     - apiVersion: networking.k8s.io/v1
       controller: true
       kind: Ingress
       name: frontend
       uid: 4e6c59cc-704d-4f44-b390-617d879033b6
   spec:
     host: www.example.com
     path: /
     port:
       targetPort: https
     tls:
       certificate: |
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE-----
       insecureEdgeTerminationPolicy: Redirect
       key: |
         -----BEGIN RSA PRIVATE KEY-----
         [...]
         -----END RSA PRIVATE KEY-----
       termination: reencrypt
       destinationCACertificate: |
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE-----
     to:
       kind: Service
       name: frontend

   Copy to Clipboard Toggle word wrap