Knative CLI

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。
• 已安装 Knative (kn) CLI。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。

流程

• 创建 Knative 服务：

  $ kn service create <service-name> --image <image> --tag <tag-value>

  Copy to Clipboard Toggle word wrap

  其中：

  • --image 是应用的镜像的 URI。

  • --tag 是一个可选标志，可用于向利用服务创建的初始修订版本添加标签。

    示例命令

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

    Copy to Clipboard Toggle word wrap

    输出示例

    Creating service 'showcase' in namespace 'default':
    
      0.271s The Route is still working to reflect the latest desired specification.
      0.580s Configuration "showcase" is waiting for a Revision to become ready.
      3.857s ...
      3.861s Ingress has not yet been reconciled.
      4.270s Ready to serve.
    
    Service 'showcase' created with latest revision 'showcase-00001' and URL:
    http://showcase-default.apps-crc.testing

    Copy to Clipboard Toggle word wrap

示例命令

• 通过添加新环境变量来更新服务：

  $ kn service update <service_name> --env <key>=<value>

  Copy to Clipboard Toggle word wrap

• 通过添加新端口来更新服务：

  $ kn service update <service_name> --port 80

  Copy to Clipboard Toggle word wrap

• 通过添加新的请求和限制参数来更新服务：

  $ kn service update <service_name> --request cpu=500m --limit memory=1024Mi --limit cpu=1000m

  Copy to Clipboard Toggle word wrap

• 为修订分配 latest 标签：

  $ kn service update <service_name> --tag <revision_name>=latest

  Copy to Clipboard Toggle word wrap

• 为服务的最新 READY 修订将标签从 testing 更新为 staging：

  $ kn service update <service_name> --untag testing --tag @latest=staging

  Copy to Clipboard Toggle word wrap

• 将 test 标签添加到接收 10% 流量的修订，并将其它流量发送到服务的最新 READY 修订：

  $ kn service update <service_name> --tag <revision_name>=test --traffic test=10,@latest=90

  Copy to Clipboard Toggle word wrap

示例命令

• 创建服务：

  $ kn service apply <service_name> --image <image>

  Copy to Clipboard Toggle word wrap

• 将环境变量添加到服务：

  $ kn service apply <service_name> --image <image> --env <key>=<value>

  Copy to Clipboard Toggle word wrap

• 从 JSON 或 YAML 文件中读取服务声明：

  $ kn service apply <service_name> -f <filename>

  Copy to Clipboard Toggle word wrap

示例命令

• 描述服务：

  $ kn service describe --verbose <service_name>

  Copy to Clipboard Toggle word wrap

  --verbose 标志是可选的，但可以包含它以提供更详细的描述。常规输出和详细输出之间的区别在以下示例中显示：

  没有 --verbose 标记的输出示例

  Name:       showcase
  Namespace:  default
  Age:        2m
  URL:        http://showcase-default.apps.ocp.example.com
  
  Revisions:
    100%  @latest (showcase-00001) [1] (2m)
          Image:  quay.io/openshift-knative/showcase (pinned to aaea76)
  
  Conditions:
    OK TYPE                   AGE REASON
    ++ Ready                   1m
    ++ ConfigurationsReady     1m
    ++ RoutesReady             1m

  Copy to Clipboard Toggle word wrap

  带有 --verbose 标记的输出示例

  Name:         showcase
  Namespace:    default
  Annotations:  serving.knative.dev/creator=system:admin
                serving.knative.dev/lastModifier=system:admin
  Age:          3m
  URL:          http://showcase-default.apps.ocp.example.com
  Cluster:      http://showcase.default.svc.cluster.local
  
  Revisions:
    100%  @latest (showcase-00001) [1] (3m)
          Image:  quay.io/openshift-knative/showcase (pinned to aaea76)
          Env:    GREET=Bonjour
  
  Conditions:
    OK TYPE                   AGE REASON
    ++ Ready                   3m
    ++ ConfigurationsReady     3m
    ++ RoutesReady             3m

  Copy to Clipboard Toggle word wrap

• 以 YAML 格式描述服务：

  $ kn service describe <service_name> -o yaml

  Copy to Clipboard Toggle word wrap

• 以 JSON 格式描述服务：

  $ kn service describe <service_name> -o json

  Copy to Clipboard Toggle word wrap

• 仅输出服务 URL：

  $ kn service describe <service_name> -o url

  Copy to Clipboard Toggle word wrap

• 在使用描述符文件对集群进行更改之前，您可以手动修改该文件。
• 您可以在本地跟踪版本控制系统中服务的描述符文件。这可让您在目标集群以外的位置重复使用描述符文件，例如在持续集成（CI）管道、开发环境或演示中。
• 您可以检查创建的描述符文件，以了解 Knative 服务的信息。特别是，您可以看到生成的服务如何受到传递给 kn 命令的不同参数的影响。

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。
• 已安装 Knative (kn) CLI。

• 从镜像添加容器并将其打印到标准输出中：

  $ kn container add <container_name> --image <image_uri>

  Copy to Clipboard Toggle word wrap

  示例命令

  $ kn container add sidecar --image docker.io/example/sidecar

  Copy to Clipboard Toggle word wrap

  输出示例

  containers:
  - image: docker.io/example/sidecar
    name: sidecar
    resources: {}

  Copy to Clipboard Toggle word wrap

• 将两个 kn container add 命令链接在一起，然后将它们传递给 kn service create 命令创建带有两个容器的 Knative 服务：

  $ kn container add <first_container_name> --image <image_uri> | \
  kn container add <second_container_name> --image <image_uri> | \
  kn service create <service_name> --image <image_uri> --extra-containers -

  Copy to Clipboard Toggle word wrap

  --extra-containers - 指定一个特殊情况，kn 读取管道输入，而不是 YAML 文件。

  示例命令

  $ kn container add sidecar --image docker.io/example/sidecar:first | \
  kn container add second --image docker.io/example/sidecar:second | \
  kn service create my-service --image docker.io/example/my-app:latest --extra-containers -

  Copy to Clipboard Toggle word wrap

  --extra-containers 标志也可以接受到 YAML 文件的路径：

  $ kn service create <service_name> --image <image_uri> --extra-containers <filename>

  Copy to Clipboard Toggle word wrap

  示例命令

  $ kn service create my-service --image docker.io/example/my-app:latest --extra-containers my-extra-containers.yaml

  Copy to Clipboard Toggle word wrap

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。

• 您已创建了 Knative 服务或路由，并控制要映射到该 CR 的自定义域。

  注意

  您的自定义域必须指向 OpenShift Container Platform 集群的 DNS。

• 已安装 Knative (kn) CLI。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。

流程

• 将域映射到当前命名空间中的 CR：

  $ kn domain create <domain_mapping_name> --ref <target_name>

  Copy to Clipboard Toggle word wrap

  示例命令

  $ kn domain create example.com --ref showcase

  Copy to Clipboard Toggle word wrap

  --ref 标志为域映射指定一个可寻址的目标 CR。

  如果使用 --ref 标志时没有提供前缀，则会假定目标为当前命名空间中的 Knative 服务。

• 将域映射到指定命名空间中的 Knative 服务：

  $ kn domain create <domain_mapping_name> --ref <ksvc:service_name:service_namespace>

  Copy to Clipboard Toggle word wrap

  示例命令

  $ kn domain create example.com --ref ksvc:showcase:example-namespace

  Copy to Clipboard Toggle word wrap

• 将域映射到 Knative 路由：

  $ kn domain create <domain_mapping_name> --ref <kroute:route_name>

  Copy to Clipboard Toggle word wrap

  示例命令

  $ kn domain create example.com --ref kroute:example-route

  Copy to Clipboard Toggle word wrap

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。
• 您至少已创建了一个 DomainMapping CR。
• 已安装 Knative (kn) CLI 工具。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。

流程

• 列出现有的 DomainMapping CR：

  $ kn domain list -n <domain_mapping_namespace>

  Copy to Clipboard Toggle word wrap

• 查看现有 DomainMapping CR 的详情：

  $ kn domain describe <domain_mapping_name>

  Copy to Clipboard Toggle word wrap

• 更新 DomainMapping CR 以指向新目标：

  $ kn domain update --ref <target>

  Copy to Clipboard Toggle word wrap

• 删除 DomainMapping CR：

  $ kn domain delete <domain_mapping_name>

  Copy to Clipboard Toggle word wrap

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Eventing。
• 已安装 Knative (kn) CLI。

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Eventing。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。
• 已安装 OpenShift CLI(oc)。
• 已安装 Knative (kn) CLI。

• 要在网页浏览器中查看事件，请使用以下命令返回的链接：

  $ kn service describe event-display -o url

  Copy to Clipboard Toggle word wrap

  图 4.1. 浏览器页面示例

  

  View larger image

  

• 另外，要在终端中查看日志，请输入以下命令来查看 pod 的 event-display 日志：

  $ oc logs $(oc get pod -o name | grep event-display) -c user-container

  Copy to Clipboard Toggle word wrap

  输出示例

  ☁️  cloudevents.Event
  Validation: valid
  Context Attributes,
    specversion: 1.0
    type: dev.knative.apiserver.resource.update
    datacontenttype: application/json
    ...
  Data,
    {
      "apiVersion": "v1",
      "involvedObject": {
        "apiVersion": "v1",
        "fieldPath": "spec.containers{event-origin}",
        "kind": "Pod",
        "name": "event-origin",
        "namespace": "default",
         .....
      },
      "kind": "Event",
      "message": "Started container",
      "metadata": {
        "name": "event-origin.159d7608e3a3572c",
        "namespace": "default",
        ....
      },
      "reason": "Started",
      ...
    }

  Copy to Clipboard Toggle word wrap

先决条件

• 在集群中安装了 OpenShift Serverless Operator、Knative Serving 和 Knative Eventing。
• 已安装 Knative (kn) CLI。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。
• 可选： 如果要使用此流程验证步骤，请安装 OpenShift CLI (oc) 。

删除 ping 源

• 删除 ping 源：

  $ kn delete pingsources.sources.knative.dev <ping_source_name>

  Copy to Clipboard Toggle word wrap

先决条件

• OpenShift Serverless Operator、Knative Eventing、Knative Serving 和 KnativeKafka 自定义资源（CR）已安装在集群中。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。
• 您可以访问 Red Hat AMQ Streams（Kafka）集群，该集群会生成您要导入的 Kafka 信息。
• 已安装 Knative (kn) CLI。
• 可选：如果您想要使用此流程中的验证步骤，已安装 OpenShift CLI (oc)。

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。
• 已安装 Knative (kn) CLI。

流程

• 创建功能项目：

  $ kn func create -r <repository> -l <runtime> -t <template> <path>

  Copy to Clipboard Toggle word wrap
  • 可接受的运行时值包括 quarkus、node、typescript、go、python、springboot 和 rust。

  • 可接受的模板值包括 http 和 cloudevents。

    示例命令

    $ kn func create -l typescript -t cloudevents examplefunc

    Copy to Clipboard Toggle word wrap

    输出示例

    Created typescript function in /home/user/demo/examplefunc

    Copy to Clipboard Toggle word wrap

  • 或者，您可以指定包含自定义模板的存储库。

    示例命令

    $ kn func create -r https://github.com/boson-project/templates/ -l node -t hello-world examplefunc

    Copy to Clipboard Toggle word wrap

    输出示例

    Created node function in /home/user/demo/examplefunc

    Copy to Clipboard Toggle word wrap

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。
• 已安装 Knative (kn) CLI。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。
• 您必须已创建并初始化要部署的功能。

流程

• 部署功能：

  $ kn func deploy [-n <namespace> -p <path> -i <image>]

  Copy to Clipboard Toggle word wrap

  输出示例

  Function deployed at: http://func.example.com

  Copy to Clipboard Toggle word wrap

  • 如果没有指定 namespace，则该函数部署到当前命名空间中。
  • 此函数从当前目录中部署，除非指定了 path。
  • Knative 服务名称派生自项目名称，无法使用此命令进行更改。

流程

• 列出现有功能：

  $ kn func list [-n <namespace> -p <path>]

  Copy to Clipboard Toggle word wrap

  输出示例

  NAME           NAMESPACE  RUNTIME  URL                                                                                      READY
  example-function  default    node     http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com  True

  Copy to Clipboard Toggle word wrap

• 列出部署为 Knative 服务的功能：

  $ kn service list -n <namespace>

  Copy to Clipboard Toggle word wrap

  输出示例

  NAME            URL                                                                                       LATEST                AGE   CONDITIONS   READY   REASON
  example-function   http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com   example-function-gzl4c   16m   3 OK / 3     True

  Copy to Clipboard Toggle word wrap

流程

• 描述函数：

  $ kn func info [-f <format> -n <namespace> -p <path>]

  Copy to Clipboard Toggle word wrap

  示例命令

  $ kn func info -p function/example-function

  Copy to Clipboard Toggle word wrap

  输出示例

  Function name:
    example-function
  Function is built in image:
    docker.io/user/example-function:latest
  Function is deployed as Knative Service:
    example-function
  Function is deployed in namespace:
    default
  Routes:
    http://example-function.default.apps.ci-ln-g9f36hb-d5d6b.origin-ci-int-aws.dev.rhcloud.com

  Copy to Clipboard Toggle word wrap

先决条件

• 在集群中安装了 OpenShift Serverless Operator 和 Knative Serving。
• 已安装 Knative (kn) CLI。
• 您已创建了一个项目，或者具有适当的角色和权限访问项目，以便在 OpenShift Container Platform 中创建应用程序和其他工作负载。
• 您必须已部署了要调用的功能。

流程

• 调用函数：

  $ kn func invoke

  Copy to Clipboard Toggle word wrap
  • kn func invoke 命令仅在当前运行本地容器镜像时或在集群中部署功能时才有效。
  • kn func invoke 命令默认在本地目录上执行，并假定此目录是一个功能项目。

流程

• 删除函数：

  $ kn func delete [<function_name> -n <namespace> -p <path>]

  Copy to Clipboard Toggle word wrap
  • 如果没有指定要删除的功能的名称或路径，则会搜索当前目录以查找用于决定要删除的功能的 func.yaml 文件。
  • 如果没有指定命名空间，则默认为 func.yaml 文件中的 namespace 值。