Monter des instances Filestore dans des Cloud Workstations

Cloud Workstations peut installer des instances Filestore Network File System (NFS) qui se trouvent dans le même réseau VPC. Plusieurs instances Cloud Workstations peuvent accéder à l'instance Filestore en même temps.

Pour en savoir plus sur Filestore, consultez la documentation Filestore.

Avant de commencer

Avant de commencer, créez votre projet et configurez les rôles IAM requis.

Créer un projet

  1. Dans votre projet de postes de travail, assurez-vous d'avoir activé les API Filestore et Cloud Workstations.

    Activer les API Filestore et Cloud Workstations

  2. Assurez-vous d'installer et d'initialiser la CLI gcloud. Pour initialiser la CLI gcloud, exécutez la commande suivante :

    gcloud init

Rôles requis

Pour obtenir les autorisations nécessaires pour créer et mettre à jour des postes de travail, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet de postes de travail :

  • Si vous êtes administrateur Cloud Workstations, demandez à votre administrateur de vous attribuer le rôle suivant : Administrateur Cloud Workstations (roles/workstations.admin).
  • Si vous êtes l'administrateur Filestore, demandez à votre administrateur de vous attribuer le rôle suivant : Éditeur Filestore (roles/file.editor).

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une instance Filestore

Si vous n'avez pas encore créé d'instance Filestore, créez-en une à l'aide de la commande filestore instances create de la CLI gcloud ci-dessous. Pour en savoir plus sur la dénomination, consultez Nommer votre instance Filestore et Nommer le partage de fichiers.

  gcloud filestore instances create INSTANCE_ID \
    --file-share=name=FILE_SHARE_NAME,capacity=1TiB \
    --tier=ENTERPRISE \
    --network=name=NETWORK_NAME \
    --region=LOCATION \
    --project WORKSTATIONS_PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID permettant d'identifier de manière unique votre instance Filestore.
  • FILE_SHARE_NAME : nom du répertoire diffusé à partir de l'instance Filestore, par exemple vol1.
  • NETWORK_NAME : nom du réseau VPC auquel l'instance est connectée. Il doit correspondre au réseau du cluster Cloud Workstations, par exemple default.
  • LOCATION : région de votre instance Filestore. Elle doit correspondre à la région du cluster de postes de travail.
  • WORKSTATIONS_PROJECT_ID : ID de votre projet Workstations.

Obtenir l'adresse IP de l'instance Filestore

Une fois l'instance Filestore créée, récupérez son adresse IP à l'aide de la commande CLI filestore instances describe gcloud :

  gcloud filestore instances describe INSTANCE_ID \
    --region=LOCATION \
    --project WORKSTATIONS_PROJECT_ID

Remplacez les éléments suivants :

  • INSTANCE_ID : ID permettant d'identifier de manière unique votre instance Filestore.
  • LOCATION : région de votre instance Filestore. Elle doit correspondre à la région du cluster de postes de travail.
  • WORKSTATIONS_PROJECT_ID : ID de votre projet Workstations.

La commande affiche l'adresse IP au format suivant :

...
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - FILESTORE_IP_ADDRESS
...

Notez le FILESTORE_IP_ADDRESS, car vous en aurez besoin lors des étapes suivantes.

Créer un cluster de stations de travail

Si vous n'avez pas encore créé de cluster de postes de travail, créez-en un à l'aide de la commande clusters create de la CLI gcloud :

gcloud workstations clusters create \
    WORKSTATIONS_CLUSTER_NAME \
    --network=NETWORK_NAME \
    --region=LOCATION \
    --project=WORKSTATIONS_PROJECT_ID

Remplacez les éléments suivants :

  • WORKSTATIONS_CLUSTER_NAME : nom du cluster de postes de travail.
  • NETWORK_NAME : nom du réseau VPC auquel les instances Cloud Workstations sont connectées. Il doit correspondre au réseau de l'instance Filestore (par exemple, default).
  • LOCATION : nom de la région de votre cluster de postes de travail. Elle doit correspondre à la région de l'instance Filestore.
  • WORKSTATIONS_PROJECT_ID : ID de votre projet Workstations.

Créer une configuration et une station de travail

Si vous n'avez pas encore créé de configuration Cloud Workstations ni d'instance de station de travail, consultez Créer une configuration de station de travail et Créer une station de travail.

Installer une instance Filestore dans une station de travail

Après avoir lancé l'instance Cloud Workstations, accédez à une fenêtre de terminal et exécutez les commandes suivantes pour installer une instance Filestore :

sudo rpcbind
mkdir -p FILE_SHARE_NAME
sudo mount -o rw,intr FILESTORE_IP_ADDRESS:/FILE_SHARE_NAME FILE_SHARE_NAME

Remplacez les éléments suivants :

  • FILE_SHARE_NAME : nom du répertoire diffusé à partir de l'instance Filestore, par exemple vol1.
  • FILESTORE_IP_ADDRESS : adresse IP de votre instance Filestore.

Une fois la commande mount exécutée, le contenu de l'instance Filestore s'affiche dans le chemin d'accès au partage de fichiers.

Pour en savoir plus sur l'installation d'instances Filestore, consultez Installer des partages de fichiers sur des clients Compute Engine.

Créer une image de conteneur personnalisée pour le montage automatique de Filestore

Vous pouvez utiliser le Dockerfile suivant pour créer une image de conteneur personnalisée qui monte automatiquement une instance Filestore dans Cloud Workstations au démarrage.

FROM us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest

RUN echo "#!/bin/bash\n\
sudo rpcbind\n\
sudo mkdir -p /home/user/FILE_SHARE_NAME\n\
sudo mount -o rw,intr FILESTORE_IP_ADDRESS:/FILE_SHARE_NAME /home/user/FILE_SHARE_NAME" | sudo tee -a /etc/workstation-startup.d/011_mount-filestore.sh

RUN sudo chmod +x /etc/workstation-startup.d/011_mount-filestore.sh

Remplacez les éléments suivants :

  • FILE_SHARE_NAME : nom du répertoire diffusé à partir de l'instance Filestore, par exemple vol1.
  • FILESTORE_IP_ADDRESS : adresse IP de votre instance Filestore.

Pour en savoir plus sur la création d'une image de conteneur personnalisée pour Cloud Workstations, consultez Personnaliser les images de conteneur.