10.2. 安装日志存储

流程

1. 在 OpenShift Container Platform Web 控制台 Administrator 视角中，进入 Operators OperatorHub。

2. 在 Filter by keyword 字段中输入 Loki Operator。点可用 Operator 列表中的 Loki Operator，然后点 Install。

   重要

   红帽不支持 Community Loki Operator。

3. 选择 stable 或 stable-x.y 作为 更新频道。

   注意

   stable 频道只为日志记录的最新版本提供更新。要继续获得之前版本的更新，您必须将订阅频道改为 stable-x.y，其中 x.y 代表您安装的日志记录的主版本和次版本。例如，stable-5.7。

   Loki Operator 必须部署到全局 operator 组命名空间 openshift-operators-redhat，因此已选择了 Installation mode 和 Installed Namespace。如果此命名空间不存在，则会为您创建它。

4. 选择 Enable operator-recommended cluster monitoring on this namespace。

   这个选项在 Namespace 对象中设置 openshift.io/cluster-monitoring: "true" 标签。您必须设置这个选项，以确保集群监控提取 openshift-operators-redhat 命名空间。

5. 对于 Update approval，请选择 Automatic，然后点 Install。

   如果订阅中的批准策略被设置为 Automatic，则更新过程会在所选频道中提供新的 Operator 版本时立即启动。如果批准策略设为 Manual，则必须手动批准待处理的更新。

验证

1. 进入 Operators Installed Operators。
2. 确保已选中 openshift-logging 项目。
3. 在 Status 列中，验证您看到了绿色的对勾标记，并为 InstallSucceeded，文本 Up to date。

流程

1. 在 OpenShift Container Platform Web 控制台的 Administrator 视角中进入 Workloads Secrets。
2. 从 Create 下拉列表中选择 From YAML。

3. 创建一个 secret，它使用 access_key_id 和 access_key_secret 字段指定您的凭证和 bucketnames、endpoint 和 region 字段来定义对象存储位置。AWS 在以下示例中使用：

   Secret 对象示例

   apiVersion: v1
   kind: Secret
   metadata:
     name: logging-loki-s3
     namespace: openshift-logging
   stringData:
     access_key_id: AKIAIOSFODNN7EXAMPLE
     access_key_secret: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
     bucketnames: s3-bucket-name
     endpoint: https://s3.eu-central-1.amazonaws.com
     region: eu-central-1

流程

1. 进入 Operators Installed Operators 页面。点 All instances 选项卡。
2. 在 Create new 下拉列表中，选择 LokiStack。

3. 选择 YAML 视图，然后使用以下模板来创建 LokiStack CR：

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki 1
     namespace: openshift-logging
   spec:
     size: 1x.small 2
     storage:
       schemas:
         - effectiveDate: '2023-10-15'
           version: v13
       secret:
         name: logging-loki-s3 3
         type: s3 4
         credentialMode: 5
     storageClassName: <storage_class_name> 6
     tenants:
       mode: openshift-logging

   1

   使用名称 logging-loki。

   2

   指定部署大小。在日志记录 5.8 及更新的版本中，Loki 实例支持的大小选项为 1x.extra-small、1x.small 或 1x.medium。

   3

   指定用于日志存储的 secret。

   4

   指定对应的存储类型。

   5

   可选字段，日志记录 5.9 及更新的版本。支持的用户配置值如下：static 是所有受支持的对象存储类型的默认身份验证模式，使用存储在 Secret 中的凭证。token 是从凭证源检索的短期令牌。在这个模式中，静态配置不包含对象存储所需的凭证。相反，它们会使用服务在运行时生成，允许提供较短的凭证，以及更精细的控制。并不是所有对象存储类型都支持这个身份验证模式。当 Loki 在受管 STS 模式下运行并使用 CCO on STS/WIF 集群时，token-cco 是默认值。

   6

   为临时存储输入存储类的名称。为获得最佳性能，请指定分配块存储的存储类。可以使用 oc get storageclasses 命令列出集群的可用存储类。

流程

1. 创建 Subscription 对象：

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: loki-operator
     namespace: openshift-operators-redhat 1
   spec:
     channel: stable 2
     name: loki-operator
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace

   1

   您必须指定 openshift-operators-redhat 命名空间。

   2

   指定 stable, 或 stable-5.<y> 作为频道。

   3

   指定 redhat-operators。如果 OpenShift Container Platform 集群安装在受限网络中（也称为断开连接的集群），请指定配置 Operator Lifecycle Manager (OLM) 时创建的 CatalogSource 对象的名称。

2. 应用 Subscription 对象：

   $ oc apply -f <filename>.yaml

流程

1. 创建 LokiStack CR：

流程

1. 将从 GCP 接收的服务帐户凭证复制到名为 key.json 的文件中。

2. 运行以下命令，使用名称 logging-loki-gcs 创建对象存储 secret：

   $ oc create secret generic logging-loki-gcs \
     --from-literal=bucketname="<bucket_name>" \
     --from-file=key.json="<path/to/key.json>"

流程

1. 在 openshift-logging 命名空间中创建 ObjectBucketClaim 自定义资源：

   apiVersion: objectbucket.io/v1alpha1
   kind: ObjectBucketClaim
   metadata:
     name: loki-bucket-odf
     namespace: openshift-logging
   spec:
     generateBucketName: loki-bucket-odf
     storageClassName: openshift-storage.noobaa.io

2. 运行以下命令，从关联的 ConfigMap 对象获取存储桶属性：

   BUCKET_HOST=$(oc get -n openshift-logging configmap loki-bucket-odf -o jsonpath='{.data.BUCKET_HOST}')
   BUCKET_NAME=$(oc get -n openshift-logging configmap loki-bucket-odf -o jsonpath='{.data.BUCKET_NAME}')
   BUCKET_PORT=$(oc get -n openshift-logging configmap loki-bucket-odf -o jsonpath='{.data.BUCKET_PORT}')

3. 运行以下命令，从关联的 secret 获取存储桶访问密钥：

   ACCESS_KEY_ID=$(oc get -n openshift-logging secret loki-bucket-odf -o jsonpath='{.data.AWS_ACCESS_KEY_ID}' | base64 -d)
   SECRET_ACCESS_KEY=$(oc get -n openshift-logging secret loki-bucket-odf -o jsonpath='{.data.AWS_SECRET_ACCESS_KEY}' | base64 -d)

4. 运行以下命令，创建一个名为 logging-loki-odf 的对象存储 secret：

   $ oc create -n openshift-logging secret generic logging-loki-odf \
   --from-literal=access_key_id="<access_key_id>" \
   --from-literal=access_key_secret="<secret_access_key>" \
   --from-literal=bucketnames="<bucket_name>" \
   --from-literal=endpoint="https://<bucket_host>:<bucket_port>"

流程

1. 在 OpenShift Container Platform Web 控制台中，点击 Operators OperatorHub。
2. 从可用的 Operator 列表中选择 OpenShift Elasticsearch Operator，然后点 Install。
3. 确保在 Installation mode 下选择了 All namespaces on the cluster。

4. 确定在 Installed Namespace 下选择了 openshift-operators-redhat。

   您必须指定 openshift-operators-redhat 命名空间。openshift-operators 命名空间可能会包含社区提供的 operator。这些 operator 不被信任，其发布的 metric 可能与 OpenShift Container Platform metric 的名称相同，从而导致冲突。

5. 选择 Enable operator recommended cluster monitoring on this namespace。

   这个选项在 Namespace 对象中设置 openshift.io/cluster-monitoring: "true" 标签。您必须设置这个选项，以确保集群监控提取 openshift-operators-redhat 命名空间。

6. 选择 stable-5.x 作为 更新频道。

7. 选择一个 更新批准策略：

   • Automatic 策略允许 Operator Lifecycle Manager（OLM）在有新版本可用时自动更新 Operator。
   • Manual 策略需要拥有适当凭证的用户批准 Operator 更新。
8. 点 Install。

验证

1. 通过切换到 Operators Installed Operators 页来验证 OpenShift Elasticsearch Operator 已被安装。
2. 确定 OpenShift Elasticsearch Operator 在所有项目中被列出，请 Status 为 Succeeded。

流程

1. 创建一个 Namespace 对象作为一个 YAML 文件：

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

   1

   您必须指定 openshift-operators-redhat 命名空间。要防止可能与指标冲突，请将 Prometheus Cluster Monitoring 堆栈配置为从 openshift-operators-redhat 命名空间中提取指标，而不是从 openshift-operators 命名空间中提取。openshift-operators 命名空间可能会包含社区 Operator，这些 Operator 不被信任，并可能会发布与 metric 的名称相同的指标，从而导致冲突。

   2

   字符串.您必须按照所示指定该标签，以确保集群监控提取 openshift-operators-redhat 命名空间。

2. 运行以下命令来应用 Namespace 对象：

   $ oc apply -f <filename>.yaml

3. 以 YAML 文件形式创建 OperatorGroup 对象：

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: openshift-operators-redhat
     namespace: openshift-operators-redhat 1
   spec: {}

   1

   您必须指定 openshift-operators-redhat 命名空间。

4. 运行以下命令来应用 OperatorGroup 对象：

   $ oc apply -f <filename>.yaml

5. 创建一个 Subscription 对象来订阅 OpenShift Elasticsearch Operator 的命名空间：

   订阅示例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: elasticsearch-operator
     namespace: openshift-operators-redhat 1
   spec:
     channel: stable-x.y 2
     installPlanApproval: Automatic 3
     source: redhat-operators 4
     sourceNamespace: openshift-marketplace
     name: elasticsearch-operator

   1

   您必须指定 openshift-operators-redhat 命名空间。

   2

   指定 stable, 或 stable-x.y 作为频道。请参见以下注释。

   3

   Automatic 允许 Operator Lifecycle Manager (OLM) 在有新版本可用时自动更新 Operator。Manual 要求具有适当凭证的用户批准 Operator 更新。

   4

   指定 redhat-operators。如果 OpenShift Container Platform 集群安装在受限网络中（也称为断开连接的集群），请指定配置 Operator Lifecycle Manager (OLM)时创建的 CatalogSource 对象的名称。

   注意

   指定 stable 安装最新稳定版本的当前版本。使用带有 installPlanApproval: "Automatic" 的 stable 会自动将 Operator 升级到最新的稳定主版本和次版本。

   指定 stable-x.y 会安装特定主版本的当前次版本。使用带有 installPlanApproval: "Automatic" 的 stable-x.y 会自动将 Operator 升级到主发行版本中的最新稳定次版本。

6. 运行以下命令来应用订阅：

   $ oc apply -f <filename>.yaml

   OpenShift Elasticsearch Operator 已安装到 openshift-operators-redhat 命名空间，并复制到集群中的每个项目。

验证

1. 运行以下命令:

   $ oc get csv -n --all-namespaces

2. 观察输出，并确认每个命名空间中存在 OpenShift Elasticsearch Operator 的 Pod

   输出示例

   NAMESPACE                                          NAME                            DISPLAY                            VERSION          REPLACES                        PHASE
   default                                            elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   kube-node-lease                                    elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   kube-public                                        elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   kube-system                                        elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   non-destructive-test                               elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   openshift-apiserver-operator                       elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   openshift-apiserver                                elasticsearch-operator.v5.8.1   OpenShift Elasticsearch Operator   5.8.1            elasticsearch-operator.v5.8.0   Succeeded
   ...