4.7. 为 Knative 服务配置自定义域

流程

1. 在与您要映射的目标 CR 相同的命名空间中创建一个包含 DomainMapping CR 的 YAML 文件：

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: <domain_name> 1
    namespace: <namespace> 2
   spec:
    ref:
      name: <target_name> 3
      kind: <target_type> 4
      apiVersion: serving.knative.dev/v1

   1

   要映射到目标 CR 的自定义域名。

   2

   DomainMapping CR 和目标 CR 的命名空间。

   3

   映射到自定义域的目标 CR 名称。

   4

   映射到自定义域的 CR 类型。

   服务域映射示例

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: example-domain
    namespace: default
   spec:
    ref:
      name: example-service
      kind: Service
      apiVersion: serving.knative.dev/v1

   路由域映射示例

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: example-domain
    namespace: default
   spec:
    ref:
      name: example-route
      kind: Route
      apiVersion: serving.knative.dev/v1

2. 将 DomainMapping CR 应用为 YAML 文件：

   $ oc apply -f <filename>

流程

1. 导航到 Topology 页面。
2. 右键单击要映射到某个域的服务，然后选择包含服务名称的 Edit 选项。例如，如果该服务命名为 example-service，请选择 Edit example-service 选项。

3. 在 Advanced options 部分中，点 Show advanced Routing options。

   1. 如果要映射到该服务的域映射 CR 已存在，您可以在域映射列表中选择。
   2. 如果要创建新域映射 CR，在框中输入域名，然后选择 Create 选项。例如，如果您在 example.com 中 键入，则 Create 选项为 Create "example.com"。
4. 单击 Save，将更改保存到您的服务。

验证

1. 导航到 Topology 页面。
2. 单击您创建的服务。
3. 在服务信息窗口的 Resources 选项卡中，您可以看到您映射到域映射中列出的服务的域。

流程

1. 导航到 CustomResourceDefinitions，并使用搜索框查找 DomainMapping 自定义资源定义 (CRD) 。
2. 点 DomainMapping CRD，然后导航到 Instances 选项卡。
3. 单击 Create DomainMapping。

4. 修改 DomainMapping CR 的 YAML，使其为您的实例包含以下信息：

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: <domain_name> 1
    namespace: <namespace> 2
   spec:
    ref:
      name: <target_name> 3
      kind: <target_type> 4
      apiVersion: serving.knative.dev/v1

   1

   要映射到目标 CR 的自定义域名。

   2

   DomainMapping CR 和目标 CR 的命名空间。

   3

   映射到自定义域的目标 CR 名称。

   4

   映射到自定义域的 CR 类型。

   到 Knative 服务的域映射示例

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: custom-ksvc-domain.example.com
    namespace: default
   spec:
    ref:
      name: example-service
      kind: Service
      apiVersion: serving.knative.dev/v1

流程

1. 创建 Kubernetes TLS secret：

   $ oc create secret tls <tls_secret_name> --cert=<path_to_certificate_file> --key=<path_to_key_file>

2. 如果您使用 Red Hat OpenShift Service Mesh 作为 OpenShift Serverless 安装的 ingress，请使用以下内容标记 Kubernetes TLS secret：

   “networking.internal.knative.dev/certificate-uid": “<value>”

   如果使用第三方 secret 供应商（如 cert-manager），您可以配置 secret manager 来自动标记 Kubernetes TLS secret。cert-manager 用户可以使用提供的 secret 模板自动生成带有正确标签的 secret。在本例中，secret 过滤仅基于键，但这个值可以存储有用的信息，如 secret 包含的证书 ID。

   注意

   {cert-manager-operator} 是一个技术预览功能。如需更多信息，请参阅安装 {cert-manager-operator} 文档。

3. 更新 DomainMapping CR，以使用您创建的 TLS secret：

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
     name: <domain_name>
     namespace: <namespace>
   spec:
     ref:
       name: <service_name>
       kind: Service
       apiVersion: serving.knative.dev/v1
   # TLS block specifies the secret to be used
     tls:
       secretName: <tls_secret_name>

验证

1. 验证 DomainMapping CR 状态是否为 True，输出中的 URL 列显示了使用 scheme https 的映射域：

   $ oc get domainmapping <domain_name>

   输出示例

   NAME                      URL                               READY   REASON
   example.com               https://example.com               True

2. 可选： 如果服务公开，请运行以下命令验证该服务是否可用：

   $ curl https://<domain_name>

   如果证书是自签名的，请通过在 curl 命令中添加 -k 标志来跳过验证。