Anthos Service Mesh と Traffic Director が統合され、Cloud Service Mesh になりました。詳細については、Cloud Service Mesh の概要をご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Bookinfo サンプルのデプロイ

このページでは、サンプルアプリケーションをデプロイし、Cloud Service Mesh のデモを行う方法について説明します。Cloud Service Mesh にオンボーディングしていない場合は、オンボーディングガイドをご覧ください。

Cloud Service Mesh をインストールすると、いくつかのサンプルアプリケーションがインストールされます。このガイドでは、BookInfo サンプルをデプロイする方法について説明します。これはシンプルな模擬ブックストアアプリケーションで、商品のウェブページ、書籍の詳細、レビュー（レビュー Service は複数のバージョンを使用）、評価を提供する 4 つの Service で構成されます。これらはすべて Cloud Service Mesh で管理されます。この例で使用されているソースコードなどのすべてのファイルは、samples/bookinfo の Cloud Service Mesh インストールディレクトリにあります。

サンプル画像のネットワークアクセス

asmcli ツールは、コアメッシュのインストール中に Docker Hub（docker.io）から何も確認したり、プルしたりしません。ただし、インストール後にサードパーティのコンテナイメージをデプロイすると、Kubelet が Docker Hub と Docker Hub のバックエンド Cloudflare CDN からサンプルアプリケーションイメージをフェッチします。

制限付きネットワークまたはエアギャップネットワークでは、明示的に対応しない限り、これらのイメージの pull は失敗します。

イメージの pull に対応するには、次のいずれかの方法を選択します。

下り（外向き）トラフィックを許可する

ファイアウォールまたはプロキシを更新して、次のドメインへの HTTPS（ポート 443）の下り（外向き）を許可します。Docker Hub は HTTP 307 リダイレクトを使用してイメージレイヤを配信するため、Cloudflare ドメインが必要です。
- docker.io
- hub.docker.com
- *.cloudflarestorage.com
プライベートレジストリにミラーリングする

完全に制限された環境では、ファイアウォールポートを開かないでください。代わりに、必要なサンプルイメージを内部レジストリにミラーリングし、内部レジストリを使用するようにクラスタを構成します。

GDC 環境でこれを設定する手順については、コンテナイメージにレジストリミラーを使用するをご覧ください。

自動サイドカーインジェクションを有効にする

インジェクションの名前空間を有効にします。手順は、コントロールプレーンの実装によって異なります。
マネージド（TD）
1. デフォルトのインジェクションラベルを名前空間に適用します。
kubectl label namespace default \ istio.io/rev- istio-injection=enabled --overwrite
マネージド（Istiod）
推奨: 次のコマンドを実行して、デフォルトのインジェクションラベルを名前空間に適用します。
kubectl label namespace default \ istio.io/rev- istio-injection=enabled --overwrite
マネージド Istiod コントロールプレーンを使用している既存のユーザーの場合: デフォルトのインジェクションを使用することをおすすめしますが、リビジョンベースのインジェクションもサポートされています。次の手順を行います。
1. 次のコマンドを実行して、利用可能なリリースチャンネルを探します。
  
  kubectl -n istio-system get controlplanerevision
  
  出力は次のようになります。
  
  NAME AGE asm-managed-rapid 6d7h
  
  注: 上記のリストに 2 つのコントロールプレーンのリビジョンが表示されている場合は、1 つを削除します。クラスタに複数のコントロールプレーンチャネルを配置することはできません。
  
  出力で、NAME 列の値は、Cloud Service Mesh バージョンで使用可能なリリースチャンネルに対応するリビジョンラベルです。
2. リビジョンラベルを名前空間に適用します。
  
  kubectl label namespace default \ istio-injection- istio.io/rev=REVISION_LABEL --overwrite
クラスタ内
推奨: 次のコマンドを実行して、デフォルトのインジェクションラベルを名前空間に適用します。
kubectl label namespace default \ istio.io/rev- istio-injection=enabled --overwrite
デフォルトのインジェクションを使用することをおすすめしますが、リビジョンベースのインジェクションもサポートされています。 次の手順で対応します。
1. 次のコマンドを使用して、istiod のリビジョンラベルを探します。
  
  kubectl get deploy -n istio-system -l app=istiod -o \ jsonpath={.items[*].metadata.labels.'istio\.io\/rev'}'{"\n"}'
2. リビジョンラベルを名前空間に適用します。次のコマンドで、REVISION_LABEL は前の手順でメモした istiod リビジョンラベルの値です。
  
  kubectl label namespace default \ istio-injection- istio.io/rev=REVISION_LABEL --overwrite

アプリケーションのデプロイ

これで、default 名前空間で自動インジェクションが有効になりました。BookInfo アプリケーションのサービスをデプロイすると、各サービスと一緒にサイドカープロキシが挿入されます。

Cloud Service Mesh をインストールしたコンピュータのコマンドラインで Cloud Service Mesh のインストールディレクトリのルートに移動します。必要に応じて、bookinfo サンプルアプリケーションを含むクラスタ内インストールファイルをダウンロードし、ファイルを解凍します。
kubectl を使用してアプリケーションをデフォルトの名前空間にデプロイします。
```
kubectl apply -f samples/bookinfo/platform/kube/bookinfo.yaml
```

次のコマンドを実行して、アプリケーションが正しくデプロイされていることを確認します。

kubectl get services

出力:

NAME                       CLUSTER-IP   EXTERNAL-IP   PORT(S)              AGE
details                    10.0.0.31    <none>        9080/TCP             6m
kubernetes                 10.0.0.1     <none>        443/TCP              7d
productpage                10.0.0.120   <none>        9080/TCP             6m
ratings                    10.0.0.15    <none>        9080/TCP             6m
reviews                    10.0.0.170   <none>        9080/TCP             6m

および

kubectl get pod

出力:

NAME                                        READY     STATUS    RESTARTS   AGE
details-v1-1520924117-48z17                 2/2       Running   0          6m
productpage-v1-560495357-jk1lz              2/2       Running   0          6m
ratings-v1-734492171-rnr5l                  2/2       Running   0          6m
reviews-v1-874083890-f0qf0                  2/2       Running   0          6m
reviews-v2-1343845940-b34q5                 2/2       Running   0          6m
reviews-v3-1813607990-8ch52                 2/2       Running   0          6m

最後に、アプリケーションの Ingress ゲートウェイルーティングを定義します。

kubectl apply -f samples/bookinfo/networking/bookinfo-gateway.yaml

出力:

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

アプリケーションのデプロイの検証

BookInfo アプリケーションが機能しているかどうかを確認するには、Ingress ゲートウェイにトラフィックを送信する必要があります。

VMware 用の Google Distributed Cloud に Cloud Service Mesh（ソフトウェアのみ）をインストールした場合は、Cloud Service Mesh のインストール後に構成した Ingress ゲートウェイの外部 IP アドレスを取得します。

Cloud Service Mesh を GKE にインストールした場合は、Ingress ゲートウェイの外部 IP アドレスを次のように取得します。

kubectl get service istio-ingressgateway -n istio-system

出力:

NAME                   TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                                      AGE
istio-ingressgateway   LoadBalancer   10.19.247.233   35.239.7.64   80:31380/TCP,443:31390/TCP,31400:31400/TCP   27m

この例では、Ingress サービスの IP アドレスは 35.239.7.64 です。

アプリケーションの実行

curl で BookInfo アプリが実行されていることを確認します。
```
curl -I http://EXTERNAL_IP/productpage
```
レスポンスに 200 が示されている場合、アプリケーションが Cloud Service Mesh と正しく連動しています。
BookInfo ウェブページを表示するには、ブラウザに次のアドレスを入力します。
```
http://EXTERNAL_IP/productpage
```
ページを何回か更新すると、ラウンドロビンスタイル（赤色の星、黒色の星、星なし）で示される、さまざまなバージョンのレビューが製品ページに表示されます。

トラフィックを生成しているアプリケーションが作成されたため、 Google Cloud コンソールで Cloud Service Mesh ページに移動して、指標やその他のオブザーバビリティ機能を確認できます。

クリーンアップ

Bookinfo サンプルによるテストが完了したら、クラスタから削除します。

次のスクリプトを使用して Bookinfo をアンインストールします。
```
samples/bookinfo/platform/kube/cleanup.sh
```

シャットダウンを確認します。

kubectl get virtualservices   #-- there should be no virtual services
kubectl get destinationrules  #-- there should be no destination rules
kubectl get gateway           #-- there should be no gateway
kubectl get pods              #-- the Bookinfo pods should be deleted

次のステップ

Bookinfo サンプルの詳細を確認する。

Bookinfo サンプルのデプロイ

サンプル画像のネットワーク アクセス

自動サイドカー インジェクションを有効にする

マネージド（TD）

マネージド（Istiod）

クラスタ内