第 1 章 Knative Serving 入门

流程

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

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: showcase
     namespace: default
   spec:
     template:
       spec:
         containers:
           - image: quay.io/openshift-knative/showcase
             env:
               - name: GREET
                 value: Bonjour

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

   $ oc apply -f <filename>

流程

1. 进入 Serverless Serving 页面。
2. 在 Create 列表中，选择 Service。
3. 手动输入 YAML 或 JSON 定义，或者将文件拖放到编辑器中。
4. 点 Create。

流程

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

   $ kn service create showcase \
       --image quay.io/openshift-knative/showcase \
       --target ./ \
       --namespace test

   输出示例

   Service 'showcase' 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
           └── showcase.yaml
   
   2 directories, 1 file

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

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

   $ cat test/ksvc/showcase.yaml

   输出示例

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

4. 列出新服务的信息：

   $ kn service describe showcase --target ./ --namespace test

   输出示例

   Name:       showcase
   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/showcase.yaml

   输出示例

   Creating service 'showcase' in namespace 'test':
   
     0.058s The Route is still working to reflect the latest desired specification.
     0.098s ...
     0.168s Configuration "showcase" 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 'showcase' created to latest revision 'showcase-00001' is available at URL:
   http://showcase-test.apps.example.com

流程

1. 查找应用程序 URL:

   $ oc get ksvc <service_name>

   输出示例

   NAME       URL                                   LATESTCREATED    LATESTREADY      READY   REASON
   showcase   http://showcase-default.example.com   showcase-00001   showcase-00001   True

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

   HTTP 请求示例（使用 HTTPie 工具）

   $ http showcase-default.example.com

   HTTPS 请求示例

   $ https showcase-default.example.com

   输出示例

   HTTP/1.1 200 OK
   Content-Type: application/json
   Server: Quarkus/2.13.7.Final-redhat-00003 Java/17.0.7
   X-Config: {"sink":"http://localhost:31111","greet":"Ciao","delay":0}
   X-Version: v0.7.0-4-g23d460f
   content-length: 49
   
   {
       "artifact": "knative-showcase",
       "greeting": "Ciao"
   }

3. 可选。如果您的系统中没有安装 HTTPie 工具，您可以使用 curl 工具：

   HTTPS 请求示例

   $ curl http://showcase-default.example.com

   输出示例

   {"artifact":"knative-showcase","greeting":"Ciao"}

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

   $ https --verify=no showcase-default.example.com

   输出示例

   HTTP/1.1 200 OK
   Content-Type: application/json
   Server: Quarkus/2.13.7.Final-redhat-00003 Java/17.0.7
   X-Config: {"sink":"http://localhost:31111","greet":"Ciao","delay":0}
   X-Version: v0.7.0-4-g23d460f
   content-length: 49
   
   {
       "artifact": "knative-showcase",
       "greeting": "Ciao"
   }

   重要

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

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

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

   输出示例

   {"artifact":"knative-showcase","greeting":"Ciao"}