Microservices Engine:クラウドネイティブゲートウェイを使用した gRPC サービスのルーティング

次のコードは、この gRPC サービスの proto 定義を示しています。

syntax = "proto3";

package grpcbin;

service GRPCBin {
  rpc Index(EmptyMessage) returns (IndexReply) {}
  // パラメーターがなく、空のレスポンスを返すメソッド。
  rpc Empty(EmptyMessage) returns (EmptyMessage) {}
  // リクエストパラメーターをレスポンスでエコーします。
  rpc DummyUnary(DummyMessage) returns (DummyMessage) {}
  // 10 個のメッセージを返すサーバー ストリーミング呼び出し。
  rpc DummyServerStream(DummyMessage) returns (stream DummyMessage) {}
  // 10 個のリクエストを受け付け、最後の 1 つのボディを返すクライアント ストリーミング呼び出し。
  rpc DummyClientStream(stream DummyMessage) returns (DummyMessage) {}
  // 双方向ストリーミングメソッド。
  rpc DummyBidirectionalStreamStream(stream DummyMessage) returns (stream DummyMessage) {}
  // このメソッドは指定された gRPC エラーを返します。
  rpc SpecificError(SpecificErrorRequest) returns (EmptyMessage) {}
  // このメソッドはランダムなエラーを返します。
  rpc RandomError(EmptyMessage) returns (EmptyMessage) {}
  // このメソッドはヘッダーを返します。
  rpc HeadersUnary(EmptyMessage) returns (HeadersMessage) {}
  // このメソッドはレスポンスを返しません。
  rpc NoResponseUnary(EmptyMessage) returns (EmptyMessage) {}
}

message HeadersMessage {
  message Values {
    repeated string values = 1;
  }
  map<string, Values> Metadata = 1;
}

message SpecificErrorRequest {
  uint32 code = 1;
  string reason = 2;
}

message EmptyMessage {}

message DummyMessage {
  message Sub {
    string f_string = 1;
  }
  enum Enum {
    ENUM_0 = 0;
    ENUM_1 = 1;
    ENUM_2 = 2;
  }
  string f_string = 1;
  repeated string f_strings = 2;
  int32 f_int32 = 3;
  repeated int32 f_int32s = 4;
  Enum f_enum = 5;
  repeated Enum f_enums = 6;
  Sub f_sub = 7;
  repeated Sub f_subs = 8;
  bool f_bool = 9;
  repeated bool f_bools = 10;
  int64 f_int64 = 11;
  repeated int64 f_int64s= 12;
  bytes f_bytes = 13;
  repeated bytes f_bytess = 14;
  float f_float = 15;
  repeated float f_floats = 16;
}

message IndexReply {
  message Endpoint {
    string path = 1;
    string description = 2;
  }
  string description = 1;
  repeated Endpoint endpoints = 2;
}

gRPC は HTTP/2 プロトコル上に構築されており、そのパスは {PackageName}.{ServiceName}/{MethodName} というフォーマットに従います。これにより、クラウドネイティブゲートウェイはパスに基づいてリクエストをルーティングできます。たとえば、grpcbin サービスの Index メソッドへの gRPC コールは、パスが grpcbin.GRPCBin/Index となります。

サービスソースの追加

1. MSE コンソール にログインします。上部のナビゲーションバーで、リージョンを選択します。

2. 左側のナビゲーション ウィンドウで、Cloud-Native Gateway > ゲートウェイリスト を選択します。 [ゲートウェイ] ページで、ゲートウェイの名前をクリックします。

3. 左側のナビゲーションウィンドウで、Routes をクリックします。表示されるページで、[ソース] タブをクリックします。

4. ソースの作成 をクリックします。ソースの作成 パネルで、[Source Type] を コンテナサービス に設定して、パラメーターを設定してから OK をクリックします。

   パラメーター	説明
   [ACK/サーバーレス Kubernetes クラスター]	バックエンドサービスが配置されているクラスターを選択します。 説明 ゲートウェイを作成する際には、バックエンドクラスターと同じ Virtual Private Cloud (VPC) を選択する必要があります。その後、サービスソースを追加すると、システムはその VPC 内のクラスターを自動的に検出します。
   [K8s Ingress リスナー]	このオプションを有効にすると、クラウドネイティブゲートウェイは Ingress リソースへの変更を自動的にリッスンして、それらのリソースからドメインとルートの設定を適用します。 このオプションを無効にすると、クラウドネイティブゲートウェイは Ingress リソースのリッスンを停止して、以前にそれらのリソースから適用された設定を無効にします。このオプションは注意して使用してください。 重要 コンソールで手動で設定されたドメインおよびルート設定は、Ingress リソースからの設定よりも優先度が高くなります。
   [IngressClass]	指定された IngressClass に関連付けられた Ingress リソースをリッスンします。 空のままにした場合、ゲートウェイはクラスター内のすべての Ingress リソースをリッスンします。 値を指定した場合 (単一の値のみサポート)、ゲートウェイは class アノテーションまたは Spec.IngressClassName フィールドが指定された値と一致する Ingress リソースをリッスンします。たとえば、これを nginx に設定すると、ゲートウェイは IngressClass が nginx の Ingress リソースと、どの IngressClass にも関連付けられていない Ingress リソースの両方をリッスンします。
   [名前空間]	特定の名前空間内の Ingress リソースをリッスンします。 空のままにした場合、ゲートウェイはクラスター内のすべての名前空間の Ingress リソースをリッスンします。 値を指定した場合 (単一の値のみサポート)、ゲートウェイは指定された名前空間内の Ingress リソースをリッスンします。
   [Ingress ステータスの更新]	このオプションを有効にすると、システムは監視対象の Ingress の Status フィールド内の IP アドレスを、クラウドネイティブゲートウェイに関連付けられた Server Load Balancer (SLB) インスタンスの IP アドレスに更新します。 説明 この機能には、ゲートウェイバージョン 1.2.9 以降が必要です。
   [セキュリティグループの権限付与]	コンテナクラスターのノードプールにはセキュリティグループが設定されています。クラスター外のコンポーネントがクラスター内のサービスにアクセスできるようにするには、セキュリティグループで必要なサービスポートを開く必要があります。 セキュリティグループは変更できます。詳細については、「セキュリティグループルールの設定」をご参照ください。

サービスの追加

1. MSE コンソールにログオンし、上部のナビゲーションバーでリージョンを選択します。

2. 左側のナビゲーション ウィンドウで、Cloud-Native Gateway > ゲートウェイリスト を選択します。 [ゲートウェイ] ページで、ゲートウェイの名前をクリックします。

3. 左側のナビゲーションウィンドウで、Routes をクリックします。表示されるページで、[サービス] タブをクリックします。

4. Create Service をクリックして、パネルでパラメーターを設定してから OK をクリックします。

   パラメーター	説明
   [サービスソース]	コンテナサービス を選択します。
   [名前空間]	対象クラスターの名前空間を選択します。
   [サービス一覧]	リストからサービスを選択します。

grpcbin ルートの追加

1. MSE コンソールにログオンし、上部のナビゲーションバーでリージョンを選択します。

2. 左側のナビゲーション ウィンドウで、Cloud-Native Gateway > ゲートウェイリスト を選択します。 [ゲートウェイ] ページで、ゲートウェイの名前をクリックします。

3. 左側のナビゲーションウィンドウで、Routes をクリックし、[ルート] タブをクリックします。

4. ルーティングの作成 をクリックします。ルーティングの作成 ページでルートパラメーターを設定して、保存・公開 をクリックします。詳細については、「ルートの追加」をご参照ください。

   パラメーター	説明
   [ルーティング名]	grpc に設定します。
   [ドメイン名]	デフォルトのドメイン * を選択します。
   [パス]	一致条件を プレフィックスは に設定して、パスの値を /grpcbin.GRPCBin に設定します。 説明 gRPC サービスのパス形式は {PackageName}.{ServiceName}/{MethodName} です。この形式に基づいて前方一致のルートを設定できます。
   [使用シナリオ]	[Scenario] を 単一サービス に設定します。
   [バックエンドサービス]	対象のサービスとサービスポートを選択します。