10.3. Knative サービスのカスタムドメインの設定

手順

1. マップ先となるターゲット CR と同じ namespace に 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

   Copy to Clipboard Toggle word wrap

   1

   ターゲット CR にマップするカスタムドメイン名。

   2

   DomainMapping CR とターゲット CR の両方の namespace。

   3

   カスタムドメインにマップするサービス名。

   4

   カスタムドメインにマップされる CR のタイプ。

   サービスドメインマッピングの例

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

   Copy to Clipboard Toggle word wrap

   ルートドメインマッピングの例

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

   Copy to Clipboard Toggle word wrap

2. DomainMapping CR を YAML ファイルとして適用します。

   $ oc apply -f <filename>

   Copy to Clipboard Toggle word wrap

手順

1. Kubernetes TLS シークレットを作成します。

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

   Copy to Clipboard Toggle word wrap

2. Red Hat OpenShift Service Mesh を OpenShift Serverless インストールのイングレスとして使用している場合は、Kubernetes TLS シークレットに次のラベルを付けます。

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

   Copy to Clipboard Toggle word wrap

   cert-manager などのサードパーティーのシークレットプロバイダーを使用している場合は、Kubernetes TLS シークレットに自動的にラベルを付けるようにシークレットマネージャーを設定できます。Cert-manager ユーザーは、提供されたシークレットテンプレートを使用して、正しいラベルを持つシークレットを自動的に生成できます。この場合、シークレットのフィルターリングはキーのみに基づいて行われますが、この値には、シークレットに含まれる証明書 ID などの有用な情報が含まれている可能性があります。

   注記

   {cert-manager-operator} はテクノロジープレビュー機能です。詳細は、{cert-manager-operator} のインストール に関するドキュメントを参照してください。

3. 作成した TLS シークレットを使用するように DomainMapping CR を更新します。

   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>

   Copy to Clipboard Toggle word wrap

検証

1. DomainMapping CR のステータスが True であることを確認し、出力の URL 列に、マップされたドメインをスキームの https で表示していることを確認します。

   $ oc get domainmapping <domain_name>

   Copy to Clipboard Toggle word wrap

   出力例

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

   Copy to Clipboard Toggle word wrap

2. オプション: サービスが公開されている場合は、以下のコマンドを実行してこれが利用可能であることを確認します。

   $ curl https://<domain_name>

   Copy to Clipboard Toggle word wrap

   証明書が自己署名されている場合は、curl コマンドに -k フラグを追加して検証を省略します。