1.7. ローカルマシンからのサービスネットワーク上のサービスの公開

手順

1. サービスをローカルに実行します。
2. クラスターにログインし、実際のサイトの namespace に移動します。

3. サービスネットワーク上でサービスを公開します。

   $ skupper gateway expose <service> localhost <port>

   Copy to Clipboard Toggle word wrap
   • <service> - サービスネットワーク上のサービスの名前。
   • <port> - サービスをローカルで実行するポート。
   注記

   たとえば、MySQL が専用サーバー (IP アドレス 192.168.1.200) で実行しているが、同じネットワーク内のマシンからクラスターにアクセスしている場合など、ローカルネットワーク上の他のマシンからサービスを公開することもできます。

   $ skupper gateway expose mysql 192.168.1.200 3306

   Copy to Clipboard Toggle word wrap

4. Skupper ゲートウェイのステータスを確認します。

   $ skupper gateway status
   
   Gateway Definition:
   ╰─ machine-user type:service version:2.2.1.redhat.1.1.0-2
      ╰─ Bindings:
         ╰─ mydb:3306 tcp mydb:3306 localhost 3306

   Copy to Clipboard Toggle word wrap

   これは、公開されるサービスが 1 つだけあり、サービスは単一のポート (BIND) のみを公開することを示しています。ローカルホストへ転送されるポートはありません。

   URL フィールドは基礎となる通信を示し、無視できます。

1. Skupper ゲートウェイを作成します。

   $ skupper gateway init --type <gateway-type>

   Copy to Clipboard Toggle word wrap
   注記

   デフォルトのサービスタイプのゲートウェイでは、skrouterd が実行されている必要があります。

   デフォルトでは、サービス タイプのゲートウェイが作成されますが、以下を指定することも可能です。

   • podman
   • docker

2. サービスネットワーク上で通信可能なサービスを作成します。

   $ skupper service create <name> <port>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   • <name> - 作成するサービスの名前。
   • <port> - サービスが使用するポート。

   以下に例を示します。

   $ skupper service create mydb 3306

   Copy to Clipboard Toggle word wrap

3. サービスネットワーク上のサービスをバインドします。

   $ skupper gateway bind <service> <host> <port>

   Copy to Clipboard Toggle word wrap
   • <service> - サービスネットワーク上のサービス名 (上記の例では mydb )。
   • <host> - サービスを実行するホスト。
   • <port> - サービスが実行中のポート。上記の例の 3306。

4. Skupper ゲートウェイのステータスを確認します。

   $ skupper gateway status
   Gateway Definitions Summary
   
   Gateway Definition:
   ╰─ machine-user type:service version:2.2.1.redhat.1.1.0-2
      ╰─ Bindings:
         ╰─ mydb:3306 tcp mydb:3306 localhost 3306

   Copy to Clipboard Toggle word wrap

   これは、公開されるサービスが 1 つだけあり、サービスは単一のポート (BIND) のみを公開することを示しています。ローカルホストへ転送されるポートはありません。

   URL フィールドは基礎となる通信を示し、無視できます。

   サービスネットワークに追加のサービスを作成し、さらにローカルサービスをバインドして、これらのサービスをサービスネットワーク上で公開することができます。

5. サービスネットワークからローカルマシンにサービスを転送します。

   $ skupper gateway forward <service> <port>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   • <service> は、サービスネットワーク上の既存サービスの名前です。
   • <port> は、使用するローカルマシンのポートです。

手順

1. 1 台目のマシンからクラスターにログインし、サイトの namespace に変更します。

2. サービスネットワーク上で通信可能なサービスを作成します。

   $ skupper service create <name> <port>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   • <name> - 作成するサービスの名前。
   • <port> - サービスが使用するポート。

   以下に例を示します。

   $ skupper service create database 5432

   Copy to Clipboard Toggle word wrap

3. 公開するサービスを表す YAML ファイルを作成します。以下に例を示します。

   name: database 

   1

   
   bindings:
       - name: database 

   2

   
         host: localhost 

   3

   
         service:
           address: database:5432 

   4

   
           protocol: tcp 

   5

   
           ports:
               - 5432 

   6

   
         target_ports:
           - 5432 

   7

   
   qdr-listeners:
       - name: amqp
         host: localhost
         port: 5672

   Copy to Clipboard Toggle word wrap

   1

   ゲートウェイ名。参照のみの場合に役立ちます。

   2

   バインディング名。複数のバインディングを追跡する際に役立ちます。

   3

   公開したいサービスを提供しているホストの名前。

   4

   サービスネットワーク上のサービス名とポート。前のステップでサービスを作成しました。

   5

   サービスを公開するために使用するプロトコル、tcp、http、または http2。

   6

   このサービスを利用できるようにするサービスネットワーク上のポート。

   7

   ポイント 3 で指定されたホストで実行されているサービスのポート。

4. ゲートウェイの名前を使用して、YAML ファイルを保存します (例: gateway.yaml)。

5. サービスネットワーク上で公開するサービスをホストするマシンに適用できるバンドルを生成します。

   $ skupper gateway generate-bundle <config-filename> <destination-directory>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   • <config-filename> - 前のステップで生成した YAML ファイルの名前 (接尾辞を含む)。
   • <destination-directory> - 結果のゲートウェイバンドルを保存する場所 (例: ~/gateways)。

   以下に例を示します。

   $ skupper gateway generate-bundle database.yaml ./

   Copy to Clipboard Toggle word wrap

   このバンドルには、サービスネットワークへのアクセスを許可するゲートウェイ定義の YAML と証明書が含まれています。

6. ゲートウェイ定義ファイル (mylaptop-jdoe.tar.gz など) を、サービスネットワーク上で公開するサービスをホストするマシンにコピーします。

7. 公開したいサービスをホストしているマシンから、以下を実行します。

   $ mkdir gateway
   
   $ tar -xvf <gateway-definition-file> --directory gateway
   $ cd gateway
   $ sh ./launch.py

   Copy to Clipboard Toggle word wrap
   注記

   ./launch.py -t podman または./launch.py -t docker を使用して、コンテナーで Skupper ルーターを実行します。

   ゲートウェイバンドルを実行すると、ゲートウェイ定義 YAML と証明書を使用して、サービスネットワーク上のサービスにアクセスして公開します。

8. ゲートウェイサービスのステータスを確認します。

   サービス タイプのゲートウェイを確認するには、以下を実行します。

   $ systemctl --user status <gateway-definition-name>

   Copy to Clipboard Toggle word wrap

   podman タイプのゲートウェイを確認するには、以下を実行します。

   $ podman inspect

   Copy to Clipboard Toggle word wrap

   docker タイプのゲートウェイを確認するには、以下を実行します。

   $ docker inspect

   Copy to Clipboard Toggle word wrap
   注記

   後で ./remove.py を使用してゲートウェイを削除できます。

9. クラスターにアクセスできるマシンから、Skupper ゲートウェイのステータスを確認します。

   $ skupper gateway status
   Gateway Definition:
   ╰─ machine-user type:service version:2.2.1.redhat.1.1.0-2
      ╰─ Bindings:
         ╰─ mydb:3306 tcp mydb:3306 localhost 3306

   Copy to Clipboard Toggle word wrap

   これは、公開されるサービスが 1 つだけあり、サービスは単一のポート (BIND) のみを公開することを示しています。ローカルホストへ転送されるポートはありません。