|
この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。 |
|
これは未公開の文書です SUSE® Storage 1.12 (Dev). |
設定
サポートされているデータエンジンによる値のフォーマットタイプ
各設定は、その定義に基づいて、次のフォーマットのいずれか一つのみをサポートします。 サポートされるフォーマットにより、どのデータエンジンが構成可能か、およびその値が異なってもよいかが決定されます。
-
すべてのデータエンジンに共通する単一の値
-
*形式:*非JSON文字列(例えば、
1024) -
その値はすべてのサポートされているデータエンジンに適用され、すべてで同じでなければなりません。
-
データエンジン固有の値は許可されていません。
-
-
V1およびV2データエンジンのためのデータエンジン固有の値
-
*形式:*JSONオブジェクト(例えば、
{"v1": "value1", "v2": "value2"}) -
V1およびV2データエンジンのために異なる値を指定することができます。
-
-
V1データエンジン固有の値
-
形式:
v1`キーのみを持つJSONオブジェクト(例えば、{"v1": "value1"}`) -
V1データエンジンのみが構成可能です。V2データエンジンには影響しません。
-
-
V2データエンジン固有の値
-
形式:
v2`キーのみを持つJSONオブジェクト(例えば、{"v2": "value1"}`) -
V2データエンジンのみが構成可能です。V1データエンジンには影響しません。
-
デフォルト設定のカスタマイズ
SUSE Storageをインストールする前に構成するには、詳細はこのセクションを参照してください。
システム情報
デフォルトエンジンイメージ
デフォルトエンジンイメージはマネージャーによって使用されるイメージであり、マネージャーが起動する際にのみ変更できます。
すべてのSUSE Storageリリースには新しいエンジンイメージが含まれています。デフォルトエンジンを使用していないLonghornボリュームには緑の矢印が表示され、ボリュームのアップグレードが必要であることを示します。
サポートバンドルマネージャーイメージ
SUSE Storageはサポートバンドルを生成するためにサポートバンドルマネージャーイメージを使用します。
インストールおよびアップグレード時にデフォルトイメージが提供され、設定で変更することもできます。
サポートバンドルマネージャーイメージの例:
デフォルト値: longhornio/support-bundle-kit:v0.0.14
全般
ノードドレインポリシー
デフォルト値: block-if-contains-last-replica
ボリュームの最後の正常なレプリカを持つノードがドレインされるときに使用するポリシーを定義します。使用可能なオプション:
-
block-if-contains-last-replica: SUSE Storageは、ノードがボリュームの最後の正常なレプリカを含む場合、ドレインをブロックします。 -
allow-if-replica-is-stopped: SUSE Storageは、ノードがボリュームの最後の正常なレプリカを含むが、レプリカが停止している場合にドレインを許可します。ドレイン後にノードが削除されると、データ損失の可能性があります。
-
always-allow: SUSE Storageは、ノードがボリュームの最後の正常なレプリカを含んでいても、自動的にドレインを許可します。ドレイン後にノードが削除されると、データ損失の可能性があります。また、ドレイン中に最後のレプリカが稼働していた場合、データの破損の可能性もあります。
-
block-for-eviction: SUSE Storageは、自動的にすべてのレプリカを追い出し、追い出しが完了するまでドレインをブロックします。遅いドレインやレプリカ再構築に関連する追加のデータ移動が発生する可能性があります。
-
block-for-eviction-if-contains-last-replica: SUSE Storageは、自動的に正常な対応物を持たないレプリカを追い出し、追い出しが完了するまでドレインをブロックします。遅いドレインやレプリカ再構築に関連する追加のデータ移動が発生する可能性があります。
各オプションには利点と欠点があります。どのオプションがあなたの環境に最も適しているかを決定するための助けとして、ノードドレインポリシーの推奨事項を参照してください。
コルドンされたときに手動で接続されたボリュームを切り離す
デフォルト値: false
SUSE Storageは、コルドンされたノードに手動で接続されたボリュームを自動的に切り離します。 これは、ノード上でまだ稼働中のエンジンを持つインスタンスマネージャーのPDBによってドレインプロセスが停止するのを防ぎます。
システム生成スナップショットを自動的にクリーンアップする
デフォルト値: true
SUSE Storageはレプリカ再構築中にシステムスナップショットを生成します。ユーザーが定期的なスナップショットスケジュールを設定しない場合、すべてのシステム生成スナップショットがレプリカに残り、手動で削除する必要が生じます。この設定により、SUSE Storageがレプリカ再構築の前後にシステム生成スナップショットを自動的にクリーンアップします。
定期的なバックアップジョブの古いスナップショットを自動的に削除する
デフォルト値: true
有効にすると、定期的なバックアップジョブを実行する際に、SUSE Storageはバックアップを作成する前に新しいスナップショットを取得します。SUSE Storageは、保持パラメータの値が1でなくても、最後のバックアップジョブで使用されたスナップショットのみを保持します。
無効にすると、この設定は保持されたスナップショットがリモートバックアップターゲット上のバックアップに直接対応することを保証します。
ボリュームが予期せず切り離されたときにワークロードポッドを自動的に削除する
デフォルト値: true
有効にすると、SUSE Storageは Longhorn ボリュームが予期せず切り離されたとき(例えば、Kubernetes のアップグレード中、Docker の再起動中、またはネットワークの切断中)に、コントローラー(デプロイメント、ステートフルセット、デーモンセットなど)によって管理されているワークロードポッドを自動的に削除します。 ポッドを削除することで、そのコントローラーはポッドを再起動し、Kubernetesがボリュームの再接続と再マウントを処理します。
無効にすると、SUSE Storageはコントローラーによって管理されているワークロードポッドを削除しません。ボリュームを再接続して再マウントするには、ポッドを手動で再起動する必要があります。
|
予期しないボリューム切断時の自動ワークロードポッド削除のためのブラックリスト
デフォルト値: ""
設定ボリュームが予期せず切り離されたときにワークロードポッドを自動的に削除するに適用される、コントローラー`api/kind`の値のブラックリスト。ワークロードポッドがこのブラックリストにリストされている`api/kind`を持つコントローラーによって管理されている場合、SUSE Storageはボリュームが予期せず切り離されたときにポッドを自動的に削除しません。複数のコントローラー`api/kind`エントリを指定でき、セミコロンで区切ります。例: apps/v1/StatefulSet;apps/v1/DaemonSet。
|
コントローラー`api/kind`は大文字と小文字を区別し、ワークロードポッドのオーナー参照の`api/kind`と正確に一致する必要があります。 |
自動サルベージ
デフォルト値: true
有効にすると、すべてのレプリカが故障した場合(例:ネットワーク接続の切断など)にボリュームが自動でサルベージされます。SUSE Storageは使用可能なレプリカを特定し、それらをボリュームに利用します。
ノードごとの同時自動エンジンアップグレード制限
デフォルト値: 0
この設定は、SUSE StorageがLonghornマネージャーをアップグレードした後に、ボリュームのエンジンを新しいデフォルトエンジンイメージに自動的にアップグレードする方法を制御します。
この設定の値は、同時にデフォルトエンジンイメージにアップグレードできるノードごとのエンジンの最大数を指定します。
この値が`0`の場合、SUSE Storageはボリュームエンジンをデフォルトバージョンに自動的にアップグレードしません。
ノードごとの同時ボリュームバックアップリストア制限
デフォルト値: 5
この設定は、ノード上で同時にバックアップリストアできるボリュームの数を制御します。
SUSE Storageは、リストア中のボリューム数が制限を超えるとバックアップリストアをブロックします。
バックアップリストアを無効にするには、値を*0*に設定してください。
ラベル付きノードにデフォルトディスクを作成する
デフォルト値: false
他のディスクが存在しない場合、SUSE Storageは自動的にデフォルトディスクを作成しますが、Kubernetesラベル`node.longhorn.io/create-default-disk=true`を持つノードにのみ作成されます。
この設定が無効になっている場合、デフォルトディスクはノードが最初に検出されたときにすべての新しいノードに作成されます。
このオプションを使用して、新しいノードでストレージを使用せずにクラスターをスケールするか、Longhornノードのディスクをカスタマイズします(ドキュメントを参照)。
カスタムリソースAPIバージョン
デフォルト値: longhorn.io/v1beta2
現在のカスタムリソースのAPIバージョン、例えば、`longhorn.io/v1beta2`です。マネージャーによって自動的に設定されます。
デフォルトデータローカリティ
デフォルト値: disabled
SUSE Storageボリュームは、少なくとも1つのレプリカがボリュームを使用しているポッドと同じノードに存在する場合、データローカリティを持ちます。
この設定は、SUSE Storage UIを通じて作成されたボリュームのデフォルトデータローカリティを定義します。 Kubernetesデプロイメントの場合、StorageClassで`dataLocality`を構成します。
利用可能なモードは次のとおりです:
-
disabled(デフォルト):レプリカは、接続されたボリュームまたはワークロードと同じノードに存在する場合もあれば、存在しない場合もあります。 -
best-effort: SUSE Storageは、接続されたボリュームまたはワークロードと同じノードにレプリカを保持しようとします。ボリュームは、ディスクスペースが不足している場合やディスクタグが互換性がない場合など、環境の制約によりローカル配置が妨げられても引き続き動作します。 -
strict-local: SUSE Storageは、接続されたボリュームと同じノードに単一のレプリカを配置することを強制します。このモードは、より高いIOPSと低いレイテンシを提供します。
デフォルトデータパス
デフォルト値: /var/lib/longhorn/
ホスト上でデータを保存するために使用するデフォルトのパス。
クラスタをスケーリングする際に、特定のストレージがマウントされているノードのみを使用するように、Create Default Disk on Labeled Nodes`オプションと共に使用できます。例えば、/opt/longhorn`。
デフォルトSUSE Storage静的ストレージクラス名
デフォルト値: longhorn-static
`storageClassName`は、既存のSUSE Storageボリュームを参照する永続ボリューム(PV)および永続ボリュームクレーム(PVC)に使用されます。この目的のために対応するストレージクラスオブジェクトを作成する必要はありません。なぜなら、PVCバインディング中のラベルマッチングのためだけに使用されるからです。値は既存のストレージクラスと一致する必要があります。ストレージクラス`longhorn-static`がまだ存在しない場合、SUSE Storageは自動的に作成します。デフォルト値は、`longhorn-static`です。
デフォルトレプリカ数
デフォルト値: {"v1":"3","v2":"3"}
SUSE Storage UIからボリュームを作成する際のデフォルトのレプリカ数。Kubernetesの場合、ストレージクラスの`numberOfReplicas`を更新します。
デフォルトのレプリカ数を選択する推奨方法は、ストレージ用のノードが3つ以上ある場合は3を使用し、それ以外の場合は2を使用することです。単一ノードクラスタで単一のレプリカを使用することも可能ですが、高可用性機能は利用できません。ボリュームのスナップショットやバックアップを取得することは引き続き可能です。
削除確認フラグ
デフォルト値: false
このフラグは、SUSE Storageが誤ってアンインストールされてデータが失われるのを防ぐために設計されています。
-
このフラグを*true*に設定すると、SUSE Storageのアンインストールが許可されます。
-
このフラグが*false*の場合、SUSE Storageのアンインストールジョブは失敗します。
リビジョンカウンターを無効にする
デフォルト値: {"v1":"true"}
エンジンコントローラーとエンジンレプリカが、データ書き込みごとにリビジョンカウンターファイルの更新を無効にすることを許可します。これにより、データパスのパフォーマンスが向上します。詳細については、リビジョンカウンターを参照してください。
アップグレードチェッカーを有効にする
デフォルト値: true
アップグレードチェッカーは、新しいSUSE Storageバージョンを定期的にチェックします。新しいバージョンが利用可能になると、SUSE StorageのUIでユーザーに通知します。
アップグレードレスポンダーURL
デフォルト値: https://longhorn-upgrade-responder.rancher.io/v1/checkupgrade
アップグレードレスポンダーは、アップグレード可能な新しいSUSE Storageバージョンが利用可能になると通知を送信します。
SUSE Storageの使用メトリクスの収集を許可する
デフォルト値: true
この設定が有効になると、SUSE Storageが https://metrics.longhorn.io/.に匿名の使用メトリクスを送信できるようになります。
これらのメトリクスは、SUSE Storageの使用状況に関する洞察を提供し、将来の製品改善をサポートします。
クラスタノードから収集されたノード情報には、以下が含まれます:
-
各デバイスタイプのディスク数(HDD、SSD、NVMe、不明)。
この値は、仮想マシンに対して正確でない場合があります。
-
各Longhornディスクタイプ(ブロック、ファイルシステム)のディスク数。
-
ホストシステムアーキテクチャ。
-
ホストカーネルのリリース。
-
ホストオペレーティングシステム(OS)ディストリビューション。
-
Kubernetesノードプロバイダー。
クラスター情報は、クラスター内のいずれかのノードから収集された情報で、以下が含まれます:
-
LonghornネームスペースUID。
-
Longhornノードの数。
-
各アクセスモード(RWO、RWX、不明)のボリュームの数。
-
各データエンジン(v1、v2)のボリュームの数。
-
各データローカリティタイプ(無効、ベストエフォート、厳密ローカル、不明)のボリュームの数。
-
暗号化されたボリュームまたは暗号化されていないボリュームの数。
-
各フロントエンドタイプ(ブロックデバイス、iSCSI)のボリュームの数。
-
レプリカの数。
-
スナップショットの数。
-
バッキングイメージの数。
-
孤児の数。
-
平均ボリュームサイズ(バイト)。
-
平均ボリューム実際のサイズ(バイト)。
-
ボリュームあたりの平均スナップショット数。
-
ボリュームあたりの平均レプリカ数。
-
平均 SUSE Storage コンポーネント CPU 使用率 (インスタンスマネージャー、マネージャー) はミリコア単位です。
-
平均 SUSE Storage コンポーネント メモリ使用量 (インスタンスマネージャー、マネージャー) はバイト単位です。
-
Longhorn設定:
-
部分的に含まれています
-
バックアップターゲットタイプまたはプロトコル (azblob、cifs、nfs、s3、なし、未知)。これはバックアップターゲット設定からのものです。
-
-
この設定が構成されているかどうかを示すために、真または偽として含まれています
-
優先クラス
-
レジストリシークレット
-
スナップショットデータ整合性 CronJob
-
ストレージネットワーク
-
RWX ボリュームのエンドポイントネットワーク
-
システム管理コンポーネントノードセレクター
-
テイント耐性
-
-
そのまま含まれています
-
ボリュームが切り離されている間、定期ジョブを許可する
-
劣化した可用性でのボリューム作成を許可する
-
システム生成スナップショットを自動的にクリーンアップする
-
定期的なバックアップジョブの古いスナップショットを自動的にクリーンアップする
-
ボリュームが予期せず切り離されたときにワークロードポッドを自動的に削除する
-
自動サルベージ
-
バックイメージクリーンアップ待機間隔
-
バックイメージ回復待機間隔
-
バックアップ圧縮方法
-
バックアップストアのポーリング間隔
-
バックアップの同時実行制限
-
ノードごとの同時自動エンジンアップグレード制限
-
ノードごとの同時バックアップ復元制限
-
ノードごとの同時レプリカ再構築制限
-
CRD API バージョン
-
デフォルトディスクラベル付きノードの作成
-
デフォルトデータローカリティ
-
デフォルトレプリカ数
-
リビジョンカウンターを無効にする
-
コーダン済みノード上でのスケジューリングを無効にする
-
エンジンレプリカのタイムアウト
-
失敗したバックアップのTTL
-
高速レプリカ再構築が有効
-
保証されたインスタンスマネージャーCPU
-
Kubernetesクラスターオートスケーラーが有効
-
ノードダウンポッド削除ポリシー
-
ノードドレインポリシー
-
孤児の自動削除
-
定期的な失敗したジョブの履歴制限
-
定期的な成功したジョブの履歴制限
-
ファイルシステムのトリム中にスナップショットを削除する
-
レプリカの自動バランス
-
レプリカファイル同期HTTPクライアントのタイムアウト
-
レプリカ補充待機間隔
-
レプリカソフトアンチアフィニティ
-
レプリカゾーンソフトアンチアフィニティ
-
レプリカディスクソフトアンチアフィニティ
-
復元同時制限
-
復元ボリューム定期ジョブ
-
スナップショットデータ整合性
-
スナップショット作成後のスナップショットデータ整合性即時チェック
-
ストレージ最小利用可能割合
-
RWXボリューム用のストレージネットワークが有効
-
ストレージオーバープロビジョニング割合
-
デフォルトディスク用のストレージ予約割合
-
サポートバンドル失敗履歴制限
-
サポートバンドルノードコレクションタイムアウト
-
システム管理ポッドのイメージプルポリシー
-
-
`Upgrade Checker`は、収集したデータを定期的に送信するために有効にする必要があります。
ノードがダウンしているときのポッド削除ポリシー
デフォルト値: do-nothing
ボリュームがダウンしているノード上のステートフルセットまたはデプロイメントポッドに詰まっているときのSUSE Storageアクションを定義します。
-
`do-nothing`は、ステートフルセットまたはデプロイメントの終了ポッドを強制的に削除しないというKubernetesのデフォルトの動作です。ダウンしているノード上のポッドが削除されないため、Longhornボリュームはダウンしているノードに詰まっています。
-
delete-statefulset-podSUSE Storageは、ダウンしているノード上のステートフルセットの終了中のポッドを強制的に削除して、Longhornボリュームを解放し、Kubernetesが代替ポッドを起動できるようにします。 -
delete-deployment-podSUSE Storageは、ダウンしているノード上のデプロイメントの終了中のポッドを強制的に削除して、Longhornボリュームを解放し、Kubernetesが置き換えポッドを起動できるようにします。 -
delete-both-statefulset-and-deployment-podSUSE Storageは、ダウンしているノード上のステートフルセットまたはデプロイメントの終了中のポッドを強制的に削除して、Longhornボリュームを解放し、Kubernetesが置き換えポッドを起動できるようにします。
レプリカ補充待機間隔
デフォルト値: 600
劣化したボリュームに少なくとも1つの失敗したレプリカボリュームがある場合、この秒数の間隔は、SUSE Storageが新しいレプリカを直接作成するのではなく、失敗したレプリカの既存データを再利用するために最大でどれくらい待つかを決定します。
| この待機間隔は、ボリュームに少なくとも1つの失敗したレプリカがある場合にのみ機能します。このオプションは、再構築を一時的にブロックする可能性があります。 |
システム管理ポッドのイメージプルポリシー
デフォルト値: if-not-present
この設定は、Longhornシステム管理ポッドのイメージプルポリシーを定義します。例えば、インスタンスマネージャー、エンジンイメージ、CSIドライバーなどです。
新しいイメージプルポリシーは、システム管理ポッドが再起動した後にのみ適用されることに注意してください。
この設定の定義は、Kubernetesのものと全く同じです。使用可能なオプションは次のとおりです:
-
`always`ボタンをクリックします。`kubelet`がコンテナを起動するたびに、`kubelet`はコンテナイメージレジストリにクエリを送り、名前をイメージダイジェストに解決します。`kubelet`がその正確なダイジェストをローカルにキャッシュしたコンテナイメージを持っている場合、`kubelet`はキャッシュされたイメージを使用します。そうでない場合、`kubelet`は解決されたダイジェストでイメージをダウンロード(プル)し、そのイメージを使用してコンテナを起動します。
-
`if-not-present`ボタンをクリックします。イメージは、ローカルに存在しない場合にのみプルされます。
-
`never`イメージはローカルに存在すると仮定されます。イメージをプルする試みは行われません。
バックイメージクリーンアップ待機間隔
デフォルト値: 60
この間隔(分)は、SUSE Storageがディスク上のレプリカが使用していない場合にバックイメージファイルをクリーンアップするまでの待機時間を定義します。
バックイメージ回復待機間隔
デフォルト値: 300
この間隔(秒)は、SUSE Storageがそのイメージのすべてのディスクファイルが`failed`または`unknown`状態に入った後、バックイメージファイルを再ダウンロードするまでの待機時間を定義します。
|
エンジンレプリカのタイムアウト
デフォルト値: {"v1":"8","v2":"8"}
V1データエンジンがレプリカの応答を待つ秒数、応答がない場合は失敗としてマークします。8から30の間の値が許可されています。この設定は、未処理の入力または出力要求がある場合にのみ有効です。
この設定は、追加のレプリカにのみ適用されます。V1エンジンは、設定された秒数の2倍(タイムアウト値 x 2)が経過した後にのみ、最後のアクティブなレプリカを失敗としてマークします。この動作は、ボリュームの応答性とボリュームの可用性のバランスを取ることを目的としています。
エンジンは、設定されたタイムアウト後に、他の利用可能なレプリカを優先するために、応答しなくなった個々のレプリカを迅速に無視することができます。これにより、将来の入力または出力が滞ることはありません。
エンジンは、最後のレプリカが利用可能なバックエンドがないために不必要にクラッシュするのを防ぐために、設定されたタイムアウトの2倍まで待機します。
サポートバンドル失敗履歴制限
デフォルト値: 1
この設定は、クラスター内に存在できる失敗したサポートバンドルの数を指定します。
保持された失敗したサポートバンドルは分析目的であり、手動でクリーンアップする必要があります。
SUSE Storage は、制限の上限に達したときにサポートバンドルの作成をブロックします。この値を 0 に設定すると、SUSE Storage がすべての失敗したサポートバンドルを自動的に削除します。
サポートバンドルノードコレクションタイムアウト
デフォルト値: 30
SUSE Storage は、サポートバンドルのためのノード情報とノードログの収集を許可する分数です。
収集プロセスが指定された時間内に完了しない場合、SUSE Storage は未収集のノードデータなしでサポートバンドルを生成し続けます。
高速レプリカ再構築が有効
デフォルト値: {"v1":"true","v2":"true"}
この設定は、高速レプリカ再構築機能を有効にします。スナップショットディスクファイルのチェックサムに依存しているため、スナップショットデータの整合性を enable または fast-check に設定することが前提条件です。
HTTPクライアントからレプリカファイル sync サーバーへのタイムアウト
デフォルト値: 30
秒単位の値は、レプリカの再構築、ボリュームのクローン作成、スナップショットのクローン作成などに使用されるHTTPクライアントのタイムアウトを指定します。
オフラインレプリカの再構築
デフォルト値: false
ボリュームが切り離されている間に、SUSE Storageが劣化したレプリカを自動的に再構築するかどうかを制御します。この設定は、ボリュームレベルの設定が`ignored`または`enabled`に設定されている場合にのみ有効です。
使用可能なオプション:
-
true:すべての切り離されたボリュームに対してオフラインレプリカの再構築を有効にします(ボリュームレベルで上書きされない限り)。 -
false:オフラインレプリカの再構築を全体的に無効にします(ボリュームレベルで上書きされない限り)。
|
オフライン再構築は、ボリュームが切り離されているときのみ発生します。障害状態のボリュームはオフライン再構築をトリガーしません。 |
この設定により、必要に応じてSUSE Storageが切り離されたボリュームのレプリカを自動的に再構築できるようになります。
RWXボリュームの高速フェールオーバー(実験的)
デフォルト値: false
ノード障害からの回復にかかる時間を短縮することにより、改善されたReadWriteManyボリュームのHAを有効にします。
Log Level(ログレベル)
デフォルト値: Log Level
Longhorn Managerは、次のログレベルを使用します:Panic、Fatal、Error、Warn、Info、Debug、および`Trace`。デフォルトのログレベルは`Info`です。
ログパス
デフォルト値: /var/lib/longhorn/logs/
この設定は、SUSE Storageがインスタンスマネージャーポッドのログファイルを保存するホスト上のディレクトリを指定します。現在、これはv2データエンジンのインスタンスマネージャーポッドにのみ使用されています。
データエンジンのログレベル
デフォルト値: {"v2":"Notice"}
V2データエンジンにのみ適用されます。ストレージパフォーマンス開発キット(SPDK)ターゲットデーモンのログレベルを指定します。サポートされている値:Error、Warning、Notice、Info、および`Debug`。
レプリカ再構築帯域幅制限
デフォルト値: {"v2":"0"}
V2データエンジンにのみ適用されます。ボリュームレプリカ再構築のためのデフォルトの書き込み帯域幅制限(メガバイト毎秒(MB/s))を指定します。
マネージャーURL
デフォルト値: ""
例:https://longhorn.example.com`またはhttps://longhorn.example.com:8443`
Longhorn Manager APIにアクセスするための外部URL。構成されている場合、このURLはAPIレスポンスの`actions`および`links`フィールドを生成するために使用され、リクエストヘッダーから派生させたり、内部ポッドIPを使用したりすることはありません。
この設定は、IngressまたはGateway API HTTPRouteを介してLonghorn APIにアクセスする際に便利で、Ingressコントローラーが`X-Forwarded-*`ヘッダーを正しく設定しない場合、APIが内部クラスターIPを返す可能性があります。
フォーマット:scheme://host[:port](次のように)
-
scheme:`http`または`https`である必要があります -
host:外部ホスト名またはIPアドレス -
port:オプションのポート番号(httpの場合は80、httpsの場合は443がデフォルト)
要件:
-
URLにはパス、クエリパラメータ、またはフラグメントを含めてはいけません。
-
IPv6アドレスは、角カッコで囲む必要があります(例:
http://[2001:db8::1:9500])。
使用するタイミング:
-
外部URLを介してIngressを通じてLonghorn UIまたはAPIにアクセスします。
-
外部アクセスにはGateway API HTTPRouteを使用してください
-
APIクライアントは、応答URLに内部IPを受け取ります
空の場合(デフォルト):URLはHTTPリクエストヘッダー(X-Forwarded-*)から構築されるか、リクエストホストにフォールバックします。
詳細については、外部APIアクセスのためのマネージャーURLを参照してください。
デフォルトのUblkキュー深度
デフォルト値: {"v2":"128"}
Ublkフロントエンドの各キューのデフォルトの深度です。この設定は、Ublkフロントエンドを備えたV2データエンジンを使用するボリュームに適用されます。
Snapshot
スナップショットデータ整合性
デフォルト値: {"v1":"fast-check","v2":"fast-check"}
この設定により、ユーザーはスナップショットハッシュとデータ整合性チェックを有効または無効にできます。使用可能なオプションは次のとおりです:
-
無効:スナップショットディスクファイルのハッシュ化とデータ整合性チェックを無効にします。
-
有効:定期的なスナップショットディスクファイルのハッシュ化と完全なデータ整合性チェックを有効にします。SUSE Storageシステムは、ファイルシステムに依存しない破損(ビットロットなど)を検出するために、定期的にスナップショットディスクファイルをハッシュ化します。これらのチェックは、各スキャン中にシステムのパフォーマンスに影響を与える可能性があります。
-
fast-check:高速データ整合性チェックを使用してスナップショットディスクファイルのハッシュ化を有効にします。このモードでは、システムはスナップショットディスクファイルが以前にハッシュ化されていない場合、またはその変更時間が変わった場合にのみハッシュ化します。ファイルシステムを認識しない破損はこのモードでは検出できませんが、パフォーマンスへの影響は軽減されます。
スナップショット作成後の即時スナップショットデータ整合性チェック
デフォルト値: {"v1":"false","v2":"false"}
スナップショットディスクファイルのハッシュ化は、システムのパフォーマンスに影響を与えます。即時スナップショットのハッシュ化とチェックは、スナップショット作成後の影響を最小限に抑えるために無効にすることができます。
スナップショットデータ整合性チェックCronJob
デフォルト値: {"v1":"0 0 */7 * *","v2":"0 0 */7 * *"}
Unix-cron文字列形式。この設定は、SUSE Storageがスナップショットディスクファイルのデータ整合性をチェックするタイミングを指定します。
|
スナップショットディスクファイルのハッシュ化は、システムのパフォーマンスに影響を与えます。データ整合性チェックは、ピーク時以外の時間に実行することをお勧めし、チェックの頻度を減らすことが推奨されます。 |
スナップショットのためにファイルシステムをフリーズする
デフォルト値: {"v1":"false"}
この設定は、Kubernetesボリュームモード`Filesystem`を使用するボリュームにのみ適用されます。 有効にすると、SUSE Storageはユーザーが開始したスナップショットを作成する直前にボリュームのファイルシステムを即座にフリーズします。 無効の場合、またはボリュームモードが`Block`の場合、SUSE Storageはユーザーが開始したスナップショットの作成前にシステムsyncを実行します。
ファイルシステムのフリーズが有効な状態で作成されたスナップショットは、スナップショット作成時にファイルシステムが安定した状態にあるため、一貫性が高くなります。ただし、大量の入力または出力がある場合、ファイルシステムのフリーズには目に見える時間がかかり、ワークロードのアクティビティが一時的に停止することがあります。
この設定が無効になっている場合、SUSE Storageはスナップショットを作成する前にデータをディスクにフラッシュしますが、システムsyncとスナップショット作成の間で書き込みを完全にブロックすることはできません。 ワークロードは通常、sync中に入力と出力が続くため、スナップショット操作に気づきません。
デフォルト値は、`false`です。カーネル`v5.17`およびそれ以前のバージョンでは、アクティブなファイルシステムのフリーズ中にボリュームがクラッシュすると、正しく回復できない場合があります。この状況では、カーネルはノードを再起動するまでファイルシステムのアンマウントやそれを使用するプロセスの停止を防ぐことがあります。この設定は、カーネルバージョン`5.17`以降およびext4またはXFSファイルシステムを使用する場合にのみ有効にしてください。
この設定は、ボリュームごとに、`freezeFilesystemForSnapshot`フィールドを使用するか、SUSE Storage UI、StorageClass、または既存のボリュームの編集により上書きできます。`freezeFilesystemForSnapshot`は次の値を受け入れます:
デフォルト値: ignored
-
ignored:SUSE Storageにグローバル設定を使用するよう指示します。これがデフォルトのオプションです。 -
enabled:グローバル設定に関係なく、スナップショットの前にフリーズを有効にします。 -
disabled:グローバル設定に関係なく、スナップショットの前にフリーズを無効にします。
Orphan(孤立)
孤立リソースの自動削除
例: replica-data;instance
この設定により、SUSE Storageは通常、SUSE Storageによって作成された孤立したエンティティを表すカスタムリソース(CR)である`orphan`リソースを自動的に削除できます。orphan CRの削除は、そのCRが表す実際の孤立したデータまたはランタイムインスタンスのクリーンアップをトリガーします。ただし、`down`または`unknown`の状態にあるノードに関連付けられている`orphan`リソースは、この設定によって自動的にクリーンアップされることはありません。
自動的に削除されるリソースタイプをセミコロンで区切った文字列としてリストできます。利用可能なタイプには次のものが含まれます:
-
replica-data:レプリカデータストアを表します。 -
instance:エンジンとレプリカのランタイムインスタンスを表します。
バックアップ
ボリュームが切り離されている間、定期的なジョブを許可する
デフォルト値: false
この設定が有効になっている場合、SUSE Storage はボリュームを自動的に接続し、定期的なスナップショットまたはバックアップを行う時間になるとスナップショットまたはバックアップを取得します。
|
ボリュームが自動的に接続されている間、ボリュームはワークロードの準備ができていません。ワークロードは、定期的なジョブが終了するまで待機する必要があります。 |
失敗したバックアップの生存時間
デフォルト値: 1440
失敗したバックアップリソースを保持するための分単位の間隔です。自動削除を無効にするには、0 に設定します。
失敗したバックアップは、バックアップストアポーリング間隔 設定によって制御されるバックアップストアポーリング中にチェックされ、クリーンアップされます。したがって、この値はクリーンアップの最小待機間隔を決定します。実際のクリーンアップ間隔は、バックアップストアポーリング間隔 の倍数です。バックアップストアポーリング間隔 を無効にすることは、失敗したバックアップの自動削除を無効にすることも意味します。
復元ボリューム定期ジョブ
デフォルト値: false
この設定は、ボリュームの復元中に、クラスタに存在しない場合に限り、バックアップターゲットからバックアップボリュームの定期ジョブを復元できるようにします。 これは、以下のオプションを持つボリューム固有の設定でもあります。ユーザーは、グローバル設定を上書きするために各ボリュームに対してカスタマイズできます。
デフォルト値: ignored
-
ignored:これは、SUSE Storageにグローバル設定を継承するよう指示するデフォルトオプションです。 -
enabled:このオプションは、SUSE Storageにバックアップターゲットからボリュームの定期ジョブまたはグループを強制的に復元するよう指示します。 -
disabled:このオプションは、SUSE Storageにボリュームの定期ジョブまたはグループの復元を行わないよう指示します。
スケジューリング
可用性が低下した状態でのボリューム作成を許可する
デフォルト値: true
この設定により、ユーザーは作成時にすべてのレプリカがスケジュールされていないボリュームを作成および接続できます。
| 本番環境でSUSE Storageを使用する際は、この設定を無効にすることをお勧めします。詳細についてはベストプラクティスを参照してください。 |
コーデンノードでのスケジューリングを無効にする
デフォルト値: true
この設定がチェックされている場合、Longhorn ManagerはKubernetesのコーデンノードでレプリカのスケジューリングを許可しません。
この設定がチェックされていない場合、Longhorn ManagerはKubernetesのコーデンノードでレプリカのスケジューリングを許可します。
レプリカノードレベルのソフトアンチアフィニティ
デフォルト値: false
この設定がチェックされている場合、Longhorn Managerは同じボリュームの既存の健全なレプリカがあるノードでのスケジューリングを許可します。
この設定がチェックされていない場合、Longhorn Managerは同じボリュームの既存の健全なレプリカがあるノードでのスケジューリングを防ぎます。
|
レプリカゾーンレベルのソフトアンチアフィニティ
デフォルト値: true
この設定がチェックされている場合、Longhorn Managerは既存の健全なレプリカと同じゾーンのノードにボリュームの新しいレプリカをスケジューリングすることを許可します。
この設定がチェックされていない場合、Longhorn Managerは既存の健全なレプリカと同じゾーンのノードにボリュームの新しいレプリカをスケジューリングすることを防ぎます。
|
レプリカディスクレベルのソフトアンチアフィニティ
デフォルト値: true
この設定がチェックされている場合、Longhorn Managerは既存の健全なレプリカと同じディスクにボリュームの新しいレプリカをスケジューリングすることを許可します。
この設定がチェックされていない場合、Longhorn Managerは既存の健全なレプリカと同じディスクにボリュームの新しいレプリカをスケジューリングすることを防ぎます。
|
レプリカの自動バランス
デフォルト値: disabled
この設定を有効にすると、利用可能なノードが発見されたときにレプリカが自動的に再バランスされます。
利用可能なグローバルオプションは次のとおりです。
-
`disabled`これがデフォルトのオプションです。レプリカの自動バランスは行われません。
-
`least-effort`このオプションは、SUSE Storageに対して最小限の冗長性のためにレプリカをバランスさせるよう指示します。
-
`best-effort`ボタンをクリックします。このオプションは、SUSE Storageに対して均等な冗長性のためにレプリカをバランスさせるよう指示します。SUSE Storageは、均等なバランスをサポートするのに十分なノードがないゾーンにレプリカを強制的に再スケジュールすることはありません。代わりに、SUSE Storageはノードレベルでバランスを取るために再スケジュールします。
SUSE Storageは、個々のボリュームのカスタマイズもサポートしています。設定はUIまたはKubernetesマニフェストのvolume.spec.replicaAutoBalanceで指定でき、これがグローバル設定を上書きします。 利用可能なボリューム仕様オプションは次のとおりです。
デフォルト値: ignored
-
`ignored`ボタンをクリックします。これは、SUSE Storageにグローバル設定を継承するよう指示するデフォルトオプションです。
-
`disabled`このオプションは、SUSE Storageにレプリカの自動バランスを実行しないよう指示します。
-
`least-effort`このオプションは、SUSE Storageに対して最小限の冗長性のためにレプリカをバランスさせるよう指示します。
-
`best-effort`このオプションは、SUSE Storageに対して均等な冗長性のためにレプリカをバランスさせるよう指示します。SUSE Storageは、均等なバランスをサポートするのに十分なノードがないゾーンにレプリカを強制的に再スケジュールすることはありません。代わりに、SUSE Storageはノードレベルでバランスを取るために再スケジュールします。
レプリカ自動バランスディスク圧力閾値(%)
デフォルト値: 90
自動レプリカ再バランスをトリガーする現在使用中のストレージの割合。
閾値に達すると、SUSE Storageは同じノード内の別のディスク上でディスク圧力の下にあるレプリカを自動的に再構築します。
この設定を無効にするには、値を*0*に設定します。
この設定は、次の条件が満たされたときのみ有効になります:
-
レプリカ自動バランスが*ベストエフォート*に設定されている。レプリカ自動バランスがベストエフォートに設定されているときにこの設定(ディスク圧力閾値)を無効にするには、この設定の値を*0*に設定します。
-
ノード上の他の少なくとも1つのディスクに十分な空き容量があります。
この設定は、レプリカノードレベルソフトアンチアフィニティの影響を受けず、これによりSUSE Storageが同じノード上でレプリカを再構築するのを防ぐことができます。その設定の値に関係なく、この設定は、移行目的のために同じノードの異なるディスクでレプリカの再構築を試みることをSUSE Storageに許可します。
ストレージ最小利用可能割合
デフォルト値: 25
この設定は、*ストレージ最大*に基づいて、SUSE Storageが新しいレプリカをスケジュールできる前に、ディスク上に残るべき最小の空きスペースを制御します。
デフォルトでは、SUSE Storageはディスクの総容量の少なくとも*25%*が空いていることを保証します。レプリカを追加すると、利用可能なスペースがこの制限を下回る場合、SUSE Storageは一時的にディスクをスケジュール不可としてマークし、十分なスペースが解放されるまで待機します。
この保護策は、ディスクが過剰に満杯になるのを防ぎ、その結果、パフォーマンスの問題やストレージエラーが発生するのを防ぎます。空きスペースのバッファを維持することは、システムを安定させ、予期しないストレージニーズのための余裕を確保するのに役立ちます。
詳細については、複数ディスクのサポートを参照してください。
ストレージ過剰プロビジョニング割合
デフォルト値: 100
過剰プロビジョニング割合は、ハードドライブの容量に対して割り当て可能なストレージの量を定義します。
この設定を調整することで、Longhorn Managerは、すべてのレプリカの合計サイズが使用可能なディスクスペースの許可された過剰プロビジョニング割合内に収まる限り、ディスク上に新しいレプリカをスケジュールできます。使用可能なディスクスペースは、*ストレージ最大*から*ストレージ予約*を引いたものとして計算されます。
|
レプリカは、スナップショットデータのためにボリュームの名目サイズよりも多くのスペースを消費する可能性があります。ディスクスペースを回収するには、もはや必要のないスナップショットを削除してください。 |
例えば、ディスクの*ストレージ最大*が100 GiBで、*ストレージ予約*が10 GiBの場合、使用可能な容量は90 GiBになります。
ストレージ過剰プロビジョニング割合が200%に設定されている場合、最大許可されるストレージスケジュールは180 GiB(90 GiBの200%)です。
これは、Longhorn Managerがこのディスクにレプリカをスケジュールし続けることができることを意味し、合計スケジュールサイズが180 GiBに達するまで、実際の使用可能スペースが90 GiBしかない場合でも可能です。
危険ゾーン
SUSE Storage v1.6.0以降、SUSE Storageではすべてのボリュームが切り離されるのを待つことなく、危険ゾーンの設定を変更できます。お好みの設定は、以下のシナリオですぐに適用されます:
-
接続されているボリュームなし:設定が構成される前にボリュームが接続されていない場合、設定の変更はすぐに適用されます。
-
エンジンイメージのアップグレード(ライブアップグレード):新しいインスタンスマネージャーポッドを作成するライブアップグレード中に、設定の変更は新しいポッドにすぐに適用されます。
設定は毎時同期されます。すべてのボリュームが切り離されると、以下の表の設定がすぐに適用され、システム管理コンポーネント(例:インスタンスマネージャー、CSIドライバー、エンジンイメージ)が再起動されます。
設定が同期される前にすべてのボリュームを切り離さない場合、設定は適用されず、残りのボリュームを切り離した後に同じ設定を再構成する必要があります。適用されていない設定のリストは、*危険ゾーン*セクションのSUSE Storage UIで確認するか、次のCLIコマンドを実行してフィールド`APPLIED`の値を確認できます。
~# kubectl -n longhorn-system get setting priority-class
NAME VALUE APPLIED AGE
priority-class longhorn-critical true 3h26m
| 設定 | その他の情報 | 影響を受けるコンポーネント |
|---|---|---|
システム管理コンポーネント |
||
システム管理コンポーネント |
||
システム管理コンポーネント |
||
インスタンスマネージャーおよびバックイメージコンポーネント |
||
インスタンスマネージャーコンポーネント |
||
インスタンスマネージャーコンポーネント |
||
インスタンスマネージャーコンポーネント |
V1およびV2データエンジンの設定では、すべての関連ボリュームが切り離されている場合にのみデータエンジンを無効にできます。例えば、すべてのV2ボリュームが切り離されている場合にのみV2データエンジンを無効にできます(V1ボリュームがまだ接続されている場合でも)。
V2データエンジン
デフォルト値: false
この設定は、ストレージパフォーマンス開発キット(SPDK)に基づく実験的機能であるV2データエンジンを有効にします。 V2データエンジンは技術プレビュー機能です。詳細については、[V2データエンジン (技術プレビュー)]V2データエンジン (実験的)を参照してください。
|
ノードあたりの同時レプリカ再構築制限
デフォルト値: 5
この設定は、ノード上で同時に再構築できるレプリカの数を制御します。
通常、SUSE Storageは、ノード上の現在の再構築カウントが制限を超えると、レプリカの開始をブロックすることがあります。しかし、値が0の場合、レプリカの再構築が無効になることを意味します。
|
レプリカ再構築の同時同期制限
デフォルト値: {"v1":"1"}
この設定は、単一の再構築レプリカに同時にスナップショットを同期できる健康なレプリカの最大数(1から5)を定義します。
1(デフォルト)に設定されている場合、1回に1つのソースレプリカのみが再構築レプリカに同期し、これは従来の単一ソース再構築の動作です。より高い値(例えば、2`から`5)に設定されている場合、複数の健康なレプリカが異なるスナップショットを同時に再構築レプリカに同期でき、再構築時間を短縮する可能性があります。
ボリュームごとのオーバーライド:この設定は、Longhorn UIを通じて、またはボリュームカスタムリソースの`spec.rebuildConcurrentSyncLimit`フィールドを変更することによって、個々のボリュームに対してオーバーライドできます。
詳細については、スケールレプリカ再構築を参照してください。
ノードあたりの同時バックイメージ補充制限
デフォルト値: 5
この設定は、ノード上で同時に補充できるバックイメージコピーの数を制御します。
通常、SUSE Storageは、ノード上の現在の補充カウントが制限を超えると、バックイメージコピーの開始をブロックすることがあります。しかし、値が0の場合、バックイメージの補充を無効にすることを意味します。
KubernetesのTaint Toleration
例: nodetype=storage:NoSchedule
ノードをSUSE Storageレプリカの保存専用にし、他の一般的なワークロードを拒否したい場合は、*すべて*のSUSE Storageコンポーネントに対してトレランスを設定し、ストレージ専用のノードに対してテイントを追加できます。
Longhornシステムには、ユーザーがデプロイしたコンポーネント(例:Longhorn Manager、Longhornドライバー、Longhorn UI)と、システムが管理するコンポーネント(例:インスタンスマネージャー、エンジンイメージ、CSIドライバーなど)が含まれています。 この設定は、システムが管理するコンポーネントのためのテイントトレランスのみを設定します。 Longhornをどのようにデプロイしたかによって、HelmチャートまたはデプロイメントYAMLファイルでユーザーがデプロイしたコンポーネントのためのテイントトレランスを設定する必要があります。
変更されたトレランス設定を即座に適用するには、すべてのLonghornボリュームがデタッチされていることを確認してください。ボリュームが使用中の場合、SUSE Storageコンポーネントは再起動されず、残りのボリュームをデタッチした後に設定を再構成する必要があります。そうでなければ、設定変更が1時間以内に調整されるのを待つことができます。 Longhornシステムは更新中に操作できないため、SUSE Storageデプロイメント中にトレランスを設定することをお勧めします。
ここでは複数のトレランスを設定でき、これらのトレランスはセミコロンで区切られます。次に例を示します。
-
key1=value1:NoSchedule; key2:NoExecute -
`:`このトレランスはすべてを許容します。なぜなら、オペレーター`Exists`の空のキーがすべてのキー、値、効果に一致するからです。
-
`key1=value1:`このトレランスは空の効果を持っています。キー`key1`を持つすべての効果に一致します。詳細についてはTaint Tolerationを参照してください。
優先度クラス
デフォルト値: longhorn-critical
デフォルトでは、SUSE Storageワークロードはクラスター内の他のポッドと同じ優先度で実行されます。 ノードがメモリ不足などの圧力下にあるとき、SUSE Storageワークロードは他のポッドと同じように追い出されます。
優先度クラス設定は、SUSE Storageシステムワークロードに優先度クラスを割り当てます。 この設定を使用して、これらのワークロードにより高い優先度を与えることができ、ノードがリソース圧力を受けたときに追い出される可能性が低くなります。
SUSE Storageシステムには、ユーザーがデプロイしたコンポーネント(Longhorn Manager、Longhornドライバー、Longhorn UIなど)と、システムが管理するコンポーネント(インスタンスマネージャー、エンジンイメージ、CSIドライバーなど)が含まれています。
この設定は、システムが管理するコンポーネントにのみ適用されます。SUSE Storageをどのようにデプロイしたかに応じて、ユーザーがデプロイしたコンポーネントのPriorityClassをHelmチャートまたはデプロイメントYAMLで設定する必要があります。
|
すべてのLonghornボリュームを切り離した後にのみ、この設定を変更してください。 新しいPriorityClassを適用すると、Longhornシステムコンポーネントが再起動します。 更新中は、システムが利用できず、Longhorn操作は実行できません。 中断を避けるために、最初のSUSE Storageデプロイメント中にPriorityClassを設定してください。 |
詳細については、Priority Classを参照してください。
システム管理コンポーネントのノードセレクター
例: label-key1:label-value1;label-key2:label-value2
SUSE Storageコンポーネントを特定のノードセットでのみ実行するように制限するには、すべてのSUSE Storageコンポーネントのノードセレクターを設定できます。
Longhornシステムには、ユーザーがデプロイしたコンポーネント(例:Longhorn Manager、Longhornドライバー、Longhorn UI)と、システムが管理するコンポーネント(例:インスタンスマネージャー、エンジンイメージ、CSIドライバーなど)が含まれています。 両方のノードセレクターを設定する必要があります。この設定は、システム管理コンポーネントのノードセレクターのみを設定します。ノードセレクターを変更するには、Node Selectorの指示に従ってください。
|
すべてのSUSE Storageコンポーネントが再起動されるため、Longhornシステムは一時的に利用できません。 |
設定を直ちに適用するには、すべてのLonghornボリュームが切り離されていることを確認してください。ボリュームが使用中の場合、SUSE Storageコンポーネントは再起動されず、残りのボリュームをデタッチした後に設定を再構成する必要があります。そうでなければ、設定変更が1時間以内に調整されるのを待つことができます。 ノードセレクター設定が更新され、SUSE Storageコンポーネントが再起動されている間は、Longhornシステムを操作しないでください。
Kubernetesクラスターオートスケーラー有効(実験的)
デフォルト値: false
Kubernetesクラスターオートスケーラー有効を`true`に設定すると、SUSE StorageがKubernetesクラスターオートスケーラーのスケーリングを解除できます。
詳細については、Kubernetes Cluster Autoscaler Supportを参照してください。
| レプリカの再構築は高コストになる可能性があります。なぜなら、再利用可能なレプリカを持つノードがKubernetesクラスターオートスケーラーによって削除される可能性があるからです。 |
ストレージネットワーク
例: kube-system/demo-192-168-0-0
ストレージネットワークは、Multus NetworkAttachmentDefinitionを使用して、クラスター内のデータトラフィックをデフォルトのKubernetesクラスターネットワークから分離します。
デフォルトでは、この設定はLonghornのデータプランのトラフィックパスにのみ適用されます。RWX(リード・ライト・マニー)ボリュームエンドポイントトラフィックについては、RWXボリュームのエンドポイントネットワークを参照してください。
| この設定は、すべてのLonghornボリュームが切り離された後に変更される必要があります。なぜなら、Longhornシステムコンポーネントを実行するいくつかのポッドが設定を適用するために再作成されるからです。すべてのボリュームが切り離されると、SUSE Storageはすぐにすべてのインスタンスマネージャーおよびバックイメージマネージャーポッドを再起動しようとします。ボリュームが使用中の場合、SUSE Storageコンポーネントは再起動されず、残りのボリュームを切り離した後に設定を再構成する必要があります。そうでなければ、設定変更が1時間以内に調整されるのを待つことができます。 |
詳細については、ストレージネットワークを参照してください。
RWXボリュームのエンドポイントネットワーク
デフォルト値: kube-system/demo-172-16-0-0
RWX(リード・ライト・マニー)ボリュームをマウントするための専用ネットワークを提供するには、Multus NetworkAttachmentDefinitionを指定してください。
デフォルトのKubernetesクラスターネットワークを使用するには、これを空白のままにしてください。
|
この設定は、すべてのSUSE Storage RWXボリュームが切り離された後に変更される必要があります。なぜなら、SUSE Storageコンポーネントを実行するいくつかのポッドが設定を適用するために再作成されるからです。すべてのRWXボリュームが切り離されると、SUSE StorageはすぐにすべてのCSIプラグインポッドを再起動しようとします。ボリュームが使用中の場合、SUSE Storageコンポーネントを実行するポッドは再起動されないため、残りのボリュームが切り離された後に設定を再構成する必要があります。手動で設定を再構成できない場合は、設定が毎時同期されるため、待つことを選択できます。 RWXボリュームは、CSIプラグインポッドのコンテナネットワークネームスペース内でエンドポイントネットワークと共にマウントされます。その結果、CSIプラグインポッドを再起動すると、応答しないRWXボリュームマウントが発生する可能性があります。これが発生した場合、マウント接続を再確立するためにワークロードポッドを再起動する必要があります。または、ボリュームが予期せず切り離されたときにワークロードポッドを自動的に削除する設定を有効にすることができます。 |
詳細については、ストレージネットワークを参照してください。
ファイルシステムのトリム中にスナップショットを削除する
例: false
この設定により、Longhornファイルシステムのトリム機能は、最新のスナップショットとその祖先を自動的に削除済みとマークし、複数の子を持つスナップショットで停止します。
Longhornファイルシステムのトリム機能は、ボリュームのヘッドおよびその後に連続して削除されたスナップショット、またはシステムスナップショットにのみ適用されます。
有効なスナップショットから削除されたファイルをトリムしようとしても何も起こらず、ファイルシステムはこの種のメモリ内にあるトリム可能なファイル情報を廃棄します。後でスナップショットを削除済みとしてマークし、トリムを再試行したい場合は、ファイルシステムがトリム可能なファイル情報を再収集できるよう、ファイルシステムをアンマウントして再マウントする必要があります。
詳細についてはファイルシステムのトリムを参照してください。
保証されたインスタンスマネージャーCPU
デフォルト値: {"v1":"12","v2":"12"}
各ノードで各インスタンスマネージャーポッドのために予約する総割り当て可能CPUリソースの割合。例えば、`10`の値は、ノードの総CPUの10%がそのノードの各インスタンスマネージャーポッドに割り当てられることを意味します。これにより、ノードの作業負荷が高い期間中にエンジンとレプリカの安定性が維持されます。
予期しないボリュームインスタンス(エンジン/レプリカ)のクラッシュを防ぎ、相対的に許容可能なIOパフォーマンスを保証するために、次の式を使用してこの設定の値を計算できます:
Guaranteed Instance Manager CPU = The estimated max Longhorn volume engine and replica count on a node * 0.1 / The total allocatable CPUs on the node * 100.
上記の計算結果は、SUSE Storageのワークロードが必要とする最大CPUリソースを意味するものではありません。Longhornボリュームの入力または出力パフォーマンスを最大限に活用するために、この設定を通じてより多くのCPUリソースを割り当てたり保証したりできます。
現在の使用量を見積もるのが難しい場合は、デフォルト値である12%のままにしておくことができます。その後、Longhornボリュームを使用して実行中のワークロードがないときに調整できます。
|
スナップショットのパージを無効にする
デフォルト値: false
trueに設定すると、ボリュームスナップショットをパージするすべての試みを一時的に防ぎます。
SUSE Storageは通常、レプリカの再構築中およびユーザーが開始したスナップショットの削除中にスナップショットをパージします。パージ中、SUSE Storageは不要なスナップショットをそれぞれの最新バージョンに統合し、過去のデータが占めていたスペースを解放します。
通常の操作中にスナップショットのパージを許可することは理想的ですが、このプロセスは一時的に追加のディスクスペースを消費します。十分なディスクスペースがないためにプロセスが続行できない場合は、データが他のディスクに移動される間、一時的にパージを無効にすることを検討してください。
バックアップ削除時のスナップショット自動クリーンアップ
デフォルト値: false
trueに設定すると、バックアップによって使用されたスナップショットは、バックアップが削除されると自動的にクリーンアップされます。
インスタンスマネージャーポッドの生存確認プローブのタイムアウト
デフォルト値: 10(秒)
この設定は、インスタンスマネージャーポッドの生存確認プローブのタイムアウトを指定します。既定値は、10 秒です。
|
設定を適用すると、SUSE Storageはすべてのボリュームが切り離されている場合、すべてのインスタンスマネージャーポッドを再起動し、最終的にインスタンスが実行されていないインスタンスマネージャーポッドを再起動しようとします。 |
データエンジンCPUマスク
デフォルト値: {"v2":"true"}
この設定は、V2データエンジンにのみ適用されます。ストレージパフォーマンス開発キット(SPDK)ターゲットデーモン向けに、ヒュージページを有効にします。この設定が無効にされている場合、レガシーメモリが使用されます。このメモリの割り当てサイズは、データエンジンメモリサイズ設定を通じて設定されます。
データエンジン ヒュージページ有効化
デフォルト値: {"v2":"2048"}
この設定はV2データエンジンにのみ適用され、ストレージパフォーマンス開発キット(SPDK)ターゲットデーモンに割り当てられるメモリサイズ(MiB単位)を指定します。
-
ヒュージページが有効な場合、この値はヒュージページのサイズを定義します。
-
ヒュージページが無効な場合、従来のメモリが使用されます。
データエンジン割り込みモード有効化
デフォルト値: {"v2":"false"}
これは*V2データエンジン*にのみ適用されます。ストレージパフォーマンス開発キット(SPDK)ターゲットデーモンが*割り込みモード*で実行されるか、デフォルトの*ポーリングモード*で実行されるかを制御します。
-
true:割り込みモードを有効にし、割り込みを通じてI/Oを処理することでCPU使用率を削減します。 -
false:最大のパフォーマンスと最低のレイテンシを維持するためにポーリングモードを有効にします。
|
接続されたボリュームでこの設定を変更しないでください。SUSE Storageは接続されたv2ボリュームがある場合、この設定の更新をブロックします。 |
ログパス
デフォルト値: /var/lib/longhorn/logs/
SUSE Storageがインスタンスマネージャーポッドのログファイルを保存するホスト上のディレクトリを指定します。現在、これはv2データエンジンのインスタンスマネージャーポッドにのみ使用されています。
スナップショット重タスクの同時制限
デフォルト値: 5
-
< 1: 無制限の同時重スナップショットタスク。
この設定は、各ノードで同時に実行できるスナップショット重タスク(パージやクローン操作など)の数を制御します。これはベストエフォートメカニズムです。システムが分散しているため、一時的なオーバーサブスクリプションが発生する可能性があります。リミッターは最悪のケースのオーバーロードを減少させますが、完全な強制を保証するものではありません。
システム管理のCSIコンポーネントのリソース制限
デフォルト値: ""
この設定は、システム管理されたCSIコンポーネントのCPUおよびメモリの要求と制限を構成します。
サポートされているコンポーネントには、csi-attacher、csi-provisioner、csi-resizer、csi-snapshotter、longhorn-csi-plugin、node-driver-registrar、および`longhorn-liveness-probe`が含まれます。
値は、コンポーネント名をキーとし、Kubernetes ResourceRequirements(requests`および`limits)を値とするJSONオブジェクトでなければなりません。JSONオブジェクトで定義されたコンポーネントのみが、そのリソース要件を上書きされます。他のすべてのコンポーネントは、SUSE Storageのデフォルト値を使用し続けます。
|
リソース制限を更新すると、影響を受けるCSIコンポーネントが再起動します。再起動中は、ボリュームのプロビジョニング、拡張、スナップショット、およびアタッチまたはデタッチ操作が遅れる可能性があります。既存のマウントされたボリュームは引き続き使用可能です。 |
例
{
"csi-attacher": {
"requests": {"cpu": "100m", "memory": "128Mi"},
"limits": {"cpu": "200m", "memory": "256Mi"}
},
"csi-provisioner": {
"requests": {"cpu": "100m", "memory": "128Mi"},
"limits": {"cpu": "200m", "memory": "256Mi"}
},
"longhorn-csi-plugin": {
"requests": {"cpu": "100m", "memory": "128Mi"},
"limits": {"cpu": "200m", "memory": "256Mi"}
},
"node-driver-registrar": {
"requests": {"cpu": "50m", "memory": "64Mi"},
"limits": {"cpu": "100m", "memory": "128Mi"}
}
}
CSIで許可されたトポロジキー
デフォルト値: ""
例: topology.kubernetes.io/zone
Longhorn CSIドライバーが`NodeGetInfo`で報告し、PV `nodeAffinity`を構築する際に使用すべきトポロジキーのカンマ区切りリストです。空の場合(デフォルト)、トポロジ情報は渡されず、PVsは`nodeAffinity`なしで作成されます。
これを1つ以上の よく知られたKubernetesトポロジラベル(例えば、topology.kubernetes.io/zone)に設定して、StorageClass `allowedTopologies`および`strictTopology`パラメータが有効になるようにします。
|
この設定を変更すると、CSIコンポーネントが再起動します。再起動中は、新しいボリュームのプロビジョニング、拡張、スナップショット、またはアタッチ/デタッチ操作が一時的に遅れる可能性があります。既存のマウントされたボリュームは引き続き使用可能です。 詳細はトポロジ対応プロビジョニングをご覧ください。 |