OpenShift を使用したサービスネットワークの作成

手順

1. サブスクリプションがアクティベートされ、システムが登録されていることを確認します。

2. 必要なリポジトリーにサブスクライブします。

   Red Hat Enterprise Linux 8

   $ sudo subscription-manager repos --enable=application-interconnect-1-for-rhel-8-x86_64-rpms

3. yum コマンドまたは dnf コマンドを使用して、skupper パッケージをインストールします。

   $ sudo yum install skupper-cli

4. インストールを確認します。

   $ skupper version
   client version 1.0.2-redhat-1

手順

1. west namespace で作業するように端末セッションを開始し、KUBECONFIG 環境変数を設定します。

   $ export KUBECONFIG=$HOME/.kube/config-west

   このセッションは、後で west ターミナルセッションと呼ばれます。

2. east namespace で作業するように端末セッションを開始し、KUBECONFIG 環境変数を設定します。

   $ export KUBECONFIG=$HOME/.kube/config-east

   このセッションは、後で east ターミナルセッションと呼ばれます。

3. 各ターミナルセッションで、OpenShift クラスターにログインします。

1. west ターミナルセッションで、以下を行います。

   1. west プロジェクト (namespace) を作成します。

      $ kubectl create namespace west
      $ kubectl config set-context --current --namespace west

   2. サービスネットワークルーターを作成します。

      $ skupper init

   3. サイトのステータスを確認します。

      $ skupper status

      出力は以下のようになります。

      Skupper enabled for namespace 'west'. It is not connected to any other sites.

2. east ターミナルセッションで、以下を行います。

   1. east プロジェクト (namespace) を作成します。

      $ kubectl create namespace east
      $ kubectl config set-context --current --namespace east

   2. サービスネットワークルーターを作成します。

      $ skupper init

   3. サイトのステータスを確認します。

      $ skupper status

      出力は以下のようになります。

      Skupper enabled for namespace 'east'. It is not connected to any other sites.

手順

1. west ターミナルセッションで、west namespace への接続を許可する接続トークンを作成します。

   $ skupper token create $HOME/secret.yaml

   このコマンドは、ホームディレクトリーに secret.yaml ファイルを作成し、セキュアな接続の作成に使用できます。

2. east ターミナルセッションで、トークンを使用して west namespace への接続を作成します。

   $ skupper link create $HOME/secret.yaml

3. west ターミナルセッションからサイトのステータスを確認します。

   $ skupper status

   出力は以下のようになります。

   Skupper is enabled for namespace "west" in interior mode. It is connected to 1 other site. It has no exposed services.
   The site console url is:  https://<skupper-url>
   The credentials for internal console-auth mode are held in secret: 'skupper-console-users'

1. フロントエンドサービスをデプロイします。

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

2. フロントエンドデプロイメントをクラスターサービスとして公開します。

   $ kubectl expose deployment hello-world-frontend --port 8080 --type LoadBalancer

3. フロントエンドのルートを作成します。

   $ kubectl expose svc/hello-world-frontend

4. フロントエンドルートを確認します。

   1. ルートの詳細を取得します。

      $  oc get routes

      出力は以下のようになります。

      NAME                   HOST/PORT
      hello-world-frontend   <frontend-url>

   2. ブラウザーで <frontend-url> の値に移動すると、フロントエンドが バックエンドと通信できないため、以下のようなメッセージが表示されます。

      Trouble! HTTPConnectionPool(host='hello-world-backend', port=8080): Max retries exceeded with url: /api/hello (Caused by NewConnectionError('<urllib3.connection.HTTPConnection object at 0x7fbfcdf0d1d0>: Failed to establish a new connection: [Errno -2] Name or service not known'))

      この状況を解決するには、バックエンドサービスを作成し、サービスネットワークで利用できるようにする必要があります。

手順

1. east ターミナルセッションにバックエンドサービスをデプロイします。

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

2. east ターミナルセッションからサービスネットワーク上のバックエンドサービスを公開します。

   $ skupper expose deployment hello-world-backend --port 8080 --protocol tcp

3. west ターミナルセッションからサイトのステータスを確認します。

   $ skupper status

   出力は以下のようになります。

   Skupper is enabled for namespace "west" in interior mode. It is connected to 1 other site. It has 1 exposed service.

   サービスは east namespace から公開されます。

4. west ターミナルセッションにフロントエンドルートを確認します。

   1. ルートの詳細を取得します。

      $  oc get routes

      出力は以下のようになります。

      NAME                   HOST/PORT
      hello-world-frontend   <frontend-url>

   2. ブラウザーで <frontend-url> の値に移動すると、以下のようなメッセージが表示されます。

      Hi, <name>. I am Mathematical Machine (backend-77f8f45fc8-mnrdp).

      もう一度 Say hello をクリックすると、別のバックエンドプロセスが応答し、Application Interconnect が要求のバランスをとる方法を示します。

1. west 端末セッションから west namespace を削除します。

   $ kubectl delete namespace west

2. east 端末セッションから east namespace を削除します。

   $ kubectl delete namespace east