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 compatibilidade perfeita com 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 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

Nesta seção, descrevemos 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. Na etapa 2, pesquise e use uma conta de serviço personalizada em vez da conta de serviço padrão do Compute Engine.

  1. Acesse o console do IAM.

  2. Selecione a guia Exibir por principais e digite Name:Compute Engine default service account no campo Filtro.

  3. Clique em Editar 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.

  4. Clique em Adicionar para adicionar outro papel.

  5. Expanda o menu Selecionar um papel, digite Filestore no filtro e selecione Editor do Cloud Filestore.

  6. Clique em Salvar para fechar 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 para ativar uma instância do Filestore em uma VM do Cloud TPU dependem do uso de uma única VM do Cloud TPU ou de uma fração do Cloud TPU.

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

  1. Conecte-se à VM do Cloud TPU usando SSH.

    gcloud compute ssh TPU_NAME \
  --zone=ZONE

    Substitua os seguintes marcadores de posição:

    • TPU_NAME: o nome da VM de TPU.
    • ZONE: a zona da VM de TPU.

  2. Instale o pacote nfs-common.

    sudo apt-get update --allow-releaseinfo-change \
  && sudo apt-get -y update \
  && sudo apt-get -y install nfs-common

  3. Crie um diretório para ativar o NFS.

    sudo mkdir -p MOUNT_DIR \
  && sudo chmod ugo+rw MOUNT_DIR

    Substitua o seguinte marcador de posição:

    • MOUNT_DIR: o diretório em que você quer montar a instância do Filestore.

  4. Encontre o endereço IP do Filestore.

    gcloud filestore instances describe FILESTORE_INSTANCE_NAME \
  --location FILESTORE_REGION

    Substitua os seguintes marcadores de posição:

    • FILESTORE_INSTANCE_NAME: o nome da instância do Filestore.
    • FILESTORE_REGION: a região da sua instância do Filestore.

  5. Ative a instância do Filestore na VM do Cloud TPU no diretório de ativação.

    sudo mount FILESTORE_IP:FILE_SHARE_NAME MOUNT_DIR

    Substitua os seguintes marcadores de posição:

    • FILESTORE_IP: o endereço IP da instância do Filestore.
    • FILE_SHARE_NAME: o nome do compartilhamento de arquivos na sua instância do Filestore.
    • MOUNT_DIR: o diretório em que você quer montar a instância do Filestore.

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

As frações da Cloud TPU são provisionadas como grupos gerenciados de instâncias (MIGs) do Compute Engine. Como os MIGs distribuem VMs pela capacidade de computação, use um script de inicialização anexado ao modelo de instância para montar uma instância do Filestore em todas as máquinas na sua fração. Isso garante que a montagem fique disponível automaticamente sempre que as instâncias forem criadas ou corrigidas automaticamente.

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

    gcloud filestore instances describe FILESTORE_INSTANCE_NAME \
  --location FILESTORE_REGION

    Substitua os seguintes marcadores de posição:

    • FILESTORE_INSTANCE_NAME: o nome da instância do Filestore.
    • FILESTORE_REGION: a região da sua instância do Filestore.

  2. Crie um script de inicialização. O script instala o pacote nfs-common, cria o diretório de montagem e anexa a instância do Filestore. Salve o código a seguir como um arquivo local chamado mount-filestore.sh.

    #!/bin/bash
sudo apt-get update --allow-releaseinfo-change && sudo apt-get -y update && sudo apt-get -y install nfs-common
sudo mkdir -p MOUNT_DIR
sudo chmod ugo+rw MOUNT_DIR
sudo mount FILESTORE_IP:FILE_SHARE_NAME MOUNT_DIR

    Substitua os seguintes marcadores de posição:

    • FILESTORE_IP: o endereço IP da instância do Filestore.
    • FILE_SHARE_NAME: o nome do compartilhamento de arquivos na sua instância do Filestore.
    • MOUNT_DIR: o diretório em que você quer montar a instância do Filestore.

  3. Aplique o script de inicialização ao modelo de instância. Ao criar o modelo de instância para o MIG, use a flag --metadata-from-file para fornecer seu script.

    gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
  --metadata-from-file=startup-script=mount-filestore.sh \
  ...

    Substitua os seguintes marcadores de posição:

    • INSTANCE_TEMPLATE_NAME: o nome do modelo de instância.

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.