旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。
サービス
Kong Gatewayにおいて、サービスは外部のアップストリームAPIまたはマイクロサービスを表すエンティティです。サービスの例としては、データ変換マイクロサービス、課金APIなどでがあります。
サービスの主な属性はそのURLです。URLは単一の文字列で指定することも、プロトコル、ホスト、ポート、パスを個別に指定することもできます。
サービスとルートの相互作用
サービスをルートと組み合わせて使用すると、Kong Gateway でサービスをクライアントに公開できます。Kong Gateway はルートを使用してクライアントからサービスを抽象化します。クライアントは常にルートを呼び出すため、サービス(バージョン管理など)を変更しても、クライアントからの呼び出し方法に影響しません。また、ルートを使用すると、同じサービスを複数のクライアントで使用し、使用するルートに基づいて異なるポリシーを適用できます。
たとえば、 hwservice
サービスにアクセスする必要がある外部クライアントと内部クライアントがある場合、サービス拒否が発生しないように、外部クライアントがサービスを照会できる頻度を制限する必要があります。内部クライアントがサービスを呼び出すときに、サービスに対して流量制限ポリシーが設定されている場合は、内部クライアントも制限されます。ルートはこの問題を解決します。
上記の例では、 /external
と/internal
という2つのルートを作成し、両方のルートをhwservice
にポイントすることができます。ポリシーを設定して/external
ルートの使用頻度を制限し、そのルートを外部クライアントが使用できるように通信することができます。外部クライアントが/external
を使用してKong Gateway経由でサービスにアクセスしようとすると、レート制限が課せられます。ただし、内部クライアントが/internal
を使用してKong Gateway経由でサービスにアクセスする場合、内部クライアントは制限されません。
サービス構成
API へのアクセスを構成するときは、まずサービスを指定します。
次の方法を使用して、Kong Gatewayでサービスを構成できます。