クラスタ・アドオンとしてのIstioの作業

この例では、Container Engine for Kubernetesで作成したクラスタにIstioアドオンおよびIstioイングレス・ゲートウェイをインストールします。Istioアドオンおよびイングレス・ゲートウェイをインストールしたら、IstioのサンプルBookinfoアプリケーションをデプロイし、クラスタ外からアプリケーションにアクセスできるようにします。

1. 便宜上、次のように入力して、CLUSTER_IDという名前の環境変数をクラスタのOCIDの値に設定します。

   export CLUSTER_ID=<cluster-ocid>

2. 次のものを含むenableistio-ig.jsonという名前のJSONファイルを作成します。

   {
     "addonName": "Istio",
     "configurations": [
       {
         "key": "enableIngressGateway",
         "value": "true"
       }
     ]
   }

   この構成ファイルでは、IstioアドオンおよびIstioイングレス・ゲートウェイがインストールされます。

3. 次のように入力して、IstioアドオンおよびIstioイングレス・ゲートウェイをクラスタにインストールします:

   oci ce cluster install-addon --addon-name Istio --cluster-id $CLUSTER_ID --from-json file://./enableistio-ig.json

   Istioアドオンをインストールするための作業リクエストが作成されます。

4. IstionアドオンおよびIstioイングレス・ゲートウェイが正常にインストールされたことを確認します。
   1. 次のように入力して、Istioアドオンが正常にインストールされたことを確認します。

      oci ce cluster list-addons --cluster-id $CLUSTER_ID

      デプロイメントが成功すると、ACTIVEのライフサイクル状態を持つIstioアドオンが出力に表示されます。たとえば、次の出力は、いくつかの重要なクラスタ・アドオンとともに、Istioアドオンを示しています。

      {
        "data": [
          {
            "addon-error": null,
            "current-installed-version": "v1.10.1-multiarch-7",
            "lifecycle-state": "ACTIVE",
            "name": "CoreDNS",
            "time-created": "2023-11-06T10:35:26+00:00",
            "version": null
          },
          {
            "addon-error": null,
            "current-installed-version": "v1.19.0",
            "lifecycle-state": "ACTIVE",
            "name": "Istio",
            "time-created": "2023-11-06T11:21:11+00:00",
            "version": null
          },
          {
            "addon-error": null,
            "current-installed-version": "v1.27.2-oke.0.2.20-multiarch-98",
            "lifecycle-state": "ACTIVE",
            "name": "KubeProxy",
            "time-created": "2023-11-06T10:35:26+00:00",
            "version": null
          },
          {
            "addon-error": null,
            "current-installed-version": "v2.0.1",
            "lifecycle-state": "ACTIVE",
            "name": "OciVcnIpNative",
            "time-created": "2023-11-06T10:35:26+00:00",
            "version": null
          }
        ]
      }

   2. 次のように入力して、Istioコントロール プレーン(ピリオド)ポッドとistio-ingressgatewayポッドが両方ともistio-system名前空間で実行されていることを確認します。

      kubectl get pods -n istio-system

      デプロイメントが成功すると、出力にはステータスが「実行中」の両方のポッドが表示されます。例:

      NAME                                   READY   STATUS    RESTARTS   AGE
      istio-ingressgateway-df7d86548-n2vxr   1/1     Running   0          102s
      istiod-65d95bd5f9-vb2qk                1/1     Running   0          101s

   3. 次のように入力して、istio-ingressgatewayサービスが正常にデプロイされたことを確認します:

      kubectl get svc istio-ingressgateway -n istio-system

      デプロイメントが成功すると、出力には、タイプがLoadBalancerのサービスとしてのistio-ingressgatewayサービス、およびパブリックにアクセス可能なIPアドレスを持つ(クラスタのロード・バランサ・サブネットがパブリックの場合)が表示されます。例:

      NAME                   TYPE           CLUSTER-IP     EXTERNAL-IP      PORT(S)                                      AGE
      istio-ingressgateway   LoadBalancer   10.96.31.174   <EXTERNAL-IP>    15021:30089/TCP,80:31662/TCP,443:32217/TCP   2m50s

5. Bookinfoサンプル・アプリケーションをデプロイする新しいネームスペースを作成します。
   1. 次のように入力して、bookinfoネームスペースを作成します。

      kubectl create namespace bookinfo

   2. 次のように入力して、bookinfoネームスペースをデフォルト・ネームスペースにします。

      kubectl config set-context --current --namespace=bookinfo

   3. 次のように入力して、bookinfoがデフォルトのネームスペースであることを確認します。

      kubectl config view --minify | grep namespace

6. istio-injection=enabledラベルをbookinfoネームスペースに追加して、ネームスペースにデプロイされた新しいアプリケーション・ポッドにEnvoyサイドカーを自動的にインストールします。
   1. 次のように入力して、ラベルをbookinfoネームスペースに追加します。

      kubectl label namespace bookinfo istio-injection=enabled

   2. 次のように入力して、bookinfo名前空間が正しくラベル付けされていることを確認します。

      kubectl get namespace -L istio-injection

7. 次のように入力してBookinfoサンプル・アプリケーションをデプロイします:

   kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/platform/kube/bookinfo.yaml

   デプロイメントが成功すると、出力には、次のようにクラスタ上に作成された複数のデプロイメントおよびサービスが表示されます。

   service/details created
   serviceaccount/bookinfo-details created
   deployment.apps/details-v1 created
   service/ratings created
   serviceaccount/bookinfo-ratings created
   deployment.apps/ratings-v1 created
   service/reviews created
   serviceaccount/bookinfo-reviews created
   deployment.apps/reviews-v1 created
   deployment.apps/reviews-v2 created
   deployment.apps/reviews-v3 created
   service/productpage created
   serviceaccount/bookinfo-productpage created
   deployment.apps/productpage-v1 created

8. Bookinfoサンプル・アプリケーションの正常なデプロイメントを確認します。
   1. 次のように入力して、サービスが正常に作成されたことを確認します。

      kubectl get services

      デプロイメントが成功すると、出力には、次のようなクラスタで作成されたサービスが表示されます。

      NAME          TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
      details       ClusterIP   10.96.72.219   <none>        9080/TCP   54s
      productpage   ClusterIP   10.96.65.83    <none>        9080/TCP   54s
      ratings       ClusterIP   10.96.101.51   <none>        9080/TCP   54s
      reviews       ClusterIP   10.96.14.9     <none>        9080/TCP   54s

   2. 次のように入力して、すべてのポッドのステータスが「Running」であることを確認します。

      kubectl get pods

      デプロイメントが成功すると、出力には、次のような実行中のポッドが表示されます。

      NAME                             READY   STATUS    RESTARTS   AGE
      details-v1-5f4d584748-hcm9t      2/2     Running   0          81s
      productpage-v1-564d4686f-48lpw   2/2     Running   0          80s
      ratings-v1-686ccfb5d8-bpl8t      2/2     Running   0          81s
      reviews-v1-86896b7648-6c8d4      2/2     Running   0          81s
      reviews-v2-b7dcd98fb-fsv7c       2/2     Running   0          81s
      reviews-v3-5c5cc7b6d-qgrv2       2/2     Running   0          81s

      出力は、各アプリケーション・ポッドに2つのコンテナがあることを示しています。ポッドごとに、1つのコンテナがアプリケーション・コンテナで、もう1つのコンテナがIstioによって注入されるEnvoyサイドカーです。

   3. ratingsポッドに2つのコンテナ(1つはアプリケーション・コンテナ、もう1つはIstioによって注入されるEnvoyサイドカー)があることを確認します。たとえば、次のように入力します:

      kubectl get pods ratings-v1-686ccfb5d8-bpl8t -o jsonpath='{.spec.containers[*].name}'

      出力には、アプリケーション・コンテナ(評価)とIstioによって注入されたEnvoyサイドカー・コンテナ(istio-proxy)の2つのコンテナが表示されます。

      ratings istio-proxy

   4. ポッドからcurlコマンドを送信して、アプリケーションが実行中であることを確認します。

      kubectl exec "$(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}')" -c ratings -- curl -sS productpage:9080/productpage | grep -o "<title>.*</title>"
      <title>Simple Bookstore App</title>

      Bookinfoサンプル・アプリケーションは、イングレス・ゲートウェイを有効にした後でも、クラスタの外部からまだアクセスできないことに注意してください。また、Istioイングレス・ゲートウェイのアクセシビリティは、クラスタに指定されたロード・バランサ・サブネット(パブリックまたはプライベート)のタイプによって異なります。

9. クラスタの外部からBookinfoサンプル・アプリケーションにアクセスできるようにします。

   1. 次のように入力して、サンプル・デプロイメントのイングレスをIstioイングレス・ゲートウェイにマップします:

      kubectl apply -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/networking/bookinfo-gateway.yaml

      出力は、Kubernetes GatewayおよびVirtualServiceリソースが作成されたことを示しています:

      gateway.networking.istio.io/bookinfo-gateway created
      virtualservice.networking.istio.io/bookinfo created

10. Bookinfoサンプル・アプリケーションにアクセス可能で、Istioイングレス・ゲートウェイを使用していることを確認します。
    1. 次のように入力して、イングレス・ホストおよびイングレス・ポートの環境変数を設定します:

       export INGRESS_NAME=istio-ingressgateway

       export INGRESS_NS=istio-system

       export INGRESS_HOST=$(kubectl -n "$INGRESS_NS" get service "$INGRESS_NAME" -o jsonpath='{.status.loadBalancer.ingress[0].ip}')

       export INGRESS_PORT=$(kubectl -n "$INGRESS_NS" get service "$INGRESS_NAME" -o jsonpath='{.spec.ports[?(@.name=="http2")].port}')

    2. 次のように入力して、Bookinfoサンプル・アプリケーションにアクセスでき、Istioイングレス・ゲートウェイを使用していることを確認します:

       curl -s "http://${INGRESS_HOST}:${INGRESS_PORT}/productpage" | grep -o "<title>.*</title>"

       デプロイメントが成功すると、出力には、次のようなクラスタで作成されたサービスが表示されます。

       <title>Simple Bookstore App</title>

    3. 次のURLを開いて、ブラウザでBookinfo Webページを表示します。

       http://${INGRESS_HOST}:${INGRESS_PORT}/productpage

    4. ブラウザで、Bookinfo Webページを数回リフレッシュして、ページに表示されるレビューの異なるバージョンを表示します。
11. (オプション)例を完了したら、作成したリソースを削除できるようになりました。
    1. 次を入力して、Bookinfoサンプル・アプリケーションを削除します:

       kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/platform/kube/bookinfo.yaml

    2. 次のように入力して、oci ce cluster disable-addonコマンドを使用してIstioアドオンを無効化(およびオプションで削除)します:

       oci ce cluster disable-addon --addon-name Istio --cluster-id $CLUSTER_ID --is-remove-existing-add-on <true|false>

       ここで、--is-remove-existing-add-on <true|false>は、Istioアドオンを完全に削除するか(trueに設定されている場合)、アドオンを削除せず、単に無効にして使用しないか(falseに設定されている場合)を指定します。アドオンを無効にすると、新しいバージョンが利用可能になった時点で Oracleはアドオンのバージョンを自動的に更新しなくなります。

       例:

       oci ce cluster disable-addon --addon-name Istio --cluster-id $CLUSTER_ID --is-remove-existing-add-on true

       Istioアドオンを無効化(およびオプションで削除)するための作業リクエストが作成されます。

    3. 次のように入力して、デフォルトで削除されないIstio CustomResourceDefinitions (CRD)を削除します。

       kubectl delete crd $(kubectl get crd -A | grep "istio.io" | awk '{print $1}')

    4. 次のように入力して、Istioアドオンによって管理されていないIstioメッシュ・リソース(Kubernetes GatewayやVirtualServiceリソースなど)を削除します。

       kubectl delete -f https://raw.githubusercontent.com/istio/istio/release-1.19/samples/bookinfo/networking/bookinfo-gateway.yaml