10.2. ログストレージのインストール

手順

1. OpenShift Container Platform Web コンソールの Administrator パースペクティブで、Operators OperatorHub に移動します。

2. Filter by keyword フィールドに Loki Operator と入力します。使用可能な Operator のリストで Loki Operator をクリックし、Install をクリックします。

   重要

   Community Loki Operator は Red Hat ではサポートされていません。

3. Update channel として stable または stable-x.y を選択します。

   注記

   stable チャネルは、Logging の最新リリースを対象とする更新のみを提供します。以前のリリースの更新を引き続き受信するには、サブスクリプションチャネルを stable-x.y に変更する必要があります。x.y は、インストールしたログのメジャーバージョンとマイナーバージョンを表します。たとえば、stable-5.7 です。

   Loki Operator はグローバルオペレーターグループ namespace である openshift-operators-redhat にデプロイする必要があるため、Installation mode と Installed Namespace がすでに選択されています。この namespace がない場合は、自動的に作成されます。

4. Enable operator-recommended cluster monitoring on this namespace. を選択します。

   このオプションは、Namespace オブジェクトに openshift.io/cluster-monitoring: "true" ラベルを設定します。クラスターモニタリングが openshift-operators-redhat namespace を収集できるように、このオプションを選択する必要があります。

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. 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 view を選択し、次のテンプレートを使用して LokiStack CR を作成します。

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki 

   1

   
     namespace: openshift-logging
   spec:
     size: 1x.small 

   2

   
     storage:
       schemas:
       - version: v12
         effectiveDate: '2022-06-01'
       secret:
         name: logging-loki-s3 

   3

   
         type: s3 

   4

   
     storageClassName: <storage_class_name> 

   5

   
     tenants:
       mode: openshift-logging 

   6

   1

   logging-loki という名前を使用します。

   2

   デプロイメントサイズを指定します。ロギング 5.8 以降のバージョンでは、Loki の実稼働インスタンスでサポートされているサイズオプションは 1x.extra-small、1x.small、または 1x.medium です。

   重要

   デプロイメントサイズの 1x の数は変更できません。

   3

   ログストレージに使用するシークレットを指定します。

   4

   対応するストレージタイプを指定します。

   5

   一時ストレージのストレージクラスの名前を入力します。最適なパフォーマンスを得るには、ブロックストレージを割り当てるストレージクラスを指定します。クラスターで使用可能なストレージクラスは、oc get storageclasses コマンドを使用してリスト表示できます。

   6

   LokiStack はデフォルトでマルチテナントモードで実行されます。このデフォルト設定は変更できません。ログの種類 (監査ログ、インフラストラクチャーログ、アプリケーションログ) ごとに 1 つのテナントが提供されます。これにより、個々のユーザーおよびユーザーグループのさまざまなログストリームのアクセス制御が可能になります。

4. Create をクリックします。

手順

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 namespace を指定する必要があります。

   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 を作成します。

   LokiStack CR の例

   apiVersion: loki.grafana.com/v1
   kind: LokiStack
   metadata:
     name: logging-loki
     namespace: openshift-logging
   spec:
     size: 1x.small 

   1

   
     storage:
       schemas:
       - version: v12
         effectiveDate: "2022-06-01"
       secret:
         name: logging-loki-s3 

   2

   
         type: s3 

   3

   
     storageClassName: <storage_class_name> 

   4

   
     tenants:
       mode: openshift-logging 

   5

   1

   デプロイメントサイズを指定します。ロギング 5.8 以降のバージョンでは、Loki の実稼働インスタンスでサポートされているサイズオプションは 1x.extra-small、1x.small、または 1x.medium です。

   重要

   デプロイメントサイズの 1x の数は変更できません。

   2

   ログストアシークレットの名前を指定します。

   3

   ログストアシークレットのタイプを指定します。

   4

   一時ストレージのストレージクラスの名前を指定します。最適なパフォーマンスを得るには、ブロックストレージを割り当てるストレージクラスを指定します。クラスターで使用可能なストレージクラスは、oc get storageclasses コマンドを使用してリスト表示できます。

   5

   LokiStack はデフォルトでマルチテナントモードで実行されます。このデフォルト設定は変更できません。ログの種類 (監査ログ、インフラストラクチャーログ、アプリケーションログ) ごとに 1 つのテナントが提供されます。これにより、個々のユーザーおよびユーザーグループのさまざまなログストリームのアクセス制御が可能になります。

2. 次のコマンドを実行して、LokiStack CR を適用します。

   $ oc apply -f <filename>.yaml