Installer des instances Filestore dans des stations de travail Cloud

Cloud Workstations peut installer Filestore Instances NFS (Network File System) situées dans le même VPC réseau. L'instance Filestore est accessible depuis plusieurs Cloud Workstations en même temps.

Pour en savoir plus sur Filestore, consultez la Documentation Filestore

Avant de commencer

Créer un projet

  1. Dans votre projet de stations 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 stations de travail, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet de stations de travail :

  • Si vous êtes l'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 accorder le rôle suivant : Éditeur Filestore (roles/file.editor).

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

Vous pouvez également obtenir les autorisations requises via 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 le choix du nom, consultez les sections 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 : identifiant permettant d'identifier de manière unique votre instance Filestore.
  • FILE_SHARE_NAME: nom du répertoire diffusé à partir du Instance Filestore (par exemple, vol1).
  • NETWORK_NAME: nom du réseau VPC à laquelle 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. Il doit correspondre à la région du cluster de stations de travail.
  • WORKSTATIONS_PROJECT_ID: ID de vos stations de travail projet.

Obtenir l'adresse IP de l'instance Filestore

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

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

Remplacez les éléments suivants :

  • INSTANCE_ID : identifiant 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 stations de travail.
  • WORKSTATIONS_PROJECT_ID: ID de vos stations de travail projet.

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 dans les étapes suivantes.

Créer un cluster de stations de travail

Si vous n'avez pas encore créé de cluster de stations 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 stations de travail.
  • NETWORK_NAME: nom du réseau VPC auxquelles 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 stations de travail. Il doit correspondre à la région de l'instance Filestore.
  • WORKSTATIONS_PROJECT_ID : ID de votre projet de stations de travail.

Créer une configuration de station de travail et une station de travail

Si vous n'avez pas encore créé de configuration Cloud Workstations et une 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 sur un poste de travail

Après avoir lancé l'instance Cloud Workstations, accédez à une fenêtre de terminal et exécutez 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 du 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 l'installation 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 du 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 Pour Cloud Workstations, consultez la page Personnaliser les images de conteneurs.