第 5 章 开发

流程

1. 在离线模式下，创建一个本地 Knative 服务描述符文件：

   $ kn service create event-display \
       --image quay.io/openshift-knative/knative-eventing-sources-event-display:latest \
       --target ./ \
       --namespace test

   输出示例

   Service 'event-display' created in namespace 'test'.

   • --target ./ 标志启用脱机模式，并将 ./ 指定为用于存储新目录树的目录。

     如果您没有指定现有目录，但使用文件名，如 --target my-service.yaml，则不会创建目录树。相反，当前目录中只创建服务描述符 my-service.yaml 文件。

     文件名可以具有 .yaml、.yml 或 .json 扩展名。选择 .json 以 JSON 格式创建服务描述符文件。

   • namespace test 选项将新服务放在 test 命名空间中。

     如果不使用 --namespace，且您登录到 OpenShift Container Platform 集群，则会在当前命名空间中创建描述符文件。否则，描述符文件会在 default 命名空间中创建。

2. 检查创建的目录结构：

   $ tree ./

   输出示例

   ./
   └── test
       └── ksvc
           └── event-display.yaml
   
   2 directories, 1 file

   • 使用 --target 指定的当前 ./ 目录包含新的 test/ 目录，它在指定的命名空间后命名。
   • test/ 目录包含 ksvc，它在资源类型后命名。
   • ksvc 目录包含描述符文件 event-display.yaml，它根据指定的服务名称命名。

3. 检查生成的服务描述符文件：

   $ cat test/ksvc/event-display.yaml

   输出示例

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     creationTimestamp: null
     name: event-display
     namespace: test
   spec:
     template:
       metadata:
         annotations:
           client.knative.dev/user-image: quay.io/openshift-knative/knative-eventing-sources-event-display:latest
         creationTimestamp: null
       spec:
         containers:
         - image: quay.io/openshift-knative/knative-eventing-sources-event-display:latest
           name: ""
           resources: {}
   status: {}

4. 列出新服务的信息：

   $ kn service describe event-display --target ./ --namespace test

   输出示例

   Name:       event-display
   Namespace:  test
   Age:
   URL:
   
   Revisions:
   
   Conditions:
     OK TYPE    AGE REASON

   • --target ./ 选项指定包含命名空间子目录的目录结构的根目录。

     另外，您可以使用 --target 选项直接指定 YAML 或 JSON 文件名。可接受的文件扩展包括 .yaml、.yml 和 .json。

   • --namespace 选项指定命名空间，与 kn 通信包含所需服务描述符文件的子目录。

     如果不使用 --namespace，并且您登录到 OpenShift Container Platform 集群，kn 会在以当前命名空间命名的子目录中搜索该服务。否则，kn 在 default/ 子目录中搜索。

5. 使用服务描述符文件在集群中创建服务：

   $ kn service create -f test/ksvc/event-display.yaml

   输出示例

   Creating service 'event-display' in namespace 'test':
   
     0.058s The Route is still working to reflect the latest desired specification.
     0.098s ...
     0.168s Configuration "event-display" is waiting for a Revision to become ready.
    23.377s ...
    23.419s Ingress has not yet been reconciled.
    23.534s Waiting for load balancer to be ready
    23.723s Ready to serve.
   
   Service 'event-display' created to latest revision 'event-display-00001' is available at URL:
   http://event-display-test.apps.example.com

流程

1. 创建包含以下示例代码的 YAML 文件：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: event-delivery
     namespace: default
   spec:
     template:
       spec:
         containers:
           - image: quay.io/openshift-knative/knative-eventing-sources-event-display:latest
             env:
               - name: RESPONSE
                 value: "Hello Serverless!"

2. 导航到包含 YAML 文件的目录，并通过应用 YAML 文件来部署应用程序：

   $ oc apply -f <filename>

流程

1. 查找应用程序 URL:

   $ oc get ksvc <service_name>

   输出示例

   NAME            URL                                        LATESTCREATED         LATESTREADY           READY   REASON
   event-delivery   http://event-delivery-default.example.com   event-delivery-4wsd2   event-delivery-4wsd2   True

2. 向集群发出请求并观察其输出。

   HTTP 请求示例

   $ curl http://event-delivery-default.example.com

   HTTPS 请求示例

   $ curl https://event-delivery-default.example.com

   输出示例

   Hello Serverless!

3. 可选。如果您在证书链中收到与自签名证书相关的错误，可以在 curl 命令中添加 --insecure 标志来忽略以下错误：

   $ curl https://event-delivery-default.example.com --insecure

   输出示例

   Hello Serverless!

   重要

   在生产部署中不能使用自签名证书。这个方法仅用于测试目的。

4. 可选。如果 OpenShift Container Platform 集群配置有证书颁发机构 (CA) 签名但尚未为您的系统配置全局证书，您可以使用 curl 命令指定此证书。证书的路径可使用 --cacert 标志传递给 curl 命令：

   $ curl https://event-delivery-default.example.com --cacert <file>

   输出示例

   Hello Serverless!

流程

1. 找到应用程序主机。请参阅验证无服务器应用程序部署中的相关内容。

2. 查找 ingress 网关的公共地址：

   $ oc -n knative-serving-ingress get svc kourier

   输出示例

   NAME                   TYPE           CLUSTER-IP      EXTERNAL-IP                                                             PORT(S)                                                                                                                                      AGE
   kourier   LoadBalancer   172.30.51.103   a83e86291bcdd11e993af02b7a65e514-33544245.us-east-1.elb.amazonaws.com   80:31380/TCP,443:31390/TCP   67m

   公共地址位于 EXTERNAL-IP 字段，在本例中是 a83e86291bcdd11e993af02b7a65e514-33544245.us-east-1.elb.amazonaws.com。

3. 手动在 HTTP 请求的主机标头中设置应用程序的主机，但将请求定向到 ingress 网关的公共地址。

   $ curl -H "Host: hello-default.example.com" a83e86291bcdd11e993af02b7a65e514-33544245.us-east-1.elb.amazonaws.com

   输出示例

   Hello Serverless!

   您还可以通过将授权设置为应用程序的主机来发出 gRPC 请求，同时将请求直接定向到 ingress 网关：

   grpc.Dial(
       "a83e86291bcdd11e993af02b7a65e514-33544245.us-east-1.elb.amazonaws.com:80",
       grpc.WithAuthority("hello-default.example.com:80"),
       grpc.WithInsecure(),
   )

   注意

   如上例所示，请确保将对应的端口（默认为 80）附加到两个主机中。

流程

1. 将 knative.openshift.io/system-namespace=true 标签添加到需要访问应用程序的每个 Knative 系统命名空间：

   1. 标记 knative-serving 命名空间：

      $ oc label namespace knative-serving knative.openshift.io/system-namespace=true

   2. 标记 knative-serving-ingress 命名空间：

      $ oc label namespace knative-serving-ingress knative.openshift.io/system-namespace=true

   3. 标记 knative-eventing 命名空间：

      $ oc label namespace knative-eventing knative.openshift.io/system-namespace=true

   4. 标记 knative-kafka 命名空间：

      $ oc label namespace knative-kafka knative.openshift.io/system-namespace=true

2. 在应用程序命名空间中创建一个 NetworkPolicy 对象，允许从带有 knative.openshift.io/system-namespace 标签的命名空间访问：

   NetworkPolicy 对象示例

   apiVersion: networking.k8s.io/v1
   kind: NetworkPolicy
   metadata:
     name: <network_policy_name> 1
     namespace: <namespace> 2
   spec:
     ingress:
     - from:
       - namespaceSelector:
           matchLabels:
             knative.openshift.io/system-namespace: "true"
     podSelector: {}
     policyTypes:
     - Ingress

   1

   为您的网络策略提供名称。

   2

   应用程序所在的命名空间。