Container Service for Kubernetes:Knative でのカスタムドメイン名の使用

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

• クラスターに Knative がデプロイされていること。詳細については、「Knative のデプロイと管理」をご参照ください。

• 登録済みのドメイン名を保有していること。詳細については、「Alibaba Cloud DNS」をご参照ください。

• kubectl が接続されているクラスターのkubeconfig ファイル。詳細については、「kubectl を使用してクラスターに接続する」をご参照ください。

グローバルカスタムドメイン名の設定

config-domain ConfigMap を knative-serving 名前空間内で編集することで、すべての Knative サービスに同一のドメイン接尾辞を一度に適用できます。

1. ConfigMap を編集モードで開きます。

   kubectl edit cm config-domain --namespace knative-serving

2. example.com をご自身のドメイン名に置き換え、ファイルを保存して閉じます。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: config-domain
     namespace: knative-serving
   data:
     mydomain.com: "" # 実際のドメイン名に置き換えてください。

3. 変更が有効化されたことを確認します。

   # helloworld-go をご利用の Knative サービス名に置き換えてください。
   kubectl get route helloworld-go --output jsonpath="{.status.url}" | awk -F/ '{print $3}'

   期待される出力：

   helloworld-go.default.mydomain.com

4. カスタムドメイン名を Knative ゲートウェイの IP アドレスにマッピングする DNS レコードを追加します。

5. カスタムドメイン名を使用して Knative サービスにアクセスします。

   curl http://helloworld-go.default.mydomain.com

   期待される出力：

   Hello Knative!

単一サービス向けカスタムドメイン名の設定

特定の Knative サービスに専用のドメイン名をバインドするには、ACK コンソールまたは DomainMapping リソースを使用します。

単一サービス向けカスタムパスの設定

knative.aliyun.com/serving-ingress アノテーションを使用すると、カスタムドメイン上の特定パスへトラフィックをルーティングできます。たとえば、knative.aliyun.com/serving-ingress: cafe.mydomain.com/coffee は、/coffee パスへのトラフィックを cafe.mydomain.com にルーティングします。

複数のパスから同一サービスへトラフィックをルーティングする場合は、カンマでパスを区切ります。

単一パス：

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com/coffee
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

複数パス：

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com/coffee,cafe.mydomain.com/tea
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

パスの書き換え

Application Load Balancer (ALB) ゲートウェイはパスの書き換えをサポートしています。alb.ingress.kubernetes.io/rewrite-target アノテーションを knative.aliyun.com/serving-ingress と併用することで、トラフィックがサービスに到達する前に受信パスを書き換えることができます。

以下の例では、Ingress 上の /api/coffee からのトラフィックを、サービス上の /coffee へ書き換えます。

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: cafe.mydomain.com/api/coffee
    alb.ingress.kubernetes.io/rewrite-target: /coffee
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

ワイルドカードドメイン名の設定

カスタムドメイン下のすべてのサブドメインにマッチさせるには、knative.aliyun.com/serving-ingress アノテーションを / に設定します。

ワイルドカードドメイン名は ALB ゲートウェイでのみサポートされます。

apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: coffee-mydomain
  annotations:
    knative.aliyun.com/serving-ingress: "/"
spec:
  template:
    spec:
      containers:
      - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:160e4dc8

次のステップ

• カスタムドメイン名向け HTTPS 証明書の設定

• ネットワーク効率の向上のための Knative における gRPC サービスのデプロイ