旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。
サービスとルート
このチュートリアルでは、Kong Managerでサービスとルートを作成する方法について説明します。
Admin API を使用する場合は、 Kong Gateway スタートガイドを確認してください。
前提条件
Kong Manager が有効になっている Kong Gateway インスタンスが必要です。
サービスを追加する
このチュートリアルでは、httpbin API を指すサービスを作成します。Httpbin は、リクエストをリクエスト元にレスポンスとして返す「エコー」タイプの公開ウェブサイトです。
Kong Manager の [ワークスペース] タブで以下を行います。
-
デフォルト のワークスペースを開きます。
この例では、デフォルトのワークスペースを使用していますが、新しいワークスペースを作成するか、既存のワークスペースを使用できます。
-
サービス セクションで、 新規サービス をクリックします。
-
サービスを作成 ダイアログで、名前
example_service
とURLhttp://httpbin.org
を入力します。 -
作成 をクリックします。
サービスが作成され、ページは自動的に
example_service
概要ページにリダイレクトされます。
ルートの追加
APIゲートウェイ経由でサービスをアクセス可能にするには、サービスへのルートを追加する必要があります。
-
example_service
の概要ページで、サブメニューから ルート を開き、 新規ルート をクリックします。 -
ルートの作成 ページでは、 サービス フィールドにサービス名とID番号が自動入力されます。このフィールドは必須です。
サービスフィールドが自動的に入力されない場合は、左側のナビゲーションペインで サービス クリックします。サービスを探して、 IDフィールドの横にあるクリップボードアイコンをクリックして、 ルートの作成 ページに戻り、 サービスフィールド に貼り付けます。
-
ルートの名前と、ホスト、メソッド、パスのうち、少なくとも1つのフィールドを入力します。この例では、以下を使用します。
-
Name には、
mocking
と入力します。 -
パス で、 パスを追加 をクリックして
/mock
と入力します。
-
Name には、
-
作成 をクリックします。
Kongは自動的にexample_service
概要ページにリダイレクトします。新しいルートが「ルート」セクションの下に表示されます。
ルートがリクエストをサービスに転送していることを確認
デフォルトでは、Kong Gateway はポート 8000
でプロキシリクエストを処理します。
ウェブブラウザで、http://localhost:8000/mock/anything
に移動します。
次の手順
次に、Kong Managerを通じてサービスに流量制限を適用する方法について学習します。