この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

デフォルト設定のカスタマイズ

インストールまたはアップグレード中に、SUSE Storageのデフォルト設定をカスタマイズできます。例えば、`Create Default Disk With Node Labeled`と`Default Data Path`を、SUSE Storageの開始前に指定できます。

LonghornデプロイメントYAMLファイルまたはHelmを使用してインストール、更新、またはアップグレードする際に、デフォルト設定の値が空の文字列で有効な場合、デフォルト設定はSUSE Storageでクリーンアップされます。そうでない場合、SUSE Storageは無効な値を無視し、デフォルト値を更新しません。

インストール

Rancher UIの使用

Rancherのプロジェクトビューから、アプリとマーケットプレイス  Longhorn  インストール  次へ  オプションの編集  Longhornデフォルト設定  デフォルト設定のカスタマイズに移動し、アプリをインストールする前に設定を編集します。

LonghornデプロイメントYAMLファイルの使用

  1. Longhornリポジトリをダウンロードします。

    git clone https://github.com/longhorn/longhorn.git

  2. YAMLファイル`longhorn/deploy/longhorn.yaml`の`longhorn-default-setting`という名前の設定マップを修正します。

    以下の例では、ユーザーはデフォルト設定、バックアップターゲット、バックアップターゲットクレデンシャルシークレット、およびデフォルトデータパスをカスタマイズします。 設定が存在しない場合、または先頭に`#`記号がある場合、デフォルト設定はSUSE Storageのデフォルト値または以前に構成されたカスタマイズされた値を使用します。

    ---
apiVersion: v1
kind: ConfigMap
metadata:
  name: longhorn-default-setting
  namespace: longhorn-system
data:
  default-setting.yaml: |-
    backup-target: s3://backupbucket@us-east-1/backupstore
    backup-target-credential-secret: minio-secret
    #allow-recurring-job-while-volume-detached:
    #create-default-disk-labeled-nodes:
    default-data-path: /var/lib/longhorn-example/
    #replica-soft-anti-affinity:
    #replica-auto-balance:
    #storage-over-provisioning-percentage:
    #storage-minimal-available-percentage:
    #upgrade-checker:
    #upgrade-responder-url:
    #default-replica-count:
    #default-data-locality:
    #default-longhorn-static-storage-class:
    #backupstore-poll-interval:
    #taint-toleration:
    #system-managed-components-node-selector:
    #priority-class:
    #auto-salvage:
    #auto-delete-pod-when-volume-detached-unexpectedly:
    #disable-scheduling-on-cordoned-node:
    #replica-zone-soft-anti-affinity:
    #replica-disk-soft-anti-affinity:
    #node-down-pod-deletion-policy:
    #node-drain-policy:
    #replica-replenishment-wait-interval:
    #concurrent-replica-rebuild-per-node-limit:
    #disable-revision-counter:
    #system-managed-pods-image-pull-policy:
    #allow-volume-creation-with-degraded-availability:
    #auto-cleanup-system-generated-snapshot:
    #concurrent-automatic-engine-upgrade-per-node-limit:
    #backing-image-cleanup-wait-interval:
    #backing-image-recovery-wait-interval:
    #guaranteed-instance-manager-cpu:
    #kubernetes-cluster-autoscaler-enabled:
    #orphan-resource-auto-deletion:
    #storage-network:
    #recurring-successful-jobs-history-limit:
    #recurring-failed-jobs-history-limit:
---

Helmの使用

SUSE Storageをインストールおよびアップグレードする際は、Helm 3を使用してください。Helm 2は サポートされなくなりました。

デフォルト設定を変更するには、`--set`フラグを使用してHelmコマンドを実行します。次に例を示します。

helm install longhorn longhorn/longhorn \
  --namespace longhorn-system \
  --create-namespace \
  --set defaultSettings.taintToleration="key1=value1:NoSchedule; key2:NoExecute"

Helmコマンドを実行する際に、デフォルト設定が変更された`values.yaml`ファイルのコピーを`--values`フラグに提供することもできます：

  1. GitHubから`values.yaml`ファイルのコピーを取得します。

    curl -Lo values.yaml https://raw.githubusercontent.com/longhorn/charts/master/charts/longhorn/values.yaml

  2. YAMLファイル内のデフォルト設定を修正します。以下は`values.yaml`の例のスニペットです。

    設定が存在しない場合、または先頭に`#`記号がある場合、デフォルト設定はSUSE Storageのデフォルト値または以前に構成されたカスタマイズされた値を使用します。

    defaultSettings:
  backupTarget: s3://backupbucket@us-east-1/backupstore
  backupTargetCredentialSecret: minio-secret
  createDefaultDiskLabeledNodes: true
  defaultDataPath: /var/lib/longhorn-example/
  replicaSoftAntiAffinity: false
  storageOverProvisioningPercentage: 600
  storageMinimalAvailablePercentage: 15
  upgradeChecker: false
  defaultReplicaCount: 2
  defaultDataLocality: disabled
  defaultLonghornStaticStorageClass: longhorn-static-example
  backupstorePollInterval: 500
  taintToleration: key1=value1:NoSchedule; key2:NoExecute
  systemManagedComponentsNodeSelector: "label-key1:label-value1"
  priorityClass: high-priority
  autoSalvage: false
  disableSchedulingOnCordonedNode: false
  replicaZoneSoftAntiAffinity: false
  replicaDiskSoftAntiAffinity: false
  volumeAttachmentRecoveryPolicy: never
  nodeDownPodDeletionPolicy: do-nothing
  guaranteedInstanceManagerCpu: 15
  orphanAutoDeletion: ""
  orphanResourceAutoDeletionGracePeriod: 300

  3. `values.yaml`を使用してHelmを実行します:

    helm install longhorn longhorn/longhorn \
  --namespace longhorn-system \
  --create-namespace \
  --values values.yaml

Helmの使用に関する詳細は、HelmでSUSE Storageをインストールするのセクションを参照してください。

Helm Controllerの使用

HelmChart YAMLファイルで、希望する設定をspec.setに追加します:

spec:
  ...
  set:
    defaultSettings.priorityClass: system-node-critical
    defaultSettings.replicaAutoBalance: least-effort
    defaultSettings.storageOverProvisioningPercentage: "200"
    persistence.defaultClassReplicaCount: "2"

Helmコントローラーを使用する

HelmChart YAMLファイルで、希望する設定を`spec.set`に追加します:

spec:
  ...
  set:
    defaultSettings.priorityClass: system-node-critical
    defaultSettings.replicaAutoBalance: least-effort
    defaultSettings.storageOverProvisioningPercentage: "200"
    persistence.defaultClassReplicaCount: "2"

アップデートの設定

SUSE Storage UIを使用する

既存のクラスターでSUSE Storage設定を変更するには、SUSE Storage UIの使用をお勧めします。これにより設定が永続化されます。

Rancher UIの使用

Rancherのプロジェクトビューから、アプリ＆マーケットプレイス  Longhorn  アップグレード  次へ  オプションを編集  Longhornのデフォルト設定  デフォルト設定をカスタマイズに移動し、アプリを現在のSUSE Storageバージョンにアップグレードする前に設定を編集します。

Kubectlを使用する

コマンドラインから設定を更新する場合は、`kubectl`を使用してください。他のCRDとの衝突を避けるため、単純な`settings`は使用しないでください。代わりに、`settings.longhorn.io`または`lhs`を使用してください。

kubectl edit settings.longhorn.io <SETTING-NAME> -n longhorn-system

Helmの使用

新規インストール > Helmの使用に記載されているように、YAMLファイルのデフォルト設定を変更し、その後、設定を更新します。

helm upgrade longhorn longhorn/longhorn --namespace longhorn-system --values ./values.yaml --version `helm list -n longhorn-system -o json | jq -r .'[0].app_version'`

アップグレード

Rancher UIの使用

Rancherのプロジェクトビューから、アプリ＆マーケットプレイス  Longhorn  アップグレード  次へ  オプションを編集  Longhornのデフォルト設定  デフォルト設定をカスタマイズに移動し、アプリをアップグレードする前に設定を編集します。

LonghornデプロイメントYAMLファイルの使用

新規インストール > LonghornデプロイメントYAMLファイルの使用に記載されているように、YAMLファイル`longhorn/deploy/longhorn.yaml`の`longhorn-default-setting`という名前の設定マップを変更し、その後、`kubectl`を使用してLonghornシステムをアップグレードします。

Helmの使用

新規インストール > Helmの使用に記載されているように、YAMLファイルのデフォルト設定を変更し、その後、`helm upgrade`を使用してLonghornシステムをアップグレードします。

履歴

v1.3.0以降利用可能 (参照)