27.3. Ingress コントローラーを使用した Ingress クラスターの設定

手順

1. oc new-project コマンドを実行して、サービス用の新しいプロジェクトを作成します。

   $ oc new-project myproject

2. oc new-app コマンドを使用してサービスを作成します。

   $ oc new-app nodejs:12~https://github.com/sclorg/nodejs-ex.git

3. サービスが作成されたことを確認するには、以下のコマンドを実行します。

   $ oc get svc -n myproject

   出力例

   NAME        TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   nodejs-ex   ClusterIP   172.30.197.157   <none>        8080/TCP   70s

   デフォルトで、新規サービスには外部 IP アドレスがありません。

1. OpenShift Container Platform にログインします。

2. 公開するサービスが置かれているプロジェクトにログインします。

   $ oc project myproject

3. oc expose service コマンドを実行して、ルートを公開します。

   $ oc expose service nodejs-ex

   出力例

   route.route.openshift.io/nodejs-ex exposed

4. サービスが公開されていることを確認するには、cURL などのツールを使って、クラスター外からサービスにアクセスできることを確認します。

   1. ルートのホスト名を調べるには、oc get route コマンドを使用します。

      $ oc get route

      出力例

      NAME        HOST/PORT                        PATH   SERVICES    PORT       TERMINATION   WILDCARD
      nodejs-ex   nodejs-ex-myproject.example.com         nodejs-ex   8080-tcp                 None

   2. cURL を使用して、ホストが GET 要求に応答することを確認します。

      $ curl --head nodejs-ex-myproject.example.com

      出力例

      HTTP/1.1 200 OK
      ...

手順

1. router-internal.yaml ファイルを編集します。

   # cat router-internal.yaml
   apiVersion: v1
   items:
   - apiVersion: operator.openshift.io/v1
     kind: IngressController
     metadata:
       name: sharded
       namespace: openshift-ingress-operator
     spec:
       domain: <apps-sharded.basedomain.example.net> 1
       nodePlacement:
         nodeSelector:
           matchLabels:
             node-role.kubernetes.io/worker: ""
       routeSelector:
         matchLabels:
           type: sharded
     status: {}
   kind: List
   metadata:
     resourceVersion: ""
     selfLink: ""

   1

   Ingress Controller が使用するドメインを指定します。このドメインは、デフォルトのイングレスコントローラードメインとは異なる必要があります。

2. Ingress コントローラーの router-internal.yaml ファイルを適用します。

   # oc apply -f router-internal.yaml

   Ingress コントローラーは、type: sharded というラベルのある namespace のルートを選択します。

3. router-internal.yaml で設定されたドメインを使用して新しいルートを作成します。

   $ oc expose svc <service-name> --hostname <route-name>.apps-sharded.basedomain.example.net

手順

1. router-internal.yaml ファイルを編集します。

   # cat router-internal.yaml

   出力例

   apiVersion: v1
   items:
   - apiVersion: operator.openshift.io/v1
     kind: IngressController
     metadata:
       name: sharded
       namespace: openshift-ingress-operator
     spec:
       domain: <apps-sharded.basedomain.example.net> 1
       nodePlacement:
         nodeSelector:
           matchLabels:
             node-role.kubernetes.io/worker: ""
       namespaceSelector:
         matchLabels:
           type: sharded
     status: {}
   kind: List
   metadata:
     resourceVersion: ""
     selfLink: ""

   1

   Ingress Controller が使用するドメインを指定します。このドメインは、デフォルトのイングレスコントローラードメインとは異なる必要があります。

2. Ingress コントローラーの router-internal.yaml ファイルを適用します。

   # oc apply -f router-internal.yaml

   Ingress コントローラーは、type: sharded というラベルのある namespace セレクターによって選択される namespace のルートを選択します。

3. router-internal.yaml で設定されたドメインを使用して新しいルートを作成します。

   $ oc expose svc <service-name> --hostname <route-name>.apps-sharded.basedomain.example.net

手順

1. 次のコマンドを実行して、hello-openshift というプロジェクトを作成します。

   $ oc new-project hello-openshift

2. 以下のコマンドを実行してプロジェクトに Pod を作成します。

   $ oc create -f https://raw.githubusercontent.com/openshift/origin/master/examples/hello-openshift/hello-pod.json

3. 以下のコマンドを実行して、hello-openshift というサービスを作成します。

   $ oc expose pod/hello-openshift

4. hello-openshift-route.yaml というルート定義を作成します。

   シャーディング用に作成されたルートの YAML 定義:

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     labels:
       type: sharded 1
     name: hello-openshift-edge
     namespace: hello-openshift
   spec:
     subdomain: hello-openshift 2
     tls:
       termination: edge
     to:
       kind: Service
       name: hello-openshift

   1

   ラベルキーとそれに対応するラベル値の両方が、Ingress コントローラーで指定されたものと一致する必要があります。この例では、Ingress コントローラーにはラベルキーと値 type: sharded があります。

   2

   ルートは、subdomain フィールドの値を使用して公開されます。subdomain フィールドを指定するときは、ホスト名を未設定のままにしておく必要があります。host フィールドと subdomain フィールドの両方を指定すると、ルートは host フィールドの値を使用し、subdomain フィールドを無視します。

5. 次のコマンドを実行し、hello-openshift-route.yaml を使用して hello-openshift アプリケーションへのルートを作成します。

   $ oc -n hello-openshift create -f hello-openshift-route.yaml