Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Montar uma instância do Filestore em VMs do Cloud TPU
O Filestore é um armazenamento conectado à rede (NAS) totalmente gerenciado para o Compute Engine. O Filestore oferece compatibilidade nativa com os aplicativos
empresariais atuais e é compatível com qualquer cliente compatível com NFSv3.
Antes de começar
Para montar uma instância do Filestore na VM do Cloud TPU, você
precisa adicionar um papel do Filestore (editor 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, ela vai usar a conta de serviço padrão
do Compute Engine. Para mais informações sobre como especificar uma
conta de serviço ao criar uma VM do Cloud TPU, consulte
Configurar o ambiente do Cloud TPU.
Para mais informações sobre 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 a função 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. É possível pesquisar e usar uma conta de serviço personalizada em vez da
conta de serviço padrão do Compute Engine na etapa 2.
Selecione a guia Visualizar por principais e digite Name:Compute Engine default
service account no campo Filtro.
Clique em edit ao lado da conta de serviço.
O console do IAM mostra uma caixa de diálogo com a lista de papéis atribuídos
à conta de serviço padrão do Compute Engine.
Clique em add para adicionar outro papel.
Abra 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.
Monte a instância do Filestore na VM do Cloud TPU no seu diretório de montagem. Substitua filestore-ip, file-share-name e mount-dir pelo endereço IP, nome do compartilhamento de arquivos e diretório de montagem do FileStore.
Montar uma instância do Filestore em um slice 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 executar os comandos em todas as VMs da Cloud TPU de uma só vez.
Instale o pacote nfs-common em todas as VMs do Cloud TPU na sua fatia.
Monte a instância do Filestore no seu slice do Cloud TPU.
Substitua filestore-ip, file-share-name e mount-dir pelo endereço IP, nome do compartilhamento de arquivos e diretório de montagem do FileStore.
gcloudcomputetpustpu-vmsshyour-tpu-name\--project=your-gcp-project\--zone=your-zone\--worker=all\--command="sudo mount filestore-ip:file-share-namemount-dir"
Como gravar dados na instância do Filestore
Garanta que você concede permissões de leitura e gravação do Linux no diretório em que
monta a instância do Filestore. Você pode usar o diretório como
se fosse seu sistema de arquivos local.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# Mount a Filestore instance to Cloud TPU VMs\n\nMount a Filestore instance to\nCloud TPU VMs\n===========================================\n\nFilestore is a fully managed network attached storage (NAS) for\nCompute Engine. Filestore offers native compatibility with existing\nenterprise applications and supports any NFSv3-compatible client.\n\nBefore you begin\n----------------\n\nIn order to mount a Filestore instance on your Cloud TPU VM, you\nneed to add a Filestore role (Cloud Filestore Editor or Cloud\nFilestore Viewer) to the service account associated with your\nCloud TPU VM. If you don't specify a custom service account when\nyou create a Cloud TPU VM, your Cloud TPU VM uses the default\nCompute Engine service account. For more information about how to specify a\nservice account when creating a Cloud TPU VM, see\n[Set up the Cloud TPU environment](/tpu/docs/setup-gcp-account#prepare-to-request).\nFor more information about how to create a service account, see\n[Create service accounts](/iam/docs/service-accounts-create).\n\n### Add the Filestore Editor role to a service account\n\nThe following instructions show you how to add the Cloud Filestore\nEditor role to the Compute Engine default service account. You can follow these\ninstructions to add the Cloud Filestore Editor role to any service\naccount. You can search and use a custom service account instead of the\nCompute Engine default service account in step 2.\n\n1. Open the [IAM console](https://console.cloud.google.com/iam-admin/iam).\n\n2. Select the **View by principals** tab and type `Name:Compute Engine default\n service account` in the **Filter** field.\n\n3. Click edit next to the service account.\n The IAM console displays a dialog listing the roles assigned\n to the Compute Engine default service account.\n\n4. Click add to add another role.\n\n5. Expand the **Select a role** drop down menu, type `Filestore` in the\n filter, and select **Cloud Filestore editor**.\n\n6. Click **Save** to dismiss the dialog. You have added the Filestore\n Editor role to the Compute Engine default service account.\n\nFor more information about service accounts, see [Service Account Overview](/iam/docs/service-account-overview).\nTo learn more about IAM roles, see [Roles and permissions](/iam/docs/roles-overview).\n\n### Create a Filestore instance\n\nCreate a Filestore instance using the instructions found in\n[Creating Filestore instances](/filestore/docs/creating-instances).\n\nMount a Filestore instance on a Cloud TPU VM\n--------------------------------------------\n\nThe commands you use to mount a Filestore instance on a Cloud TPU\ndepends on whether you are using a single Cloud TPU or a Cloud TPU\nslice.\n\n### Mount a Filestore instance on a single Cloud TPU VM\n\n1. Connect to your Cloud TPU VM using SSH. \n\n ```bash\n gcloud compute tpus tpu-vm ssh your-tpu-name \\\n --zone=your-zone\n \n ```\n2. Install the `nfs-common` package. \n\n ```bash\n (vm)$ sudo apt-get update --allow-releaseinfo-change \\\n && sudo apt-get -y update \\\n && sudo apt-get -y install nfs-common\n \n ```\n3. Create a directory in which to mount NFS \n\n ```bash\n (vm)$ sudo mkdir -p mount-dir \\\n && sudo chmod ugo+rw mount-dir\n \n ```\n4. Find the IP address of the Filestore. \n\n ```bash\n (vm)$ gcloud filestore instances describe filestore-instance-name \\\n --location filestore-region\n \n ```\n5. Mount Filestore instance on your Cloud TPU VM onto your mount directory. Replace `filestore-ip`, `file-share-name`, `mount-dir` with your FileStore IP address, file share name, and mount directory. \n\n ```bash\n (vm)$ sudo mount filestore-ip:file-share-name mount-dir\n \n ```\n\n### Mount a Filestore instance on a Cloud TPU slice\n\nCloud TPU slices are composed of 2 or more Cloud TPU VMs. The\nfollowing commands use the `gcloud compute tpus tpu-vm ssh` command with the\n`--worker=all` and `--command` flags to run the commands on all Cloud TPU\nVMs at one time.\n\n1. Install the `nfs-common` package on all Cloud TPU VMs in your slice. \n\n ```bash\n gcloud compute tpus tpu-vm ssh your-tpu-name \\\n --project=your-gcp-project \\\n --zone=your-zone \\\n --worker=all \\\n --command=\"sudo apt-get update --allow-releaseinfo-change && sudo apt-get -y update && sudo apt-get -y install nfs-common\"\n \n ```\n2. Create a directory in which to mount the Filestore instance. Replace `mount-dir` with a directory name of your choice. \n\n ```bash\n gcloud compute tpus tpu-vm ssh your-tpu-name \\\n --project=your-gcp-project \\\n --zone=your-zone \\\n --worker=all \\\n --command=\"sudo mkdir -p \u003cvar translate=\"no\"\u003emount-dir\u003c/var\u003e && sudo chmod ugo+rw \u003cvar translate=\"no\"\u003emount-dir\u003c/var\u003e\"\n \n ```\n3. Find the IP address of the Filestore instance. \n\n ```bash\n gcloud filestore instances describe filestore-instance-name \\\n --location filestore-region\n \n ```\n4. Mount Filestore instance on your Cloud TPU slice. Replace `filestore-ip`, `file-share-name`, `mount-dir` with your FileStore IP address, file share name, and mount directory. \n\n ```bash\n gcloud compute tpus tpu-vm ssh your-tpu-name \\\n --project=your-gcp-project \\\n --zone=your-zone \\\n --worker=all \\\n --command=\"sudo mount \u003cvar translate=\"no\"\u003efilestore-ip\u003c/var\u003e:\u003cvar translate=\"no\"\u003efile-share-name\u003c/var\u003e \u003cvar translate=\"no\"\u003emount-dir\u003c/var\u003e\"\n \n ```\n\nWriting data to Filestore instance\n----------------------------------\n\nMake sure you grant Linux read and write permissions on the directory in which\nyou mount the Filestore instance. You can use the directory as you\nwould your local file system."]]
