3.3. 使用 CLI 安装 Cluster Logging Operator

您可以使用 OpenShift Container Platform CLI 安装 Cluster Logging Operator。Cluster Logging Operator 负责创建并管理日志记录堆栈的组件。

流程

使用 CLI 安装 Cluster Logging Operator：

为 Cluster Logging Operator 创建命名空间：

为 Cluster Logging Operator 创建一个命名空间对象 YAML 文件（例如，clo-namespace.yaml）：

apiVersion: v1
kind: Namespace
metadata:
  name: openshift-logging
  annotations:
    openshift.io/node-selector: ""
  labels:
    openshift.io/cluster-monitoring: "true"

创建命名空间：

$ oc create -f <file-name>.yaml

例如：

$ oc create -f clo-namespace.yaml

通过创建以下对象来安装 Cluster Logging Operator：
1. 为 Cluster Logging Operator 创建一个 OperatorGroup 对象 YAML 文件（例如，clo-og.yaml）：
```
apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: cluster-logging
  namespace: openshift-logging 1
spec:
  targetNamespaces:
  - openshift-logging 2
```
  1 2
  您必须指定 openshift-logging 命名空间。
2. 创建 OperatorGroup 对象：
```
$ oc create -f <file-name>.yaml
```
  例如：
```
$ oc create -f clo-og.yaml
```
3. 创建一个 Subscription 对象 YAML 文件（例如，clo-sub.yaml）来向 Operator 订阅一个 Namespace。
  订阅示例
```
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: cluster-logging
  namespace: openshift-logging 1
spec:
  channel: "4.3" 2
  name: cluster-logging
  source: redhat-operators 3
  sourceNamespace: openshift-marketplace
```
  1
  您必须指定 openshift-logging 命名空间。
  2
  指定 4.3 作为频道。
  3
  指定 redhat-operators。如果 OpenShift Container Platform 集群安装在受限网络中（也称为断开连接的集群），请指定配置 Operator Lifecycle Manager (OLM) 时创建的 CatalogSource 对象的名称。
4. 创建订阅对象：
```
$ oc create -f <file-name>.yaml
```
  例如：
```
$ oc create -f clo-sub.yaml
```
  Cluster Logging Operator 已安装到 openshift-logging 命名空间。

验证 Operator 安装：

在 openshift-logging 命名空间中应该有一个 Cluster Logging Operator。版本号可能与所示不同。

oc get csv --all-namespaces

NAMESPACE                                               NAME                                         DISPLAY                  VERSION               REPLACES   PHASE
...
openshift-logging                                       clusterlogging.4.3.1-202002032140            Cluster Logging          4.3.1-202002032140               Succeeded
...

创建集群日志记录（Cluster Logging）实例：
1. 为 Cluster Logging Operator 创建实例对象 YAML 文件（如 clo-instance.yaml）：
  注意
  此默认集群日志记录配置应该可以支持不同的环境。请参考有关调优和配置集群日志记录组件的主题，以了解有关可对集群日志记录集群进行修改的信息。
```
apiVersion: "logging.openshift.io/v1"
kind: "ClusterLogging"
metadata:
  name: "instance" 1
  namespace: "openshift-logging"
spec:
  managementState: "Managed"  2
  logStore:
    type: "elasticsearch"  3
    elasticsearch:
      nodeCount: 3 4
      storage:
        storageClassName: "<storage-class-name>" 5
        size: 200G
      redundancyPolicy: "SingleRedundancy"
  visualization:
    type: "kibana"  6
    kibana:
      replicas: 1
  curation:
    type: "curator"  7
    curator:
      schedule: "30 3 * * *"
  collection:
    logs:
      type: "fluentd"  8
      fluentd: {}
```
  1
  名称必须是 instance。
  2
  集群日志记录管理状态。在大多数情况下，如果更改了集群日志记录的默认值，则必须将其设置为 Unmanaged。但是，在 Cluster Logging 返回到 Managed 状态前，非受管部署不接收更新。如需更多信息，请参阅更改集群日志记录管理状态。
  3
  用于配置 Elasticsearch 的设置。通过使用子定义资源（CR），您可以配置分片复制策略和持久性存储。如需更多信息，请参阅配置 Elasticsearch。
  4
  指定 Elasticsearch 节点的数量。请参阅此列表后面的备注。
  5
  为 Elasticsearch 存储输入现有 StorageClass 的名称。为获得最佳性能，请指定分配块存储的 StorageClass。
  6
  用于配置 Kibana 的设置。通过使用 CR，您可以扩展 Kibana 来实现冗余性，并为 Kibana 节点配置 CPU 和内存。如需更多信息，请参阅配置 Kibana。
  7
  用于配置 Curator 的设置。通过使用 CR，您可以设置 Curator 调度。如需更多信息，请参阅配置 Curator。
  8
  用于配置 Fluentd 的设置。通过使用 CR，您可以配置 Fluentd CPU 和内存限值。如需更多信息，请参阅配置 Fluentd。
  注意
  Elasticsearch master 节点的最大数量为三个。如果您将 nodeCount 指定为大于 3，OpenShift Container Platform 只会创建三个符合 Master 节点条件的 Elasticsearch 节点（具有 master、client 和 data 角色）。其余 Elasticsearch 节点创建为“仅数据”节点，使用 client 和 data 角色。Master 节点执行集群范围的操作，如创建或删除索引、分配分片和跟踪节点等。数据节点保管分片，并执行与数据相关的操作，如 CRUD、搜索和聚合等。与数据相关的操作会占用大量 I/O、内存和 CPU。务必要监控这些资源，并在当前节点过载时添加更多数据节点。
  例如，如果 nodeCount = 4，则创建以下节点：
```
$ oc get deployment

cluster-logging-operator       1/1     1            1           18h
elasticsearch-cd-x6kdekli-1    1/1     1            0           6m54s
elasticsearch-cdm-x6kdekli-1   1/1     1            1           18h
elasticsearch-cdm-x6kdekli-2   1/1     1            0           6m49s
elasticsearch-cdm-x6kdekli-3   1/1     1            0           6m44s
```
  索引模板的主分片数量等于 Elasticsearch 数据节点的数目。
2. 创建实例：
```
$ oc create -f <file-name>.yaml
```
  例如：
```
$ oc create -f clo-instance.yaml
```

通过列出 openshift-logging 项目中的 Pod 来验证安装。

您应该会看到几个用于 Cluster Logging、Elasticsearch、Fluentd 和 Kibana 的 Pod，类似于以下内容：

oc get pods -n openshift-logging

NAME                                            READY   STATUS    RESTARTS   AGE
cluster-logging-operator-66f77ffccb-ppzbg       1/1     Running   0          7m
elasticsearch-cdm-ftuhduuw-1-ffc4b9566-q6bhp    2/2     Running   0          2m40s
elasticsearch-cdm-ftuhduuw-2-7b4994dbfc-rd2gc   2/2     Running   0          2m36s
elasticsearch-cdm-ftuhduuw-3-84b5ff7ff8-gqnm2   2/2     Running   0          2m4s
fluentd-587vb                                   1/1     Running   0          2m26s
fluentd-7mpb9                                   1/1     Running   0          2m30s
fluentd-flm6j                                   1/1     Running   0          2m33s
fluentd-gn4rn                                   1/1     Running   0          2m26s
fluentd-nlgb6                                   1/1     Running   0          2m30s
fluentd-snpkt                                   1/1     Running   0          2m28s
kibana-d6d5668c5-rppqm                          2/2     Running   0          2m39s

3.3. 使用 CLI 安装 Cluster Logging Operator

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Red Hat legal and privacy links

Red Hat legal and privacy links