Configurer le stockage local

Cette page vous explique comment configurer des volumes locaux pour les clusters Google Distributed Cloud.

Les clusters Google Distributed Cloud fournissent deux options pour configurer des volumes persistants locaux (LVP) dans un cluster : le partage LVP et les installations de nœuds LVP. Le partage LVP utilise des répertoires dans un système de fichiers partagé, tandis que les installations de nœuds LVP utilisent des disques dédiés.

Partage LVP

Cette classe de stockage crée un PV local sauvegardé par des sous-répertoires dans un système de fichiers local partagé sur chaque nœud du cluster. Ces sous-répertoires sont générés automatiquement lors de la création du cluster. Les charges de travail utilisant cette classe de stockage partagent la capacité et les IOPS, car les PV sont sauvegardés par le même système de fichiers partagé. Pour une meilleure isolation, nous vous recommandons plutôt de configurer des disques via des montages de nœuds LVP.

Configurer un partage LVP

Facultatif : Avant la création du cluster, installez un disque en utilisant le chemin configuré comme point d'installation afin que les volumes persistants créés partagent la capacité du disque et soient isolés du disque de démarrage.
Spécifiez les éléments suivants sous lvpShare dans la configuration du cluster :
- path : chemin d'accès à la machine hôte sur chaque hôte où des sous-répertoires sont créés. Un volume persistant local est créé pour chaque sous-répertoire. Le chemin par défaut est /mnt/localpv-share.
- storageClassName : classe de stockage avec laquelle les volumes persistants sont créés lors de la création du cluster. La valeur par défaut est local-shared.
- numPVUnderSharedPath : nombre de sous-répertoires à créer sous path. La valeur par défaut est 5.
La configuration ressemble à ceci :
```
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
spec:
  storage:
    lvpShare:
      path: /mnt/localpv-share
      storageClassName: local-shared
      numPVUnderSharedPath: 5
```

Les volumes persistants sont créés avec la classe de stockage spécifiée dans storageClassName. Le nombre total de volumes persistants locaux créés dans le cluster est numPVUnderSharedPath multiplié par le nombre de nœuds.

Installations de nœuds LVP

Cette classe de stockage crée un PV local pour chaque disque installé dans le répertoire configuré. Chaque PV est associé à un disque ayant une capacité égale à la capacité de disque sous-jacente. Le nombre total de PV locaux créés dans le cluster correspond au nombre de disques installés sous le chemin d'accès de tous les nœuds. Des installations supplémentaires peuvent être ajoutées après la création du cluster.

Configurer des installations de nœuds LVP

Sur les nœuds disposant de disques supplémentaires pour les PV, formatez et installez chaque disque sous le chemin d'accès. Vous pouvez également effectuer cette opération avant ou après la création du cluster. Consultez les bonnes pratiques.
1. Répertoriez les disques et recherchez celui que vous souhaitez installer :
```
sudo lsblk
```
2. Formatez le disque, par exemple avec un seul système de fichiers ext4 :
```
sudo mkfs.ext4 -m 0 -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/DEVICE_ID
```
3. Sous le chemin configuré, créez un répertoire comme point d'installation pour le nouveau disque :
```
sudo mkdir -p /mnt/localpv-disk/MNT_DIR
```
4. Installez le disque :
```
sudo mount -o discard,defaults /dev/DEVICE_ID /mnt/localpv-disk/MNT_DIR &&
sudo chmod a+w /mnt/localpv-disk/MNT_DIR
```
5. Ajoutez le disque au fichier /etc/fstab, afin qu'il soit installé de nouveau automatiquement au redémarrage de l'instance :
```
# Backup of your current /etc/fstab file
sudo cp /etc/fstab /etc/fstab.backup

# Use the blkid command to find the UUID for the zonal persistent disk
sudo blkid /dev/DEVICE_ID

# Edit /etc/fstab file: create an entry that includes the UUID
UUID=UUID_VALUE /mnt/localpv-disk/MNT_DIR ext4 discard,defaults,NOFAIL_OPTION 0 2
```
Spécifiez les éléments suivants sous lvpNodeMounts dans la configuration du cluster :
- path : chemin d'accès à la machine hôte pour chaque installation où des disques installés sont détectés et un volume persistant local est créé. Le chemin par défaut est /mnt/localpv-disk.
- storageClassName : classe de stockage avec laquelle les volumes persistants sont créés lors de la création du cluster. La valeur par défaut est local-disks.
La configuration ressemble à ceci :
```
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
spec:
  storage:
    lvpNodeMounts:
      path: /mnt/localpv-disk
      storageClassName: local-disks
```
Les volumes persistants sont créés avec la classe de stockage spécifiée dans storageClassName. Le nombre total de volumes persistants créés correspond au nombre de disques installés sous path sur l'ensemble des nœuds.

Étape suivante

Découvrez comment configurer la classe de stockage par défaut.