Ativar uma instância do Filestore em VMs do Cloud TPU

O Filestore é um armazenamento conectado à rede (NAS) totalmente gerenciado para o Compute Engine. Ele oferece disponibilidade nativa para aplicativos empresariais atuais e aceita qualquer cliente compatível com NFSv3.

Antes de começar

Para ativar uma instância do Filestore na VM do Cloud TPU, adicione um papel do Filestore (Editor do Cloud Filestore ou Leitor do Cloud Filestore) à conta de serviço associada à VM do Cloud TPU. Se você não especificar uma conta de serviço personalizada ao criar uma VM do Cloud TPU, a VM vai usar a conta de serviço padrão do Compute Engine. Para saber como especificar uma conta de serviço ao criar uma VM do Cloud TPU, consulte Configurar o ambiente do Cloud TPU. Para saber como criar uma conta de serviço, consulte Criar contas de serviço.

Adicionar o papel de Editor do Filestore a uma conta de serviço

As instruções a seguir mostram como adicionar o papel de Editor do Cloud Filestore à conta de serviço padrão do Compute Engine. Siga estas instruções para adicionar o papel de Editor do Cloud Filestore a qualquer conta de serviço. Você pode pesquisar e usar uma conta de serviço personalizada em vez da conta de serviço padrão do Compute Engine na etapa 2.

Abra o console do IAM.
Selecione a guia Exibir por principais e digite Name:Compute Engine default service account no campo Filtro.
Clique em ao lado da conta de serviço. O console do IAM mostra uma caixa de diálogo com os papéis atribuídos à conta de serviço padrão do Compute Engine.
Clique em para adicionar outro papel.
Expanda o menu suspenso Selecionar um papel, digite Filestore no filtro e selecione Editor do Cloud Filestore.
Clique em Salvar para dispensar a caixa de diálogo. Você adicionou o papel de Editor do Filestore à conta de serviço padrão do Compute Engine.

Para saber mais sobre contas de serviço, consulte Visão geral de contas de serviço. Para saber mais sobre os papéis do IAM, consulte Papéis e permissões.

Criar uma instância do Filestore

Crie uma instância do Filestore seguindo as instruções em Como criar instâncias do Filestore.

Ativar uma instância do Filestore em uma VM do Cloud TPU

Os comandos usados para ativar uma instância do Filestore em um Cloud TPU dependem do uso de um único Cloud TPU ou de uma fração do Cloud TPU.

Ativar uma instância do Filestore em uma VM de Cloud TPU único

Conecte-se à VM do Cloud TPU usando SSH.

      gcloud compute tpus tpu-vm ssh your-tpu-name \
        --zone=your-zone

Instale o pacote nfs-common.

      (vm)$ sudo apt-get update --allow-releaseinfo-change \
        && sudo apt-get -y update \
        && sudo apt-get -y install nfs-common

Crie um diretório para ativar o NFS.

      (vm)$ sudo mkdir -p mount-dir \
        && sudo chmod ugo+rw mount-dir

Encontre o endereço IP do Filestore.

      (vm)$ gcloud filestore instances describe filestore-instance-name \
        --location filestore-region

Ative a instância do Filestore na VM do Cloud TPU no diretório de ativação. Substitua filestore-ip, file-share-name e mount-dir pelo endereço IP do FileStore, pelo nome do compartilhamento de arquivos e pelo diretório de ativação.
```
      (vm)$ sudo mount filestore-ip:file-share-name mount-dir
    
```

Ativar uma instância do Filestore em uma fração do Cloud TPU

As frações do Cloud TPU são compostas por duas ou mais VMs do Cloud TPU. Os comandos a seguir usam o comando gcloud compute tpus tpu-vm ssh com as flags --worker=all e --command para execução em todas as VMs do Cloud TPU de uma só vez.

Instale o pacote nfs-common em todas as VMs do Cloud TPU na fração.

        gcloud compute tpus tpu-vm ssh your-tpu-name \
          --project=your-gcp-project \
          --zone=your-zone \
          --worker=all \
          --command="sudo apt-get update --allow-releaseinfo-change && sudo apt-get -y update && sudo apt-get -y install nfs-common"

Crie um diretório para ativar a instância do Filestore. Substitua mount-dir por um nome de diretório de sua escolha.

      gcloud compute tpus tpu-vm ssh your-tpu-name \
        --project=your-gcp-project \
          --zone=your-zone \
          --worker=all \
          --command="sudo mkdir -p mount-dir && sudo chmod ugo+rw mount-dir"

Encontre o endereço IP da instância do Filestore.

      gcloud filestore instances describe filestore-instance-name \
        --location filestore-region

Ative a instância do Filestore na fração do Cloud TPU. Substitua filestore-ip, file-share-name e mount-dir pelo endereço IP do FileStore, pelo nome do compartilhamento de arquivos e o diretório de ativação.

      gcloud compute tpus tpu-vm ssh your-tpu-name \
        --project=your-gcp-project \
          --zone=your-zone \
          --worker=all \
          --command="sudo mount filestore-ip:file-share-name mount-dir"

Como gravar dados na instância do Filestore

Conceda permissões de leitura e gravação do Linux no diretório em que você ativou a instância do Filestore. É possível usar o diretório como se fosse seu sistema de arquivos local.