1. CNI 設定を CR として保存するプロジェクト、およびその CR を使用する Pod を作成します。

   $ oc new-project multinetwork-example

2. 追加のネットワークインターフェースを定義する CR を作成します。以下の内容を含む、macvlan-conf.yaml という YAML ファイルを作成します。

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition 1
   metadata:
     name: macvlan-conf 2
   spec:
     config: '{ 3
         "cniVersion": "0.3.0",
         "type": "macvlan",
         "master": "eth0",
         "mode": "bridge",
         "ipam": {
           "type": "host-local",
           "subnet": "192.168.1.0/24",
           "rangeStart": "192.168.1.200",
           "rangeEnd": "192.168.1.216",
           "routes": [
             { "dst": "0.0.0.0/0" }
           ],
           "gateway": "192.168.1.1"
         }
       }'

   1

   kind: NetworkAttachmentDefinition: これは、この設定が保存される CR の名前です。これは、この設定が保存される CR の名前です。これは、ネットワークを Pod に割り当てる方法を定義する Kubernetes のカスタム拡張です。

   2

   name は、次の手順で使用されるアノテーションにマップされます。

   3

   config: CNI 設定は config フィールドにパッケージ化されます。

   設定はプラグインに固有のものです。CNI 設定部分の type 行に注意してください。CNI 設定の部分の type 行をメモしてください。 この例では、ネットワーク用の IPAM (IP アドレス管理) パラメーターのほかに、master フィールドは、Pod をホストするノードにあるネットワークインターフェースを参照する必要があります。

3. 以下のコマンドを実行して CR を作成します。

   $ oc create -f macvlan-conf.yaml

1. 以下の内容を含む openshift-sriov namespace の YAML ファイルを作成します。

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-sriov
     labels:
       name: openshift-sriov
       openshift.io/run-level: "0"
     annotations:
       openshift.io/node-selector: ""
       openshift.io/description: "Openshift SR-IOV network components"

2. 以下のコマンドを実行して、openshift-sriov namespace を作成します。

   $ oc create -f openshift-sriov.yaml

3. 以下の内容を含む sriov-device-plugin サービスアカウントの YAML ファイルを作成します。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: sriov-device-plugin
     namespace: openshift-sriov

4. 以下のコマンドを実行し、sriov-device-plugin サービスアカウントを作成します。

   $ oc create -f sriov-device-plugin.yaml

5. 以下の内容を含む sriov-cni サービスアカウントの YAML ファイルを作成します。

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: sriov-cni
     namespace: openshift-sriov

6. 以下のコマンドを実行し、sriov-cni サービスアカウントを作成します。

   $ oc create -f sriov-cni.yaml

7. 以下の内容を含む sriov-device-plugin DaemonSet の YAML ファイルを作成します。

   注記

   SR-IOV ネットワークデバイスプラグインデーモンは、起動時に各ホストで設定されたすべての (サポートされている NIC モデルの) SR-IOV VF を検出し、検出されたリソースを公開します。割り当てることのできる利用可能な SR-IOV VF リソースの数は、oc describe node <node-name> コマンドでノードを記述して確認できます。SR-IOV VF リソースのリソース名は openshift.io/sriov です。ノードで利用可能な SR-IOV VF がない場合、ゼロ (0) の値が表示されます。

   kind: DaemonSet
   apiVersion: apps/v1
   metadata:
     name: sriov-device-plugin
     namespace: openshift-sriov
     annotations:
       kubernetes.io/description: |
         This daemon set launches the SR-IOV network device plugin on each node.
   spec:
     selector:
       matchLabels:
         app: sriov-device-plugin
     updateStrategy:
       type: RollingUpdate
     template:
       metadata:
         labels:
           app: sriov-device-plugin
           component: network
           type: infra
           openshift.io/component: network
       spec:
         hostNetwork: true
         nodeSelector:
           beta.kubernetes.io/os: linux
         tolerations:
         - operator: Exists
         serviceAccountName: sriov-device-plugin
         containers:
         - name: sriov-device-plugin
           image: quay.io/openshift/ose-sriov-network-device-plugin:v4.0.0
           args:
           - --log-level=10
           securityContext:
             privileged: true
           volumeMounts:
           - name: devicesock
             mountPath: /var/lib/kubelet/
             readOnly: false
           - name: net
             mountPath: /sys/class/net
             readOnly: true
         volumes:
           - name: devicesock
             hostPath:
               path: /var/lib/kubelet/
           - name: net
             hostPath:
               path: /sys/class/net

8. 以下のコマンドを実行し、sriov-device-plugin DaemonSet を作成します。

   oc create -f sriov-device-plugin.yaml

9. 以下の内容を含む sriov-cni DaemonSet の YAML ファイルを作成します。

   kind: DaemonSet
   apiVersion: apps/v1
   metadata:
     name: sriov-cni
     namespace: openshift-sriov
     annotations:
       kubernetes.io/description: |
         This daemon set launches the SR-IOV CNI plugin on SR-IOV capable worker nodes.
   spec:
     selector:
       matchLabels:
         app: sriov-cni
     updateStrategy:
       type: RollingUpdate
     template:
       metadata:
         labels:
           app: sriov-cni
           component: network
           type: infra
           openshift.io/component: network
       spec:
         nodeSelector:
           beta.kubernetes.io/os: linux
         tolerations:
         - operator: Exists
         serviceAccountName: sriov-cni
         containers:
         - name: sriov-cni
           image: quay.io/openshift/ose-sriov-cni:v4.0.0
           securityContext:
             privileged: true
           volumeMounts:
           - name: cnibin
             mountPath: /host/opt/cni/bin
         volumes:
           - name: cnibin
             hostPath:
               path: /var/lib/cni/bin

10. 以下のコマンドを実行し、sriov-cni DaemonSet を作成します。

    $ oc create -f sriov-cni.yaml

1. SR-IOV 設定を使用してカスタムリソース (CR) の YAML ファイルを作成します。以下の CR の name フィールドには、値 sriov-conf が含まれます。

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: sriov-conf
     annotations:
       k8s.v1.cni.cncf.io/resourceName: openshift.io/sriov 1
   spec:
     config: '{
         "type": "sriov", 2
         "name": "sriov-conf",
         "ipam": {
           "type": "host-local",
           "subnet": "10.56.217.0/24",
           "routes": [{
             "dst": "0.0.0.0/0"
           }],
           "gateway": "10.56.217.1"
         }
       }'

   1

   k8s.v1.cni.cncf.io/resourceName アノテーションは openshift.io/sriov に設定されます。

   2

   type は sriov に設定されます。

2. 以下のコマンドを実行して、sriov-conf CR を作成します。

   $ oc create -f sriov-conf.yaml

3. NetworkAttachmentDefinition の名前を参照し、1 つの openshift.io/sriov リソースを参照する Pod の YAML ファイルを作成します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: sriovsamplepod
     annotations:
       k8s.v1.cni.cncf.io/networks: sriov-conf
   spec:
     containers:
     - name: sriovsamplepod
       command: ["/bin/bash", "-c", "sleep 2000000000000"]
       image: centos/tools
       resources:
         requests:
           openshift.io/sriov: '1'
         limits:
           openshift.io/sriov: '1'

4. 以下のコマンドを実行して sriovsamplepod Pod を作成します。

   $ oc create -f sriovsamplepod.yaml

5. ip コマンドを実行して、追加のインターフェースを表示します。

   $ oc exec sriovsamplepod -- ip a

手順

1. cluster-admin 権限を持つユーザーとしてのログイン。

2. デフォルトのプロジェクトテンプレートを生成します。

   $ oc adm create-bootstrap-project-template -o yaml > template.yaml

3. オブジェクトを追加するか、または既存オブジェクトを変更することにより、テキストエディターで生成される template.yaml ファイルを変更します。

4. プロジェクトテンプレートは、openshift-config namespace に作成される必要があります。変更したテンプレートを読み込みます。

   $ oc create -f template.yaml -n openshift-config

5. Web コンソールまたは CLI を使用し、プロジェクト設定リソースを編集します。

   • Web コンソールの使用

     1. Administration → Cluster Settings ページに移動します。
     2. Global Configuration をクリックし、すべての設定リソースを表示します。
     3. Project のエントリーを見つけ、Edit YAML をクリックします。

   • CLI の使用

     1. project.config.openshift.io/cluster リソースを編集します。

        $ oc edit project.config.openshift.io/cluster

6. spec セクションを、projectRequestTemplate および name パラメーターを組み込むように更新し、アップロードされたプロジェクトテンプレートの名前を設定します。デフォルト名は project-request です。

   カスタムプロジェクトテンプレートを含むプロジェクト設定リソース

   apiVersion: config.openshift.io/v1
   kind: Project
   metadata:
     ...
   spec:
     projectRequestTemplate:
       name: <template_name>

7. 変更を保存した後、変更が正常に適用されたことを確認するために、新しいプロジェクトを作成します。

手順

1. 以下のコマンドを実行して、新規プロジェクトのデフォルトテンプレートを編集します。

   $ oc edit template <project_template> -n openshift-config

   <project_template> を、クラスターに設定したデフォルトテンプレートの名前に置き換えます。デフォルトのテンプレート名は project-request です。

2. テンプレートでは、各 NetworkPolicy オブジェクトを要素として objects パラメーターに追加します。objects パラメーターは、1 つ以上のオブジェクトのコレクションを受け入れます。

   以下の例では、objects パラメーターのコレクションにいくつかの NetworkPolicy オブジェクトが含まれます。

   objects:
   - apiVersion: networking.k8s.io/v1
     kind: NetworkPolicy
     metadata:
       name: allow-from-same-namespace
     spec:
       podSelector:
       ingress:
       - from:
         - podSelector: {}
   - apiVersion: networking.k8s.io/v1
     kind: NetworkPolicy
     metadata:
       name: allow-from-openshift-ingress
     spec:
       ingress:
       - from:
         - namespaceSelector:
             matchLabels:
               network.openshift.io/policy-group: ingress
       podSelector: {}
       policyTypes:
       - Ingress
   ...

3. オプション: 以下のコマンドを実行して、新規プロジェクトを作成し、ネットワークポリシーオブジェクトが正常に作成されることを確認します。

   1. 新規プロジェクトを作成します。

      $ oc new-project <project> 1

      1

      <project> を、作成しているプロジェクトの名前に置き換えます。

   2. 新規プロジェクトテンプレートのネットワークポリシーオブジェクトが新規プロジェクトに存在することを確認します。

      $ oc get networkpolicy
      NAME                           POD-SELECTOR   AGE
      allow-from-openshift-ingress   <none>         7s
      allow-from-same-namespace      <none>         7s

手順

1. 以下の JSON を使用して、NetNamespace リソースを egress IP アドレスで更新します。

    $ oc patch netnamespace <project_name> --type=merge -p \ 1
     '{
       "egressIPs": [
         "<ip_address>" 2
       ]
     }'

   1

   プロジェクトのターゲットを指定します。

   2

   単一 egress IP アドレスを指定します。複数の IP アドレスの使用はサポートされません。

   たとえば、project1 を IP アドレスの 192.168.1.100 に、project2 を IP アドレスの 192.168.1.101 に割り当てるには、以下を実行します。

   $ oc patch netnamespace project1 --type=merge -p \
     '{"egressIPs": ["192.168.1.100"]}'
   $ oc patch netnamespace project2 --type=merge -p \
     '{"egressIPs": ["192.168.1.101"]}'

2. 以下の JSON を使用して、各ホストの egressCIDRs パラメーターを設定して egress IP アドレスをホストできるノードを示します。

   $ oc patch hostsubnet <node_name> --type=merge -p \ 1
     '{
       "egressCIDRs": [
         "<ip_address_range_1>", "<ip_address_range_2>" 2
       ]
     }'

   1

   ノード名を指定します。

   2

   CIDR 形式で 1 つ以上の IP アドレス範囲を指定します。

   たとえば、node1 および node2 を、192.168.1.0 から 192.168.1.255 の範囲で egress IP アドレスをホストするように設定するには、以下を実行します。

   $ oc patch hostsubnet node1 --type=merge -p \
     '{"egressCIDRs": ["192.168.1.0/24"]}'
   $ oc patch hostsubnet node2 --type=merge -p \
     '{"egressCIDRs": ["192.168.1.0/24"]}'

   OpenShift Container Platform はバランスを取りながら特定の egress IP アドレスを利用可能なノードに自動的に割り当てます。この場合、egress IP アドレス 192.168.1.100 を node1 に、egress IP アドレス 192.168.1.101 を node2 に割り当て、その逆も行います。

手順

1. 以下の JSON オブジェクトを必要な IP アドレスで指定して、NetNamespace リソースを更新します。

   $ oc patch netnamespace <project> --type=merge -p \ 1
     '{
       "egressIPs": [ 2
         "<ip_address>"
         ]
     }'

   1

   プロジェクトのターゲットを指定します。

   2

   1 つ以上の egress IP アドレスを指定します。egressIPs パラメーターは配列です。

   たとえば、project1 プロジェクトを 192.168.1.100 の IP アドレスに割り当てるには、以下を実行します。

   $ oc patch netnamespace project1 --type=merge \
     -p '{"egressIPs": ["192.168.1.100"]}'

   egressIPs を異なるノードの 2 つ以上の IP アドレスに設定し、高可用性を確保することができます。複数の egress IP アドレスが設定される場合、Pod は egress の一覧にある最初の IP を使用しますが、IP アドレスをホストするノードが失敗する場合、Pod は短時間の遅延の後に一覧にある次の IP の使用に切り替えます。

2. egress IP をノードホストに手動で割り当てます。egressIPs パラメーターを、ノードホストの HostSubnet オブジェクトに設定します。以下の JSON を使用して、そのノードホストに割り当てる必要のある任意の数の IP を含めることができます。

   $ oc patch hostsubnet <node_name> --type=merge -p \ 1
     '{
       "egressIPs": [ 2
         "<ip_address_1>",
         "<ip_address_N>"
         ]
     }'

   1

   プロジェクトのターゲットを指定します。

   2

   1 つ以上の egress IP アドレスを指定します。egressIPs フィールドは配列です。

   たとえば、node1 に Egress IP 192.168.1.100、 192.168.1.101、および 192.168.1.102 が設定されるように指定するには、以下を実行します。

   $ oc patch hostsubnet node1 --type=merge -p \
     '{"egressIPs": ["192.168.1.100", "192.168.1.101", "192.168.1.102"]}'

   直前の例では、project1 のすべての egress トラフィックは、指定された egress IP をホストするノードにルーティングされてから、その IP アドレスに (NAT を使用して) 接続されます。

手順

1. ポリシールールを作成します。

   1. <policy-name>.yaml ファイルを作成します。 この場合、<policy-name> は egress ポリシールールを記述します。
   2. 作成したファイルで、egress ポリシーオブジェクトを定義します。

2. 以下のコマンドを入力してポリシーオブジェクトを作成します。

   $ oc create -f <policy-name>.yaml -n <project>

   以下の例では、新規の EgressNetworkPolicy オブジェクトが project1 という名前のプロジェクトに作成されます。

   $ oc create -f default-rules.yaml -n project1
   egressnetworkpolicy.network.openshift.io/default-rules created

3. オプション: 後に変更できるように <policy-name>.yaml を保存します。

1. プロジェクトの EgressNetworkPolicy オブジェクトの名前を検索します。<project> をプロジェクトの名前に置き換えます。

   $ oc get -n <project> egressnetworkpolicy

2. オプションとして、egress ネットワークファイアウォールの作成時に EgressNetworkPolicy オブジェクトのコピーを保存しなかった場合には、以下のコマンドを入力してコピーを作成します。

   $ oc get -n <project> \ 1
     egressnetworkpolicy <name> \ 2
     -o yaml > <filename>.yaml 3

   1

   <project> をプロジェクトの名前に置き換えます。

   2

   <name> をオブジェクトの名前に置き換えます。

   3

   <filename> をファイルの名前に置き換え、YAML を保存します。

3. 以下のコマンドを入力し、EgressNetworkPolicy オブジェクトを置き換えます。<filename> を、更新された EgressNetworkPolicy オブジェクトを含むファイルの名前に置き換えます。

   $ oc replace -f <filename>.yaml

1. プロジェクトの EgressNetworkPolicy オブジェクトの名前を検索します。<project> をプロジェクトの名前に置き換えます。

   $ oc get -n <project> egressnetworkpolicy

2. 以下のコマンドを入力し、EgressNetworkPolicy オブジェクトを削除します。<project> をプロジェクトの名前に、 <name> をオブジェクトの名前に置き換えます。

   $ oc delete -n <project> egressnetworkpolicy <name>

手順

1. 以下のコマンドを使用して、プロジェクトを既存のプロジェクトネットワークに参加させます。

   $ oc adm pod-network join-projects --to=<project1> <project2> <project3>

   または、特定のプロジェクト名を指定する代わりに --selector=<project_selector> オプションを使用し、関連付けられたラベルに基づいてプロジェクトを指定できます。

2. オプション: 以下のコマンドを実行し、結合した Pod ネットワークを表示します。

   $ oc get netnamespaces

   同じ Pod ネットワークのプロジェクトには、NETID 列に同じネットワーク ID があります。

手順

1. 以下のコマンドを実行して、Network.operator.openshift.io カスタムリソース (CR) を編集します。

   $ oc edit network.operator.openshift.io cluster

2. 以下のサンプル CR のように、kube-proxy 設定への変更内容で、CR のkubeProxyConfig パラメーターを変更します。

   apiVersion: operator.openshift.io/v1
   kind: Network
   metadata:
     name: cluster
   spec:
     kubeProxyConfig:
       iptablesSyncPeriod: 30s
       proxyArguments:
         iptables-min-sync-period: ["30s"]

3. ファイルを保存し、テキストエディターを編集します。

   構文は、ファイルを保存し、エディターを終了する際に oc コマンドによって検証されます。変更内容に構文エラーが含まれる場合、エディターはファイルを開き、エラーメッセージを表示します。

4. 以下のコマンドを実行して、設定の更新を確認します。

   $ oc get networks.operator.openshift.io -o yaml

   コマンドは、以下の例のような出力を返します。

   apiVersion: v1
   items:
   - apiVersion: operator.openshift.io/v1
     kind: Network
     metadata:
       name: cluster
     spec:
       clusterNetwork:
       - cidr: 10.128.0.0/14
         hostPrefix: 23
       defaultNetwork:
         type: OpenShiftSDN
       kubeProxyConfig:
         iptablesSyncPeriod: 30s
         proxyArguments:
           iptables-min-sync-period:
           - 30s
       serviceNetwork:
       - 172.30.0.0/16
     status: {}
   kind: List

5. オプション: 以下のコマンドを実行し、Cluster Network Operator が設定変更を受け入れていることを確認します。

   $ oc get clusteroperator network
   NAME      VERSION     AVAILABLE   PROGRESSING   DEGRADED   SINCE
   network   4.1.0-0.9   True        False         False      1m

   設定の更新が正常に適用されると、AVAILABLE フィールドが True になります。

手順

1. oc annotate コマンドを使用して、ルートにタイムアウトを追加します。

   $ oc annotate route <route_name> \
       --overwrite haproxy.router.openshift.io/timeout=<timeout><time_unit> 1

   1

   サポートされる時間単位は、マイクロ秒 (us)、ミリ秒 (ms)、秒 (s)、分 (m)、時間 (h)、または日 (d) です。

   以下の例では、2 秒のタイムアウトを myroute という名前のルートに設定します。

   $ oc annotate route myroute --overwrite haproxy.router.openshift.io/timeout=2s

手順

1. サービスの新規プロジェクトを作成します。

   $ oc new-project <project_name>

   例:

   $ oc new-project myproject

2. oc new-app コマンドを使用してサービスを作成します。以下は例になります。

   $ oc new-app \
       -e MYSQL_USER=admin \
       -e MYSQL_PASSWORD=redhat \
       -e MYSQL_DATABASE=mysqldb \
       registry.redhat.io/rhscl/mysql-80-rhel7

3. 以下のコマンドを実行して新規サービスが作成されていることを確認します。

   $ oc get svc -n myproject
   NAME             TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   mysql-80-rhel7   ClusterIP   172.30.63.31   <none>        3306/TCP   4m55s

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

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

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

   $ oc project project1

3. 以下のコマンドを実行してルートを公開します。

   $ oc expose service <service_name>

   例:

   $ oc expose service mysql-80-rhel7
   route "mysql-80-rhel7" exposed

4. cURL などのツールを使用し、サービスのクラスター IP アドレスを使用してサービスに到達できることを確認します。

   $ curl <pod_ip>:<port>

   例:

   $ curl 172.30.131.89:3306

   このセクションの例では、クライアントアプリケーションを必要とする MySQL サービスを使用しています。Got packets out of order のメッセージと共に文字ストリングを取得する場合は、このサービスに接続されていることになります。

   MySQL クライアントがある場合は、標準 CLI コマンドでログインします。

   $ mysql -h 172.30.131.89 -u admin -p
   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

手順

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>
       nodePlacement:
         nodeSelector:
           matchLabels:
             node-role.kubernetes.io/worker: ""
       routeSelector:
         matchLabels:
           type: sharded
     status: {}
   kind: List
   metadata:
     resourceVersion: ""
     selfLink: ""

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

   # oc apply -f router-internal.yaml

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

手順

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>
       nodePlacement:
         nodeSelector:
           matchLabels:
             node-role.kubernetes.io/worker: ""
       namespaceSelector:
         matchLabels:
           type: sharded
     status: {}
   kind: List
   metadata:
     resourceVersion: ""
     selfLink: ""

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

   # oc apply -f router-internal.yaml

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

手順

1. サービスの新規プロジェクトを作成します。

   $ oc new-project <project_name>

   例:

   $ oc new-project myproject

2. oc new-app コマンドを使用してサービスを作成します。以下は例になります。

   $ oc new-app \
       -e MYSQL_USER=admin \
       -e MYSQL_PASSWORD=redhat \
       -e MYSQL_DATABASE=mysqldb \
       registry.redhat.io/rhscl/mysql-80-rhel7

3. 以下のコマンドを実行して新規サービスが作成されていることを確認します。

   $ oc get svc -n myproject
   NAME             TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   mysql-80-rhel7   ClusterIP   172.30.63.31   <none>        3306/TCP   4m55s

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

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

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

   $ oc project project1

3. 以下のコマンドを実行してルートを公開します。

   $ oc expose service <service_name>

   例:

   $ oc expose service mysql-80-rhel7
   route "mysql-80-rhel7" exposed

4. cURL などのツールを使用し、サービスのクラスター IP アドレスを使用してサービスに到達できることを確認します。

   $ curl <pod_ip>:<port>

   例:

   $ curl 172.30.131.89:3306

   このセクションの例では、クライアントアプリケーションを必要とする MySQL サービスを使用しています。Got packets out of order のメッセージと共に文字ストリングを取得する場合は、このサービスに接続されていることになります。

   MySQL クライアントがある場合は、標準 CLI コマンドでログインします。

   $ mysql -h 172.30.131.89 -u admin -p
   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

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

2. 公開するサービスが置かれているプロジェクトを読み込みます。

   $ oc project project1

3. マスターノードでテキストファイルを開き、以下のテキストを貼り付け、必要に応じてファイルを編集します。

   ロードバランサー設定ファイルのサンプル

   apiVersion: v1
   kind: Service
   metadata:
     name: egress-2 1
   spec:
     ports:
     - name: db
       port: 3306 2
     loadBalancerIP:
     type: LoadBalancer 3
     selector:
       name: mysql 4

   1

   ロードバランサーサービスの説明となる名前を入力します。

   2

   公開するサービスがリッスンしている同じポートを入力します。

   3

   タイプに loadbalancer を入力します。

   4

   サービスの名前を入力します。

4. ファイルを保存し、終了します。

5. 以下のコマンドを実行してサービスを作成します。

   oc create -f <file-name>

   例:

   oc create -f mysql-lb.yaml

6. 以下のコマンドを実行して新規サービスを表示します。

   $ oc get svc
   NAME       TYPE           CLUSTER-IP      EXTERNAL-IP                             PORT(S)          AGE
   egress-2   LoadBalancer   172.30.22.226   ad42f5d8b303045-487804948.example.com   3306:30357/TCP   15m

   有効にされたクラウドプロバイダーがある場合、サービスには外部 IP アドレスが自動的に割り当てられます。

7. マスターで cURL などのツールを使用し、パブリック IP アドレスを使用してサービスに到達できることを確認します。

   $ curl <public-ip>:<port>

   例:

   $ curl 172.29.121.74:3306

   このセクションの例では、クライアントアプリケーションを必要とする MySQL サービスを使用しています。Got packets out of order のメッセージと共に文字ストリングを取得する場合は、このサービスに接続していることになります。

   MySQL クライアントがある場合は、標準 CLI コマンドでログインします。

   $ mysql -h 172.30.131.89 -u admin -p
   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

手順

1. サービスの新規プロジェクトを作成します。

   $ oc new-project <project_name>

   例:

   $ oc new-project myproject

2. oc new-app コマンドを使用してサービスを作成します。以下は例になります。

   $ oc new-app \
       -e MYSQL_USER=admin \
       -e MYSQL_PASSWORD=redhat \
       -e MYSQL_DATABASE=mysqldb \
       registry.redhat.io/rhscl/mysql-80-rhel7

3. 以下のコマンドを実行して新規サービスが作成されていることを確認します。

   $ oc get svc -n myproject
   NAME             TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   mysql-80-rhel7   ClusterIP   172.30.63.31   <none>        3306/TCP   4m55s

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

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

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

   $ oc project project1

3. 以下のコマンドを実行してルートを公開します。

   $ oc expose service <service_name>

   例:

   $ oc expose service mysql-80-rhel7
   route "mysql-80-rhel7" exposed

4. cURL などのツールを使用し、サービスのクラスター IP アドレスを使用してサービスに到達できることを確認します。

   $ curl <pod_ip>:<port>

   例:

   $ curl 172.30.131.89:3306

   このセクションの例では、クライアントアプリケーションを必要とする MySQL サービスを使用しています。Got packets out of order のメッセージと共に文字ストリングを取得する場合は、このサービスに接続されていることになります。

   MySQL クライアントがある場合は、標準 CLI コマンドでログインします。

   $ mysql -h 172.30.131.89 -u admin -p
   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

手順

1. サービスの新規プロジェクトを作成します。

   $ oc new-project <project_name>

   例:

   $ oc new-project myproject

2. oc new-app コマンドを使用してサービスを作成します。以下は例になります。

   $ oc new-app \
       -e MYSQL_USER=admin \
       -e MYSQL_PASSWORD=redhat \
       -e MYSQL_DATABASE=mysqldb \
       registry.redhat.io/rhscl/mysql-80-rhel7

3. 以下のコマンドを実行して新規サービスが作成されていることを確認します。

   $ oc get svc -n myproject
   NAME             TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)    AGE
   mysql-80-rhel7   ClusterIP   172.30.63.31   <none>        3306/TCP   4m55s

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

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

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

   $ oc project project1

3. アプリケーションのノードポートを公開するには、以下のコマンドを入力します。OpenShift Container Platform は 30000-32767 範囲の利用可能なポートを自動的に選択します。

   $ oc expose dc mysql-80-rhel7 --type=NodePort --name=mysql-ingress

4. オプション: サービスが公開されるノードポートで利用可能なことを確認するには、以下のコマンドを入力します。

   $ oc get svc -n myproject
   NAME             TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
   mysql-80-rhel7   ClusterIP   172.30.217.127   <none>        3306/TCP         9m44s
   mysql-ingress    NodePort    172.30.107.72    <none>        3306:31345/TCP   39s

5. オプション: oc new-app コマンドによって自動的に作成されたサービスを削除するには、以下のコマンドを入力します。

   $ oc delete svc mysql-80-rhel7