Knative serving の設定

Knative serving のインストール方法と構成方法について説明します。

始める前に

GKE クラスタに Knative serving がインストールされている必要があります。GKE クラスタの前提条件と Knative serving のインストール方法の詳細については、インストールガイドをご覧ください。

Workload Identity による認証の設定

Workload Identity を使用して、Knative serving サービスを Google Cloud APIs とサービスに対して認証できます。サービスをクラスタにデプロイする前に、Workload Identity を設定する必要があります。それ以外の場合は、Workload Identity を有効にする前にクラスタに存在する各サービスを移行する必要があります。Workload Identity の使用方法について詳細をご覧ください。

Workload Identity での指標の有効化

Google Cloud Observability へのリクエスト数やリクエストのレイテンシなどの指標を有効にするには、Cloud Monitoring の書き込み権限を手動で設定する必要があります。詳細については、Workload Identity での指標の有効化をご覧ください。

HTTPS とカスタムドメインの構成

HTTPS を有効にしてカスタムドメインを設定するには、以下のページをご覧ください。

Cloud Service Mesh の設定

Knative serving 用の Cloud Service Mesh オプションを構成するには、プライベートな内部ネットワークの設定方法などのクラスタ内コントロールプレーンのオプションをご覧ください。

プライベートな内部ネットワークの設定

内部ネットワークでのサービスのデプロイは、社内用アプリをスタッフに提供する企業や、Knative serving クラスタの外部で実行されるクライアントが使用するサービスにおいて便利です。この構成により、ネットワーク内の他のリソースが、一般からはアクセスできないプライベートな内部 IP アドレス（RFC 1918）を使用するサービスと通信できるようになります。

内部ネットワークを作成するには、公開されている外部ネットワークロードバランサではなく、内部 TCP / UDP ロードバランシングを使用するように Cloud Service Mesh を構成します。これにより、VPC ネットワークの内部 IP アドレスに Knative serving サービスをデプロイできます。

始める前に

クラスタで admin 権限が必要です。
カスタムドメインを構成した場合、現在、Knative serving でのマネージド TLS は内部ロードバランサでサポートされていないため、マネージド TLS 機能を無効にする必要があります。
サポートされているのは、Google Cloud CLI バージョン 310.0 以降のみです。コマンドラインツールの設定の詳細については、以下をご覧ください。
- Google Cloud 上の GKE クラスタ
- Google Cloud 外の GKE クラスタ

内部ロードバランサをセットアップするには:

Cloud Service Mesh の内部ロードバランサ機能を有効にします。

内部ロードバランサは、Cloud Service Mesh をインストールする際に構成するか、既存のインストールを更新することで構成できるオプション機能です。

クラスタ内コントロールプレーンでオプション機能を有効にするの手順に沿って、--option internal-load-balancer スクリプトオプションが含まれていることを確認してください。

--option internal-load-balancer オプションを指定すると、スクリプトによって GitHub から内部ロードバランサの有効化カスタムリソースが自動的に取得されます。カスタムリソースを変更する必要がある場合は、代わりに --custom_overlay オプションの使用手順に沿って操作してください。
次のコマンドを実行して、GKE クラスタの更新を確認します。
```
kubectl -n INGRESS_NAMESPACE get svc istio-ingressgateway --watch
```
INGRESS_NAMESPACE は、Cloud Service Mesh Ingress サービスの Namespace に置き換えます。Cloud Service Mesh をデフォルトの構成を使用してインストールした場合は、istio-system を指定します。
1. アノテーション cloud.google.com/load-balancer-type: Internal を確認します。
2. Ingress ロードバランサで IP の値を探して、プライベート IP アドレスに変更します。
3. IP フィールドにプライベート IP アドレスが表示されたら、Ctrl+C を押して更新を停止します。
Google Cloud の限定公開クラスタの場合は、ポートを開く必要があります。詳細については、Cloud Service Mesh ドキュメントの限定公開クラスタでポートを開くをご覧ください。

変更後の内部接続を確認するには:

sample というサービスを default Namespace の Knative serving にデプロイします。

gcloud run deploy sample \
--image gcr.io/knative-samples/helloworld \
--namespace default
--platform gke

Compute Engine 仮想マシン（VM）を、GKE クラスタと同じゾーンに作成します。
```
VM=cloudrun-gke-ilb-tutorial-vm

gcloud compute instances create $VM
```
Istio Ingress ゲートウェイのプライベート IP アドレスを EXTERNAL_IP 環境変数と external-ip.txt ファイルに保存します。
```
export EXTERNAL_IP=$(kubectl -n INGRESS_NAMESPACE get svc istio-ingressgateway \
    -o jsonpath='{.status.loadBalancer.ingress[0].ip}' | tee external-ip.txt)
```
INGRESS_NAMESPACE は、Cloud Service Mesh Ingress サービスの Namespace に置き換えます。Cloud Service Mesh をデフォルトの構成を使用してインストールした場合は、istio-system を指定します。
IP アドレスを含むファイルを VM にコピーします。
```
gcloud compute scp external-ip.txt $VM:~
```
SSH を使用して VM に接続します。
```
gcloud compute ssh $VM
```
SSH セッション中に、サンプルサービスをテストします。
```
curl -s -w'\n' -H Host:sample.default.nip.io $(cat external-ip.txt)
```
出力は次のとおりです。
```
Hello World!
```
SSH セッションを終了します。
```
exit
```

マルチテナント環境の設定

マルチテナントのユースケースでは、現在のプロジェクトの外部にある Google Kubernetes Engine クラスタへの Namespace サービスを管理してデプロイする必要があります。GKE マルチテナンシーの詳細については、クラスタマルチテナンシーをご覧ください。

Knative serving 用にマルチテナンシーを構成する方法については、プロジェクト間マルチテナンシーをご覧ください。