Ce document a été traduit à l'aide d'une technologie de traduction automatique. Bien que nous nous efforcions de fournir des traductions exactes, nous ne fournissons aucune garantie quant à l'exhaustivité, l'exactitude ou la fiabilité du contenu traduit. En cas de divergence, la version originale anglaise prévaut et fait foi.

Il s'agit d'une documentation non publiée pour SUSE® Storage 1.12 (Dev).

Personnaliser les paramètres par défaut

Vous pouvez personnaliser les paramètres par défaut de SUSE Storage lors de l’installation ou de la mise à niveau. Vous pouvez spécifier, par exemple, Create Default Disk With Node Labeled et Default Data Path avant de commencer SUSE Storage.

Lors de l’utilisation du fichier YAML de déploiement Longhorn ou de Helm pour l’installation, la mise à jour ou la mise à niveau, si la valeur d’un paramètre par défaut est une chaîne vide et valide, le paramètre par défaut sera nettoyé dans SUSE Storage. Sinon, SUSE Storage ignorera les valeurs invalides et ne mettra pas à jour les valeurs par défaut.

Installation

Utiliser l’interface utilisateur de Rancher

Depuis la vue projet dans Rancher, allez à Applications et Marketplace Longhorn Installer Suivant Modifier les options Paramètres par défaut de Longhorn Personnaliser les paramètres par défaut et modifiez les paramètres avant d’installer l’appli.

Utiliser le fichier YAML de déploiement Longhorn

Téléchargez le dépôt longhorn :

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

Modifiez la carte de configuration nommée longhorn-default-setting dans le fichier YAML longhorn/deploy/longhorn.yaml.

Dans l’exemple ci-dessous, les utilisateurs personnalisent les paramètres par défaut, la cible de sauvegarde, le secret d’identification de la cible de sauvegarde et le chemin de données par défaut. Lorsque le paramètre est absent ou a un symbole # en tête, le paramètre par défaut utilisera la valeur par défaut dans SUSE Storage ou les valeurs personnalisées précédemment configurées.

---
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:
---

Utiliser Helm

Utilisez Helm 3 lors de l’installation et de la mise à niveau de SUSE Storage. Helm 2 n’est plus pris en charge.

Utilisez la commande Helm avec le drapeau --set pour modifier les paramètres par défaut. Par exemple :

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

Vous pouvez également fournir une copie du fichier values.yaml avec les paramètres par défaut modifiés au drapeau --values lors de l’exécution de la commande Helm :

Obtenez une copie du fichier values.yaml depuis GitHub :

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

Modifiez les paramètres par défaut dans le fichier YAML. Voici un extrait d’exemple de values.yaml :

Lorsque le paramètre est absent ou a un symbole # en tête, le paramètre par défaut utilisera la valeur par défaut dans SUSE Storage ou les valeurs personnalisées précédemment configurées.

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

Exécutez Helm avec values.yaml :

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

Pour plus d’informations sur l’utilisation de Helm, consultez la section installer SUSE Storage avec Helm.

Utilisation du Contrôleur Helm

Dans le fichier YAML de HelmChart, ajoutez des lignes à spec.set avec les paramètres souhaités :

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

Utilisation du Contrôleur Helm

Dans le fichier YAML de HelmChart, ajoutez des lignes à spec.set avec les paramètres souhaités :

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

Paramètres de mise à jour

Utilisation de l’interface utilisateur SUSE Storage

Nous recommandons d’utiliser l’interface utilisateur SUSE Storage pour modifier le paramètre SUSE Storage sur le cluster existant. Cela rendrait le paramètre persistant.

Utiliser l’interface utilisateur de Rancher

Depuis la vue projet dans Rancher, allez à Apps && Marketplace Longhorn Mettre à niveau Suivant Modifier les options Paramètres par défaut de Longhorn Personnaliser les paramètres par défaut et modifiez les paramètres avant de mettre à niveau l’appli vers la version actuelle SUSE Storage.

Utilisation de Kubectl

Si vous préférez mettre à jour le paramètre depuis la ligne de commande, utilisez kubectl. Pour éviter les collisions avec d’autres CRD, n’utilisez pas le simple settings. Utilisez plutôt settings.longhorn.io ou lhs.

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

Utiliser Helm

Modifiez les paramètres par défaut dans le fichier YAML comme décrit dans Installation fraîche > Utilisation de Helm puis mettez à jour les paramètres en utilisant

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

Mise à niveau

Utiliser l’interface utilisateur de Rancher

Utiliser le fichier YAML de déploiement Longhorn

Modifiez la carte de configuration nommée longhorn-default-setting dans le fichier YAML longhorn/deploy/longhorn.yaml comme décrit dans Installation fraîche > Utilisation du fichier YAML de déploiement Longhorn puis mettez à niveau le système Longhorn en utilisant kubectl.

Utiliser Helm

Modifiez les paramètres par défaut dans le fichier YAML comme décrit dans Installation fraîche > Utilisation de Helm puis mettez à niveau le système Longhorn en utilisant helm upgrade.

History

Disponible depuis v1.3.0 (Référence)