26.2. MetalLB Operator のインストール

手順

1. OpenShift Container Platform Web コンソールにログインします。

2. オプション: MetalLB Operator に必要な namespace を作成します。

   注記

   この段階で namespace を作成するか、MetalLB Operator のインストールを開始するときに作成するかを選択できます。Installed Namespace リストから、プロジェクトを作成できます。

   1. Administration Namespaces に移動し、Create Namespace をクリックします。
   2. Name フィールドに metallb-system と入力し、Create をクリックします。

3. MetalLB Operator をインストールします。

   1. OpenShift Container Platform Web コンソールで、Operators OperatorHub をクリックします。

   2. Filter by keyword フィールドに metallb と入力して、MetalLB Operator を検索し、Install をクリックします。

      また、インフラストラクチャー機能 でオプションをフィルターすることもできます。たとえば、非接続環境 (ネットワークが制限された環境ともしても知られる) で機能する Operator を表示するには、Disconnected を選択します。

   3. Install Operator ページで、a specific namespace on the cluster を選択します。前のセクションで作成した namespace を選択するか、metallb-system プロジェクトを作成することを選択して、Install をクリックします。

1. Operators Installed Operators ページに移動します。

2. MetalLB Operator が Succeeded の Status で metallb-system プロジェクトにリストされていることを確認します。

   注記

   インストール時に、Operator は Failed ステータスを表示する可能性があります。その後インストールが成功し、Succeeded メッセージが表示された場合は、Failed メッセージを無視できます。

3. Operator のインストールが成功しない場合は、さらにトラブルシューティングを行うことができます。

   1. Operators Installed Operators ページに移動し、Operator Subscriptions および Install Plans タブで Status にエラーがあるかどうかを検査します。
   2. Workloads Pods ページに移動し、metallb-system プロジェクトの Pod のログを確認します。

手順

1. MetalLB Operator が利用可能であることを確認します。

   $ oc get packagemanifests -n openshift-marketplace metallb-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME               CATALOG                AGE
   metallb-operator   Red Hat Operators      9h

   Copy to Clipboard Toggle word wrap

2. metallb-system namespace を作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: metallb-system
   EOF

   Copy to Clipboard Toggle word wrap

3. オプション: BGP および BFD メトリックが Prometheus に表示されるようにするには、次のコマンドのように namespace にラベルを付けることができます。

   $ oc label ns metallb-system "openshift.io/cluster-monitoring=true"

   Copy to Clipboard Toggle word wrap

4. namespace に Operator グループのカスタムリソースを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: metallb-operator
     namespace: metallb-system
   spec:
     targetNamespaces:
     - metallb-system
   EOF

   Copy to Clipboard Toggle word wrap

5. Operator グループが namespace にインストールされていることを確認します。

   $ oc get operatorgroup -n metallb-system

   Copy to Clipboard Toggle word wrap

   出力例

   NAME               AGE
   metallb-operator   14m

   Copy to Clipboard Toggle word wrap

6. MetalLB Operator にサブスクライブします。

   1. 以下のコマンドを実行して OpenShift Container Platform のメジャーおよびマイナーバージョンを取得します。値を使用して、次の手順で channel 値を設定します。

      $ OC_VERSION=$(oc version -o yaml | grep openshiftVersion | \
          grep -o '[0-9]*[.][0-9]*' | head -1)

      Copy to Clipboard Toggle word wrap

   2. Operator のサブスクリプションカスタムリソースを作成するには、以下のコマンドを入力します。

      $ cat << EOF| oc apply -f -
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: metallb-operator-sub
        namespace: metallb-system
      spec:
        channel: "${OC_VERSION}"
        name: metallb-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace
      EOF

      Copy to Clipboard Toggle word wrap

7. インストール計画が namespace にあることを確認します。

   $ oc get installplan -n metallb-system

   Copy to Clipboard Toggle word wrap

   出力例

   NAME            CSV                                                 APPROVAL    APPROVED
   install-wzg94   metallb-operator.4.10.0-nnnnnnnnnnnn   Automatic   true

   Copy to Clipboard Toggle word wrap

8. Operator がインストールされていることを確認するには、以下のコマンドを入力します。

   $ oc get clusterserviceversion -n metallb-system \
     -o custom-columns=Name:.metadata.name,Phase:.status.phase

   Copy to Clipboard Toggle word wrap

   出力例

   Name                                                Phase
   metallb-operator.4.10.0-nnnnnnnnnnnn   Succeeded

   Copy to Clipboard Toggle word wrap

手順

1. MetalLB カスタムリソースの単一のインスタンスを作成します。

   $ cat << EOF | oc apply -f -
   apiVersion: metallb.io/v1beta1
   kind: MetalLB
   metadata:
     name: metallb
     namespace: metallb-system
   EOF

   Copy to Clipboard Toggle word wrap

1. コントローラーのデプロイメントが稼働していることを確認します。

   $ oc get deployment -n metallb-system controller

   Copy to Clipboard Toggle word wrap

   出力例

   NAME         READY   UP-TO-DATE   AVAILABLE   AGE
   controller   1/1     1            1           11m

   Copy to Clipboard Toggle word wrap

2. スピーカーに設定されているデーモンが実行していることを確認します。

   $ oc get daemonset -n metallb-system speaker

   Copy to Clipboard Toggle word wrap

   出力例

   NAME      DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR            AGE
   speaker   6         6         6       6            6           kubernetes.io/os=linux   18m

   Copy to Clipboard Toggle word wrap

   この出力例は、6 つの speaker Pod を示しています。クラスターの speaker Pod の数は出力例とは異なる場合があります。出力で各ノードの 1 つの Pod が表示されることを確認します。