全部产品
Search
文档中心

容器服务 Kubernetes 版 ACK:在Knative中使用Kourier网关

更新时间:Nov 01, 2024

Kourier是一个基于Envoy架构实现的轻量级网关,是Knative社区提供的开源网关实现,提供Knative Revisions流量分发,支持gRPC服务、超时和重试、TLS证书和外部认证授权等功能。

前提条件

已在集群中部署Knative,请参见部署Knative

步骤一:部署Kourier网关

  1. 登录容器服务管理控制台,在左侧导航栏选择集群

  2. 集群列表页面,单击目标集群名称,然后在左侧导航栏,选择应用 > Knative

  3. 组件管理页签的add-on组件区域,单击Kourier右侧操作列下的部署,然后在弹出框单击确定

    Kourier状态显示为已部署,表示部署成功。

步骤二:通过Kouier网关访问服务

本小节将创建一个helloworld-go服务,展示如何通过Kouier网关访问HTTP或HTTPS服务。

访问HTTP服务

  1. 登录容器服务管理控制台,在左侧导航栏选择集群

  2. 集群列表页面,单击目标集群名称,然后在左侧导航栏,选择应用 > Knative

  3. Knative页面的服务管理页签下,选择命名空间default,然后单击使用模板创建,将以下YAML示例粘贴至模板,最后单击创建

    创建一个名为helloworld-go的服务。

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: helloworld-go
    spec:
      template:
        spec:
          containers:
          - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:73fbdd56
            env:
            - name: TARGET
              value: "Knative"

    若目标服务的状态列显示成功,表明服务已部署成功。

  4. 服务管理页面的默认域名访问网关列,分别获取helloworld-go服务的域名和网关地址。

  5. 执行以下命令,访问helloworld-go服务。

    curl -H "host: helloworld-go.default.example.com" http://8.141.XX.XX # 网关IP和域名请以您的实际数据为准。

    预期输出:

    Hello Knative!

    预期输表明,访问HTTP服务成功。

访问HTTPS服务

  1. 登录容器服务管理控制台,在左侧导航栏选择集群

  2. 集群列表页面,单击目标集群名称,然后在左侧导航栏,选择应用 > Knative

  3. Knative页面的服务管理页签下,选择命名空间default,然后单击使用模板创建,将以下YAML示例粘贴至模板,最后单击创建

    创建一个名为helloworld-go的服务。

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: helloworld-go
    spec:
      template:
        spec:
          containers:
          - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:73fbdd56
            env:
            - name: TARGET
              value: "Knative"

    若目标服务的状态列显示成功,表明服务已部署成功。

  4. 创建证书。

    1. 执行以下命令,生成TLS证书。

      openssl genrsa -out tls.key 4096
      openssl req -subj "/CN=*.example.com/L=*.example.com" -sha256  -new -key tls.key -out tls.csr
      echo subjectAltName = DNS:helloworld-go.default.example.com,DNS:helloworld-go.default.example.cn > extfile.cnf
      openssl x509 -req -days 3650 -sha256 -in tls.csr -signkey tls.key -out tls.crt -extfile extfile.cnf
    2. 执行以下命令,根据生成的TLS证书文件创建集群的Secret。

      kubectl -n knative-serving create secret tls kourier-cert --key tls.key --cert tls.crt
  5. 执行以下命令,查看knative-serving命名空间下是否存在名为net-kourier-controller的Deployment。

    kubectl get deployments -n knative-serving
  6. 执行以下命令,配置证书信息。

    kubectl -n knative-serving edit deployment net-kourier-controller

    net-kourier-controller配置信息页面,为如下参数添加Value值。

    • CERTS_SECRET_NAMESPACE:添加证书Secret所在的命名空间。

    • CERTS_SECRET_NAME:添加证书Secret名称。

    ...
       spec:
          containers:
          - env:
            - name: CERTS_SECRET_NAMESPACE
              value: knative-serving 
            - name: CERTS_SECRET_NAME
              value: kourier-cert
    ...

    配置完成后,您可以执行以下命令,查看net-kourier-controller的状态。

    kubectl -n knative-serving get po

    预期输出:

    NAME                               READY   STATUS    RESTARTS   AGE
    net-kourier-controller-******   1/1     Running   0          10s
  7. 执行以下命令,通过证书访问HTTPS服务。

    curl -H "host: helloworld-go.default.example.com" -k --cert tls.crt --key tls.key //8.141.XX.XX # 网关IP和域名请以您的实际数据为准。

    预期输出:

    Hello Knative!

    预期输出表明,访问HTTPS服务成功。

(可选)步骤三:查看服务监控数据

Knative提供开箱即用的可观测能力,在Knative页面,单击监控大盘页签,即可查看目标Knative服务的监控数据情况。如何开启Knative监控大盘,请参见查看Knative服务监控大盘

相关文档