Montar instâncias do Filestore nos Cloud Workstations

O Cloud Workstations pode ativar instâncias do Network File System (NFS) do Filestore que estão na mesma rede VPC. A instância do Filestore pode ser acessada por várias instâncias do Cloud Workstations ao mesmo tempo.

Para mais informações sobre o Filestore, consulte a documentação do Filestore.

Antes de começar

Antes de começar, crie seu projeto e configure os papéis do IAM necessários.

Criar seu projeto

  1. No projeto de estações de trabalho, verifique se você ativou as API Filestore e Cloud Workstations.

    Ativar as APIs Filestore e Cloud Workstations

  2. Verifique se você instalou e inicializou a gcloud CLI. Para inicializar a gcloud CLI, execute o seguinte comando:

    gcloud init

Funções exigidas

Para receber as permissões necessárias para criar e atualizar estações de trabalho, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto de estações de trabalho:

  • Se você for o administrador do Cloud Workstations, peça ao administrador para conceder a você o seguinte papel: Administrador do Cloud Workstations (roles/workstations.admin).
  • Se você for o administrador do Filestore, peça ao administrador para conceder a você o seguinte papel: Editor do Filestore (roles/file.editor).

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Criar uma instância do Filestore

Se você ainda não criou uma instância do Filestore, crie uma usando a CLI gcloud filestore instances create a seguir. Para informações sobre nomenclatura, consulte Como nomear sua instância do Filestore e Como nomear o compartilhamento de arquivos.

  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

Substitua:

  • INSTANCE_ID: o ID para identificar exclusivamente sua instância do Filestore.
  • FILE_SHARE_NAME: o nome do diretório veiculado na instância do Filestore, por exemplo, vol1.
  • NETWORK_NAME: o nome da rede VPC a que a instância está conectada. Ele precisa corresponder à rede do cluster do Cloud Workstations, por exemplo, default.
  • LOCATION: a região da instância do Filestore. Ele precisa corresponder à região do cluster da estação de trabalho.
  • WORKSTATIONS_PROJECT_ID: o ID do projeto de estações de trabalho.

Receber o endereço IP da instância do Filestore

Depois que a instância do Filestore for criada, receba o endereço IP dela usando o comando filestore instances describe gcloud da CLI:

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

Substitua:

  • INSTANCE_ID: o ID para identificar exclusivamente sua instância do Filestore.
  • LOCATION: a região da instância do Filestore. Ele precisa corresponder à região do cluster da estação de trabalho.
  • WORKSTATIONS_PROJECT_ID: o ID do projeto de estações de trabalho.

O comando imprime o endereço IP no seguinte formato:

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

Anote o FILESTORE_IP_ADDRESS, porque você vai precisar dele nas etapas subsequentes.

Criar cluster de estações de trabalho

Se você ainda não criou um cluster de estações de trabalho, crie um usando o gcloud CLI clusters create comando:

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

Substitua:

  • WORKSTATIONS_CLUSTER_NAME: o nome do cluster de estações de trabalho.
  • NETWORK_NAME: o nome da rede VPC a que as instâncias do Cloud Workstations estão conectadas. Ele precisa corresponder à rede da instância do Filestore, por exemplo, default.
  • LOCATION: o nome da região do cluster de estações de trabalho. Ele precisa corresponder à região da instância do Filestore.
  • WORKSTATIONS_PROJECT_ID: o ID do projeto de estações de trabalho.

Criar uma configuração e uma estação de trabalho

Se você ainda não criou uma configuração do Cloud Workstations e uma instância de estação de trabalho, consulte Criar uma configuração de estação de trabalho e Criar uma estação de trabalho.

Ativar uma instância do Filestore em uma estação de trabalho

Depois de iniciar a instância do Cloud Workstations, acesse uma janela de terminal e execute os seguintes comandos para ativar uma instância do Filestore:

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

Substitua:

  • FILE_SHARE_NAME: o nome do diretório veiculado na instância do Filestore, por exemplo, vol1.
  • FILESTORE_IP_ADDRESS: o endereço IP da instância do Filestore.

Depois que o comando mount for concluído, você verá o conteúdo da instância do Filestore no caminho do compartilhamento de arquivos.

Para mais informações sobre como ativar instâncias do Filestore, consulte Como ativar compartilhamentos de arquivos em clientes do Compute Engine.

Criar uma imagem de contêiner personalizada para a ativação automática do Filestore

Você pode usar o Dockerfile a seguir para criar uma imagem de contêiner personalizada que monta uma instância do Filestore no Cloud Workstations automaticamente na inicialização.

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

Substitua:

  • FILE_SHARE_NAME: o nome do diretório veiculado na instância do Filestore, por exemplo, vol1.
  • FILESTORE_IP_ADDRESS: o endereço IP da instância do Filestore.

Para mais informações sobre como criar uma imagem de contêiner personalizada para o Cloud Workstations, consulte Personalizar imagens de contêiner.