このページでは、Service Directory に適用される主な用語について説明します。Service Directory の仕組みをより深く理解するために、用語の意味をよくご確認ください。
- エンドポイント
エンドポイントは、リクエストを処理できるサービスの前に配置される個別の IP/ポートのペアです。特定のサービスには 0 個以上のエンドポイントを含めることができます。エンドポイントは、リクエストを処理できる VM、コンテナ、ロードバランサなどのエンティティです。たとえば、ユーザーが管理する Redis サーバーのクラスタなどです。
エンドポイントには、クライアントが使用できる Key-Value ペアの形式のオプションのアノテーションを含めることができます。たとえば、Redis サービスには
replica:serverなどのアノテーションが付加される場合があります。アノテーションを使用して URL を保存できます。jq などのツールを使用して、レスポンスから新しい URL を取得できます。Service Directory の場合、エンドポイントはサービス内にのみ存在でき、そのサービスに固有の文字列識別子であるエンドポイント名で識別されます。
- サービス
サービスは、一連の動作を提供するエンドポイント（IP とポート）の集まりです。クライアントはサービス名でサービスを検索し、そのサービスを提供するエンドポイントに接続します。サービスには、オプションのアノテーション（Key-Value ペア）を関連付けることもできます（例:
use_https:true）。サービスは名前空間に属している必要があります。各サービス名は、その名前空間内で一意である必要があります。
- 名前空間
名前空間は、一連のサービス名とそのエンドポイント情報を保持します。名前空間は、管理を容易にするためにサービスをグループ化する手段です。
Namespace はリージョン リソースであり、プロジェクトに属します。Namespace の名前は、そのプロジェクトとリージョンで一意にする必要があります。
Namespace はリージョン リソースですが、その Namespace に属するサービスはどこにでも存在し、どこからでもクエリできます。エンドポイントが実行されている場所にマッピングされるリージョンを選択することをおすすめします。
- HTTP/gRPC クライアント
Service Directory は、HTTP/gRPC を使用したサービス名の検索をサポートしています。サービスとクライアントが同じネットワーク上にある必要はありません。
gRPC を介したルックアップ オペレーションは IAM によって制御されます。
- Service Directory ゾーン
Service Directory ゾーンは、完全で信頼できる情報源が Service Directory 名前空間である特定のタイプの Cloud DNS 限定公開ゾーンです。これにより、DNS リクエストを使用して Service Directory データをルックアップできます。
Namespace が Service Directory ゾーンに接続されている場合、その Namespace 内のすべてのサービスは、ゾーンのクエリを許可されているすべてのネットワークに表示されます。