第 4 章 在集群中添加 Operator

流程

1. 在 Web 控制台中导航至 Operators OperatorHub 页面。

2. 在 Filter by keyword 方框中滚动或键入关键词（本例中为 Couchbase），以查找所需 Operator。

   图 4.1. 通过关键词筛选 Operator

   
3. 选定 Operator。对于社区 Operator 来说，系统会提醒您红帽对这类 Operator 不予认证。您必须确认收到该提醒才可继续。这时会显示 Operator 信息。
4. 阅读 Operator 信息并单击 Install。

5. 在 Create Operator Subscription 页面：

   1. 任选以下一项：

      • All namespaces on the cluster (default)，选择该项会将 Operator 安装至默认 openshift-operators 命名空间，以便供集群中的所有命名空间监视和使用。该选项并非始终可用。
      • A specific namespace on the cluster，该项支持您选择单一特定命名空间来安装 Operator。该 Operator 仅限在该单一命名空间中监视和使用。
   2. 选择一个更新频道（如有多个可用）。
   3. 如前面所述，选择自动或手动批准策略。

6. 单击 Subscribe，以便该 Operator 可供 OpenShift Container Platform 集群上的所选命名空间使用。

   1. 如果选择手动批准策略，则订阅的升级状态将保持正在升级，直至您审核并批准该 Install Plan。

      图 4.2. 在 Install Plan 页面手动批准

      

      在 Install Plan 页面批准后，订阅的升级状态将变为最新。

   2. 如果选择自动批准策略，则升级状态应自动变为最新，而无需人为干预。

      图 4.3. 订阅升级状态：最新

      

7. 当订阅的升级状态变为最新后，选择 Operators Installed Operators 来验证最终是否出现了 Couchbase ClusterServiceVersion (CSV) 且其 Status 在相关命名空间中最终能否解析为 InstallSucceeded。

   注意

   对于 All namespaces… 安装模式，该状态会在 openshift-operators 命名空间中被解析为 InstallSucceeded，但您如果检查其他命名空间，其状态则会变为 Copied。

   如果没有：

   1. 检查“Workloads Pods”页面上的 openshift-operators 项目（或其他相关命名空间，如果选中 A specific namespace… Installation Mode）中报告问题的 Pod 中的日志，以便进一步排除故障。

流程

1. 查看 OperatorHub 中集群可用的 Operator 列表。

   $ oc get packagemanifests -n openshift-marketplace
   NAME                               CATALOG               AGE
   3scale-operator                    Red Hat Operators     91m
   amq-online                         Red Hat Operators     91m
   amq-streams                        Red Hat Operators     91m
   ...
   couchbase-enterprise-certified     Certified Operators   91m
   mariadb                            Certified Operators   91m
   mongodb-enterprise                 Certified Operators   91m
   ...
   etcd                               Community Operators   91m
   jaeger                             Community Operators   91m
   kubefed                            Community Operators   91m
   ...

   注意适用于您所需 Operator 的 CatalogSource。

2. 检查所需 Operator，以验证其支持的 InstallMode 和可用频道：

   $ oc describe packagemanifests <operator_name> -n openshift-marketplace

3. 订阅 Operator 的命名空间必须具有与 Operator 的 InstallMode 相匹配的 OperatorGroup，可采用 AllNamespaces 模式，也可采用 SingleNamespace 模式。如果要安装的 Operator 采用 AllNamespaces 模式，则表明 openshift-operators 命名空间中已有适当的 OperatorGroup。

   如果要安装的 Operator 采用 SingleNamespace 模式，而您没有适当的 OperatorGroup，则必须创建一个。

   注意

   如果选择 SingleNamespace 模式，该流程的 Web 控制台版本会在后台自动为您处理 OperatorGroup 和订阅对象的创建。

   1. 创建 OperatorGroup 对象 YAML 文件，如 operatorgroup.yaml：

      OperatorGroup 示例

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: <operatorgroup_name>
        namespace: <namespace>
      spec:
        targetNamespaces:
        - <namespace>

   2. 创建 OperatorGroup 对象：

      $ oc apply -f operatorgroup.yaml

4. 创建一个订阅对象 YAML 文件，以便为 Operator 订阅一个命名空间，如 sub.yaml：

   订阅示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: <operator_name>
     namespace: openshift-operators 1
   spec:
     channel: alpha
     name: <operator_name> 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   1

   如果使用 AllNamespaces InstallMode，请指定 openshift-operators 命名空间。如果使用 SingleNamespace InstallMode，则指定相关单一命名空间。

   2

   要订阅的 Operator 的名称。

   3

   提供 Operator 的 CatalogSource 的名称。

   4

   CatalogSource 的命名空间。将 openshift-marketplace 用于默认的 OperatorHub CatalogSource。

5. 创建订阅对象：

   $ oc apply -f sub.yaml

   此时，OLM 已了解所选的 Operator。Operator 的 ClusterServiceVersion (CSV) 应出现在目标命名空间中，由 Operator 提供的 API 应可用于创建。