4.4.2. 关于 Knative CLI 离线模式

流程

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 集群，则会在当前命名空间中创建描述符文件。否则，描述符文件会在 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 集群，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