26.2. 安装 MetalLB Operator

流程

1. 登陆到 OpenShift Container Platform Web 控制台。

2. 可选：为 MetalLB Operator 创建所需的命名空间：

   注意

   您可以选择在这个阶段创建命名空间，或者在启动 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 页面中 ，选择集群上的特定命名空间。选择在上一节中创建的命名空间，或选择创建 metallb-system 项目，然后点 Install。

1. 进入到 Operators Installed Operators 页面。

2. 确保 metallb-system 项目中列出的 MetalLB Operator 的 Status 为 Succeeded。

   注意

   在安装过程中，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

   输出示例

   NAME               CATALOG                AGE
   metallb-operator   Red Hat Operators      9h

2. 创建 metallb-system 命名空间：

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

3. 可选： 要确保 BGP 和 BFD 指标出现在 Prometheus 中，您可以使用以下命令标记命名空间：

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

4. 在命名空间中创建一个 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

5. 确认 Operator 组已安装在命名空间中：

   $ oc get operatorgroup -n metallb-system

   输出示例

   NAME               AGE
   metallb-operator   14m

6. 订阅 MetalLB Operator。

   1. 运行以下命令以获取 OpenShift Container Platform 的主版本和次版本。您可以使用这些值来设置下一步中的 channel 值。

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

   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

7. 确认安装计划位于命名空间中：

   $ oc get installplan -n metallb-system

   输出示例

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

8. 要验证是否已安装 Operator，请输入以下命令：

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

   输出示例

   Name                                                Phase
   metallb-operator.4.10.0-nnnnnnnnnnnn   Succeeded

流程

1. 创建 MetalLB 自定义资源的单一实例：

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

1. 检查控制器的部署是否正在运行：

   $ oc get deployment -n metallb-system controller

   输出示例

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

2. 检查 speaker 的守护进程集是否正在运行：

   $ oc get daemonset -n metallb-system speaker

   输出示例

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

   示例输出显示 6 个 speaker Pod。集群中的 speaker pod 数量可能与示例输出不同。确保输出指示集群中每个节点有一个容器集。