プロジェクト間の参照を設定する

このドキュメントは、 Google Cloudサービスルーティング API を使用する Cloud Service Mesh にのみ適用されます。Istio API を使用する Cloud Service Mesh を構成する場合は、このドキュメントを使用しないでください。

一部のシナリオでは、サービスメッシュ構成に異なるプロジェクトのサービスが含まれています。たとえば、共有 VPC デプロイやピアリング VPC デプロイでは、各プロジェクトオーナーが独自のサービスセットを定義して、これらのサービスを他のすべてのプロジェクトで利用できるようにすることができます。

Mesh リソースを使用したクロスプロジェクト構成 — `Mesh` リソースを使用したクロスプロジェクト構成（クリックして拡大）

この構成はクロスプロジェクト構成と呼ばれています。この構成では、異なるプロジェクトで定義されている複数のリソースが結合されて 1 つの構成を形成し、Envoy プロキシまたはプロキシレス gRPC クライアントに提供されます。

以下の手順では Mesh リソースと HTTPRoute リソースを使用していますが、Gateway リソース、GRPCRoute リソース、TCPRoute リソースにも適用できます。

`Mesh` リソースを構成する

Mesh リソースを管理するホストプロジェクトとしてプロジェクトを指定します。このプロジェクトで Mesh リソースを作成、更新、削除する権限を持つサービスアカウントは、このプロジェクトの Mesh リソースに接続されているルーティング構成を制御できます。

shared-mesh.yaml ファイルで、Mesh 仕様を作成します。
```
name: shared-mesh
interceptionPort: 15001
```

このプロジェクトで Mesh リソースを定義します。

gcloud network-services meshes import shared-mesh \
  --source=shared-mesh.yaml \
  --location=global

サービスオーナーがこの Mesh にルートを接続する際に必要になるため、Mesh リソースの完全な URI をメモしておきます。
```
/projects/[HOST_PROJECT_NUMBER]/locations/global/meshes/shared-mesh
```
この Mesh の networkservices.meshes.use IAM 権限を、この Mesh にサービス情報を接続できるクロスプロジェクトサービスアカウントに付与します。
```
gcloud projects add-iam-policy-binding [HOST_PROJECT_NUMBER]
  --member='[HTTP_ROUTE_SERVICE_OWNER_ACCOUNT]'
  --role='roles/compute.networkAdmin'
```

networkservices.meshes.use 権限を持つすべてのサービスオーナーは、この Mesh リソースにルーティングルールを追加できます。

サービスプロジェクトでルーティングを設定する

各サービスオーナーは、サイドカープロキシ構成ガイドの例と同様に、プロジェクトに 1 つ以上のバックエンドサービスと Route リソースを作成する必要があります。唯一の違いは、HTTPRoute、GRPCRoute、TCPRoute の各リソースの meshes フィールドに、ホストプロジェクトの Mesh リソースの URI が必要なことです。

次のようにして、meshes フィールドに値を設定します。プロジェクト ID またはプロジェクト番号のいずれかを使用できます。

echo "name: sharedvpc-http-route
hostnames:
- helloworld-gce
meshes:
- /projects/[HOST_PROJECT_NUMBER]/locations/global/meshes/shared-mesh
rules:
- action:
    destinations:
    - serviceName: \"url/of/the/service\"" | \
gcloud network-services http-routes import sharedvpc-http-route \
    --source=- \
    --location=global

サービスプロジェクトでクライアントサービスを作成する

サービスプロジェクト内にある Cloud Service Mesh クライアントを構成する場合、ブートストラップ構成で Mesh リソースが配置されているプロジェクトの番号と Mesh 名を指定する必要があります。この要件は、Envoy プロキシとプロキシレス gRPC デプロイの両方に適用されます。Envoy のデプロイでは、--service-proxy:project-number オプションを使用します。

次のステップ

Mesh リソースまたは Gateway リソースに関連付けられたルートリソースを一覧表示する方法については、Route リソースを一覧表示するをご覧ください。

プロジェクト間の参照を設定する

Mesh リソースを構成する

サービス プロジェクトでルーティングを設定する

サービス プロジェクトでクライアント サービスを作成する

次のステップ

`Mesh` リソースを構成する

サービスプロジェクトでルーティングを設定する

サービスプロジェクトでクライアントサービスを作成する