/etc/sysctl.d/99-elasticsearch.conf という名前のファイルを以下の内容で作成します。

vm.max_map_count = 262144

以下のコマンドを実行します。

$ sysctl vm.max_map_count=262144

以下のコマンドを実行します。

$ docker login registry.redhat.io

正常にログインすると、~/.docker/config.json は以下の内容で作成されます。

{
     "auths": {
         "registry.redhat.io": {
             "auth": "XXXXXXXXXXXXXXXXXX"
         }
     }
}

以下のコマンドを実行して、Operator が正常にインストールされていることを確認します。

$ oc get pods -n istio-operator

Operator が実行状態になると、これが正常にインストールされていることになります。

NAME                              READY     STATUS    RESTARTS   AGE
istio-operator-5cd6bcf645-fvb57   1/1       Running   0          1h

以下のコマンドを実行して、現在の Mixer ポリシー適用のステータスを確認します。

$ oc get cm -n istio-system istio -o jsonpath='{.data.mesh}' | grep disablePolicyChecks

disablePolicyChecks: true の場合、Service Mesh ConfigMap を編集します。

$ oc edit cm -n istio-system istio

以下のコマンドを実行してコントロールプレーンをデプロイします。

$ oc create -n istio-system -f istio-installation.yaml

以下のコマンドを実行して、インストールプロセス時に Pod の進捗を確認します。

$ oc get pods -n istio-system -w

namespaces を ServiceMeshMemberRoll のメンバー一覧に追加します。この例では、bookinfo namespace はサービスメッシュに結合されます。

  apiVersion: maistra.io/v1
  kind: ServiceMeshMemberRoll
  metadata:
    name: default
  spec:
    members:
    # a list of namespaces joined into the service mesh
    - bookinfo

SCC の変更を必要とするサービスアカウントを特定します。

関連するサイドカーコンテナーに anyuid SCC を必要とするそれぞれのサービスアカウントについて、このコマンドを実行します。

$ oc adm policy add-scc-to-user anyuid -z <service account> -n <namespace>

特権付き SCC が必要な各サービスアカウントについてこのコマンドを実行し、その Pod のネットワーク設定に対して更新を正常に実行できるようにします。

$ oc adm policy add-scc-to-user privileged -z <service account> -n <namespace>

以下の内容を含む master-config.patch という名前のファイルを作成します。

admissionConfig:
  pluginConfig:
    MutatingAdmissionWebhook:
      configuration:
        apiVersion: apiserver.config.k8s.io/v1alpha1
        kubeConfigFile: /dev/null
        kind: WebhookAdmission
    ValidatingAdmissionWebhook:
      configuration:
        apiVersion: apiserver.config.k8s.io/v1alpha1
        kubeConfigFile: /dev/null
        kind: WebhookAdmission

同じディレクトリーで以下のコマンドを実行し、master-config.yaml ファイルにパッチを適用します。

$ cp -p master-config.yaml master-config.yaml.prepatch
$ oc ex config patch master-config.yaml.prepatch -p "$(cat master-config.patch)" > master-config.yaml
$ /usr/local/bin/master-restart api && /usr/local/bin/master-restart controllers

Bookinfo アプリケーションのプロジェクトを作成します。

$ oc new-project myproject

Bookinfo で使用されるサービスアカウントを "myproject" namespace の anyuid および 特権付き SCC に追加して SCC (Security Context Constraints) を更新します。

$ oc adm policy add-scc-to-user anyuid -z default -n myproject
$ oc adm policy add-scc-to-user privileged -z default -n myproject

bookinfo.yaml ファイルを適用して Bookinfo アプリケーションを "myproject" namespace でデプロイします。

$ oc apply -n myproject -f https://raw.githubusercontent.com/Maistra/bookinfo/master/bookinfo.yaml

bookinfo-gateway.yaml ファイルを適用して Bookinfo の ingress ゲートウェイを作成します。

  $ oc apply -n myproject -f https://raw.githubusercontent.com/Maistra/bookinfo/master/bookinfo-gateway.yaml

GATEWAY_URL パラメーターの値を設定します。

$ export GATEWAY_URL=$(oc get route -n istio-system istio-ingressgateway -o jsonpath='{.spec.host}')

相互 TLS を有効にしていない場合:

$ oc apply -n myproject -f https://raw.githubusercontent.com/istio/istio/release-1.1/samples/bookinfo/networking/destination-rule-all.yaml

相互 TLS を有効にしている場合:

oc apply -n myproject -f https://raw.githubusercontent.com/istio/istio/release-1.1/samples/bookinfo/networking/destination-rule-all-mtls.yaml

利用可能な宛先ルールを一覧表示するには、以下のコマンドを実行します。

$ oc get destinationrules -o yaml

クリーンアップスクリプトをダウンロードします。

$ curl -o cleanup.sh https://raw.githubusercontent.com/Maistra/bookinfo/master/cleanup.sh && chmod +x ./cleanup.sh

クリーンアップスクリプトを実行して Bookinfo 仮想サービス、ゲートウェイを削除し、Pod を終了します。

$ ./cleanup.sh
namespace ? [default] myproject

以下のコマンドを実行してシャットダウンを確認します。

$ oc get virtualservices -n myproject
No resources found.
$ oc get gateway -n myproject
No resources found.
$ oc get pods -n myproject
No resources found.

Jaeger ダッシュボードにアクセスするためのルートはすでに存在します。ルートの詳細についてクエリーします。

$ export JAEGER_URL=$(oc get route -n istio-system jaeger-query -o jsonpath='{.spec.host}')

Jaeger ダッシュボードの左側のペインで、サービスメニューから「productpage」を選択し、ペイン下部の Find Traces ボタンをクリックします。以下のイメージに示されているように、トレースの一覧が表示されます。

一覧のトレースのいずれかをクリックし、そのトレースの詳細ビューを開きます。最上部 (最新の) トレースをクリックすると、'/productpage の最終更新に対応する詳細が表示されます。

先の図のトレースは、一部のネストされたスパンで構成されており、各スパンは Bookinfo サービス呼び出しに対応し、すべてが '/productpage 要求の応答で実行されます。全体的な処理時間は 2.62s で、details サービスは 3.56ms、reviews サービスは 2.6s、ratings サービスは 5.32ms かかりました。リモートサービスへの各呼び出しは、それぞれクライアント側とサーバー側のスパンで表されます。たとえば、details クライアント側スパンには productpage details.myproject.svc.cluster.local:9080 というラベルが付けられます。その下にネスト化されるスパンには、details details.myproject.svc.cluster.local:9080 というラベルが付けられ、要求のサーバー側の処理に対応します。トレースは istio-policy への呼び出しも表示し、これには Istio による承認チェックが反映されます。

prometheus サービスがクラスターで実行されていることを確認します。Kubernetes 環境では、以下のコマンドを実行します。

$ oc get svc prometheus -n istio-system

以下のような出力が表示されます。

NAME         CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
prometheus   10.59.241.54   <none>        9090/TCP   2m

Bookinfo アプリケーションにアクセスしてネットワークトラフィックを生成します。

$ curl -o /dev/null http://$GATEWAY_URL/productpage

Prometheus ユーザーインターフェースにアクセスするためのルートはすでに存在しています。ルートの詳細についてクエリーします。

$ export PROMETHEUS_URL=$(oc get route -n istio-system prometheus -o jsonpath='{.spec.host}')

ブラウザーを起動し、http://${PROMETHEUS_URL} に移動します。以下の図のように Prometheus ホーム画面が表示されます。

Expression フィールドに istio_request_duration_seconds_countを入力し、Execute ボタンをクリックします。以下の図と同様の画面が表示されます。

利用可能なすべての Prometheus メトリクスを一覧表示するには、以下のコマンドを実行します。

$ oc get prometheus -n istio-system -o jsonpath='{.items[*].spec.metrics[*].name}' requests_total request_duration_seconds request_bytes response_bytes tcp_sent_bytes_total tcp_received_bytes_total

Kiali コンソールにアクセスするためのルートはすでに存在します。以下のコマンドを実行して、ルートおよび Kiali URL を取得します。

$ oc get routes

環境が若干異なる可能性がありますが、以下のような結果が表示されます。

NAME                   HOST/PORT                                                PATH      SERVICES               PORT              TERMINATION   WILDCARD
grafana                grafana-istio-system.127.0.0.1.nip.io                          grafana                http                            None
istio-ingress          istio-ingress-istio-system.127.0.0.1.nip.io                    istio-ingress          http                            None
istio-ingressgateway   istio-ingressgateway-istio-system.127.0.0.1.nip.io             istio-ingressgateway   http                            None
jaeger-query           jaeger-query-istio-system.127.0.0.1.nip.io                     jaeger-query           jaeger-query      edge          None
kiali                  kiali-istio-system.127.0.0.1.nip.io                            kiali                  <all>                           None
prometheus             prometheus-istio-system.127.0.0.1.nip.io                       prometheus             http-prometheus                 None
tracing                tracing-istio-system.127.0.0.1.nip.io                          tracing                tracing           edge          None

左側のナビゲーションにあるグラフをクリックします。

左下隅の Legend をクリックします。Kiali は、グラフの凡例を表示します。

reviews サービスをクリックし、そのアプリケーションの詳細を表示します。

ワークロードの詳細ページで、ワークロードに関連付けられた Pod とサービスの概要を表示できます。

Reviews サービスをクリックして、詳細情報を表示します。このサービスには 3 つの異なるバージョンがあることに注意してください。

Actions メニューをクリックします。ここから、以下の操作を実行できます。

必要に応じて、Namespace メニューから bookinfo を選択します。このページには、選択した namespace で実行されている設定の一覧と検証のステータスが表示されます。

設定ファイルに関する追加情報を表示するには、以下のいずれかの設定をクリックします。

Grafana ダッシュボードにアクセスするためのルートがすでに存在しています。ルートの詳細についてクエリーします。

  $ export GRAFANA_URL=$(oc get route -n istio-system grafana -o jsonpath='{.spec.host}')

ブラウザーを起動して、http://${GRAFANA_URL} に移動します。以下の図が示すように、Grafana のホーム画面が表示されます。

左上隅のメニューから、Istio Mesh Dashboard を選択し、 Istio メッシュメトリクスを表示します。

Bookinfo アプリケーションにアクセスして一部のトラフィックを生成します。

$ curl -o /dev/null http://$GATEWAY_URL/productpage

Dashboard は以下のようなメッシュを使用したトラフィックを反映します。

サービスの詳細なメトリクスを表示するには、Service 列でサービス名をクリックします。サービスダッシュボードは以下の図のようになります。

Bookinfo が http ベースのサービスのみを使用するので、TCP Bandwidth メトリクスは空であることに注意してください。また、ダッシュボードは、クライアントワークロードサービスを呼び出すワークロード、およびサービスワークロードからの要求を処理するワークロードについてのメトリクスを表示します。ダッシュボードの上部でメニューを使用して、別のサービスに切り替えるか、またはクライアントおよびサービスワークロードでメトリクスをフィルターできます。

ワークロードダッシュボードに切り替えるには、左上隅にあるメニューで Istio Workload Dashboard をクリックします。以下の図のような画面が表示されます。

このダッシュボードには、ワークロードのメトリクスとクライアント (インバウンド) およびサービス (アウトバウンド) ワークロードについてのメトリクスが表示されます。別のワークロードに切り替えることができます。インバウンドまたはアウトバウンドのワークロードでメトリクスをフィルターするには、ダッシュボードの上部にあるメニューを使用します。

以下のコマンドで、インストールされたカスタムリソースの名前を取得します。

oc get servicemeshcontrolplanes -n istio-system

<name_of_custom_resource> を先のコマンドの出力に置き換え、以下のコマンドを実行してカスタムリソースを削除します。

$ oc delete servicemeshcontrolplanes -n istio-system <name_of_custom_resource>

以下のコマンドを実行して istio-system プロジェクトを削除します。

$ oc delete project istio-system

以下のコマンドを実行して istio-operator プロジェクトを削除します。

$ oc delete project istio-operator

以下のコマンドを実行して kiali-operator プロジェクトを削除します。

$ oc delete project kiali-operator

以下のコマンドを実行して observability プロジェクトを削除します。

$ oc delete project observability