旧バージョンのドキュメントを参照しています。最新のドキュメントはこちらをご参照ください。

アップストリーム

アップストリームとは、Kong Gatewayがリクエストを転送するAPI、アプリケーション、またはマイクロサービスを指します。Kong Gatewayでは、アップストリームオブジェクトは仮想ホスト名を表し、ヘルスチェック、サーキットブレーク、複数のサービスにわたる受信リクエストのロードバランシングに使用できます。

アップストリームとサービスのやり取り

ホストではなくアップストリームを指すようにサービスを構成できます。たとえば、 example_serviceというサービスとexample_upstreamというアップストリームがある場合、ホストを指定する代わりに、 example_serviceをexample_upstreamに指すことができます。example_upstreamアップストリームは、2 つの異なるターゲット、httpbin.orgとhttpbun.comを指すことができます。実際の環境では、アップストリームは複数のシステムで実行されている同じサービスを指します。

この設定により、アップストリームターゲット間でロードバランシングが可能になります。たとえば、アプリケーションが2つの異なるサーバーまたはアップストリームターゲットにデプロイされる場合、Kong Gatewayは両方のサーバーに負荷を分散する必要があります。その結果、一方のサーバー（前例のhttpbin.org）を利用できない場合は、その問題を自動的に検知して、すべてのトラフィックが動作しているサーバー（httpbun.com）にルーティングされるようになります。

アップストリーム構成

次の方法を使用して、 Kong Gatewayのサービスにアップストリームを追加できます。

Kong Managerの使用
Admin APIの使用
decK（YAML）の使用

アップストリームの設定方法の詳細については、ロードバランシングの設定を参照してください。