第2章 リンクコストの指定

手順

1. たとえば、サイトの 1 つにデプロイメント、いくつかの Pod、またはサービスを作成します。

   $ kubectl create deployment hello-world-backend --image quay.io/skupper/hello-world-backend

   この手順は Skupper 固有のものではありません。つまり、このプロセスはクラスターの標準プロセスから変更されていません。

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

   デプロイメントおよび Pod

   $ skupper expose [deployment <name>|pods <selector>]

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

   • <name> - デプロイメントの名前。
   • <selector> - Pod セレクター。

   Kubernetes サービス

   --address オプションを使用して結果のサービス名を指定します。

   $ skupper expose service <name> --address <skupper-service-name>

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

   • <name> - サービスの名前。
   • <skupper-service-name> - サービスネットワーク上で共有される結果のサービスの名前。

   StatefulSets

   以下を使用して statefulset を公開できます。

   $ skupper expose statefulset <statefulsetname>

   Kubernetes の StatefulSet は、各 Pod に安定した一意のネットワーク識別子を提供するために、ヘッドレスサービスに関連付けられることがよくあります。サービスネットワーク上の各 Pod に安定したネットワーク識別子が必要な場合は、--headless オプションを使用します。

   $ skupper expose statefulset  --headless

   注記

   '--headless' オプションを使用すると、アドレス (ルーティングキー) を通じてサービスネットワーク内の 1 つのステートフルセットのみを公開できます。

   手順 1 のサンプルデプロイメントでは、次のコマンドを使用してサービスを作成できます。

   $ skupper expose deployment/hello-world-backend --port 8080

   expose コマンドのオプションには以下が含まれます。

   • --port <port-number>: このサービスがサービスネットワーク上で利用可能なポート番号を指定します。注記: このオプションを繰り返すことで、複数のポートを指定できます。
   • --target-port <port-number>: 公開したい Pod のポート番号を指定します。
   • --protocol <protocol> を使用すると、使用するプロトコル、tcp、http、または http2 を指定できます。
   注記

   ポートを指定しないと、skupper はデプロイメントの containerPort 値を使用します。

3. サービスネットワークで公開されているサービスのステータスを確認します (-v は Kubernetes でのみ使用可能)。

   $ skupper service status -v
   Services exposed through Skupper:
   ╰─ backend:8080 (tcp)
      ╰─ Sites:
         ├─ 4d80f485-52fb-4d84-b10b-326b96e723b2(west)
         │  policy: disabled
         ╰─ 316fbe31-299b-490b-9391-7b46507d76f1(east)
            │ policy: disabled
            ╰─ Targets:
               ╰─ backend:8080 name=backend-9d84544df-rbzjx

手順

1. たとえば、サイトの 1 つにデプロイメント、いくつかの Pod、またはサービスを作成します。

   $ kubectl create deployment hello-world-backend --image quay.io/skupper/hello-world-backend

   この手順は Skupper 固有のものではありません。つまり、このプロセスはクラスターの標準プロセスから変更されていません。

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

   $ skupper service create <name> <port>

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

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

   手順 1 のデプロイメント例では、次のコマンドを使用してサービスを作成します。

   $ skupper service create hello-world-backend 8080

3. サービスをクラスターサービスにバインドします。

   $ skupper service bind <service-name> <target-type> <target-name>

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

   • <service-name> - サービスネットワーク上のサービスの名前。
   • <target-type> は、公開するオブジェクト (deployment、statefulset、pods、または service) です。
   • <target-name> - クラスターサービスの名前。

   手順 1 のデプロイメント例では、次のコマンドを使用してサービスをバインドします。

   $ skupper service bind hello-world-backend deployment hello-world-backend

手順

1. サイト namespace 以外の namespace からワークロードを公開する場合は、クラスター権限でサイトを作成します。

   注記

   このサイトには、Kubernetes サービスリソースを公開するために --enable-cluster-permissions で付与される追加の権限は必要ありません。

   $ skupper init --enable-cluster-permissions

2. サイト namespace 以外の namespace から Kubernetes サービスを公開するには、以下を実行します。

   $ skupper expose service <service>.<namespace> --address <service>

   • <service> - サービスネットワーク上のサービスの名前。
   • <namespace> - 公開するサービスが実行される namespace の名前。

   たとえば、Skupper を east namespace にデプロイし、east-backend namespace に backend Kubernetes サービスを作成した場合、コンテキストを east namespace に設定し、以下を使用してサービスをサービスネットワーク上の backend として公開します。

   $ skupper expose service backend.east-backend --port 8080 --address backend

3. --enable-cluster-permissions で作成したサイトからワークロードを公開するには、以下を実行します。

   $ skupper expose <resource> --port <port-number> --target-namespace <namespace>

   • <resource> - リソースの名前。
   • <namespace> - 公開するリソースが実行される namespace の名前。

   たとえば、Skupper を east namespace にデプロイし、backend デプロイメントを east-backend namespace に作成した場合は、コンテキストを east namespace に設定し、以下を使用してサービスネットワーク上でサービスを backend として公開します。

   $ skupper expose deployment/backend --port 8080 --target-namespace east-backend