Accéder au stockage persistant

Le stockage persistant dans Google Distributed Cloud (GDC) avec air gap vous permet de conserver les données des conteneurs indépendamment du cycle de vie des pods. Vous pouvez revendiquer des volumes avec des ressources PersistentVolumeClaim (PVC) et augmenter la capacité pour conserver l'état lors des redémarrages et des reprogrammations.

Ce document s'adresse aux développeurs du groupe d'opérateurs d'applications qui créent des charges de travail pour leur organisation. Pour en savoir plus, consultez la documentation sur les audiences pour GDC sous air gap.

Avant de commencer

Pour effectuer les tâches décrites dans ce document, vous devez demander les autorisations nécessaires et préparer votre environnement.

Demander des rôles IAM

Vous devez disposer de rôles spécifiques pour obtenir les autorisations nécessaires pour accéder au stockage persistant. Les rôles dont vous avez besoin dépendent de l'environnement dans lequel vous travaillez : un cluster partagé au niveau de l'organisation ou un cluster standard au niveau du projet. Pour en savoir plus, consultez Configurations de clusters Kubernetes.

Rôles de cluster partagés

Pour créer, supprimer, modifier ou afficher des volumes persistants dans un cluster partagé, demandez à votre administrateur de projet IAM de vous accorder le rôle Administrateur d'espace de noms (namespace-admin). Ce rôle est lié à l'espace de noms de votre projet.

Rôles de cluster standards

Pour créer, supprimer, modifier ou afficher des volumes persistants dans un cluster standard, demandez à l'administrateur de projet IAM de vous accorder le rôle Développeur de cluster (cluster-developer). Ce rôle est lié à l'espace de noms de votre projet.

Préparer votre environnement

Pour exécuter des commandes sur un cluster Kubernetes à l'aide de l'API, assurez-vous de disposer des ressources suivantes :

  • Recherchez le nom du cluster Kubernetes ou demandez-le à un membre du groupe d'administrateurs de la plate-forme.

  • Connectez-vous et générez le fichier kubeconfig pour le cluster Kubernetes.

  • Utilisez le chemin d'accès kubeconfig du cluster Kubernetes pour remplacer KUBERNETES_CLUSTER_KUBECONFIG dans ces instructions.

Créer un volume persistant

Les instructions suivantes montrent comment créer un volume à l'aide de la StorageClass standard-rwo de GDC. Pour en savoir plus sur les ressources StorageClass disponibles dans GDC, consultez Stockage persistant pour les conteneurs.

  1. Créez une ressource PersistentVolumeClaim (PVC) et configurez-la avec un mode d'accès ReadWriteOnce et une classe de stockage standard-rwo :

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: PVC_NAME
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi
  storageClassName: standard-rwo
EOF

    Remplacez les éléments suivants :

    • KUBERNETES_CLUSTER_KUBECONFIG : fichier kubeconfig du cluster.

    • NAMESPACE : espace de noms dans lequel créer la PVC. Pour les clusters partagés, il doit s'agir d'un espace de noms de projet. Pour les clusters standards, il peut s'agir de n'importe quel espace de noms.

    • PVC_NAME : nom de l'objet PersistentVolumeClaim.

  2. Vérifiez que l'objet PVC est disponible :

    kubectl get pvc --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE

    Le résultat ressemble à ce qui suit :

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
pvc-uuid   10Gi       RWO            Bound       pvc-name  standard-rwo   60s

  3. Configurez vos charges de travail de conteneur pour qu'elles utilisent la PVC. Voici un exemple de pod nginx qui utilise une PVC standard-rwo :

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: v1
kind: Pod
metadata:
  name: web-server-deployment
  labels:
    app: nginx
spec:
  containers:
  - name: nginx
    image: nginx
    volumeMounts:
    - mountPath: /usr/share/nginx/html
      name: data
  volumes:
  - name: data
    persistentVolumeClaim:
      claimName: PVC_NAME
EOF

    Remplacez PVC_NAME par la PVC que vous avez créée.

Augmenter la capacité du volume

Pour augmenter la capacité d'un objet PersistentVolumeClaim, remplacez le champ spec.resources.storage par la nouvelle capacité. La taille maximale de volume acceptée est de 14,5 Tio.

  1. Augmentez la taille du volume dans le fichier manifeste de l'objet PersistentVolumeClaim :

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: PVC_NAME
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: VOLUME_STORAGE_SIZE
EOF

    Remplacez les éléments suivants :

    • KUBERNETES_CLUSTER_KUBECONFIG : fichier kubeconfig du cluster.

    • NAMESPACE : espace de noms dans lequel se trouve la ressource PVC. Pour les clusters partagés, il doit s'agir d'un espace de noms de projet. Pour les clusters standards, il peut s'agir de n'importe quel espace de noms.

    • PVC_NAME : nom de la PVC pour laquelle vous augmentez la taille de stockage.

    • VOLUME_SNAPSHOT_SIZE : taille de l'espace de stockage à augmenter, par exemple 50Gi.

  2. Vérifiez l'état des volumes persistants mis à jour dans votre cluster :

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG

Étapes suivantes