Criar uma instância do Filestore usando a CLI gcloud

Criar uma instância do Filestore usando a CLI gcloud

Este guia de início rápido mostra como começar a usar o Filestore rapidamente usando a Google Cloud CLI. Neste tutorial, você aprenderá a realizar as seguintes tarefas:

• Criar uma instância do Filestore.
• Ativar o compartilhamento de arquivos dessa instância em uma VM cliente do Compute Engine.
• Criar um arquivo no compartilhamento de arquivos ativado.
• Excluir a instância do Filestore.

Antes de começar

1. Crie ou selecione um projeto:

   Observação: se você não pretende manter os recursos criados neste guia de início rápido, crie um projeto em vez de selecionar um projeto existente. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Crie um projeto

    gcloud projects create PROJECT_ID
   

   Selecionar um projeto

    gcloud config set project PROJECT_ID
   

   em que PROJECT_ID é o ID do projeto Google Cloud .

2. Verifique se o faturamento foi ativado para o projeto. Saiba como ativar o faturamento.

3. Instale e inicialize a gcloud CLI.

   Se a CLI gcloud já estiver instalada, atualize-a usando o comando gcloud components update:

   gcloud components update
   

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Para mais informações, consulte Limpeza.

Criar uma VM do Compute Engine para ser o cliente

Linux

1. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance nfs-client.
   • Defina a flag --zone como us-central1-c.
   • Defina a flag --image-project como debian-cloud.
   • Defina a flag --image-family como debian-11.
   • Defina a flag --tags como http-server,.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=debian-cloud --image-family=debian-11 --tags=http-server,

Windows

1. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance nfs-client.
   • Defina a flag --zone como us-central1-c.
   • Defina a flag --image-project como windows-cloud.
   • Defina a flag --image-family como windows-2012-r2.
   • Defina a flag --tags como http-server,http-server,.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server,http-server,

Criar uma instância do Filestore

Neste guia de início rápido, mostramos como criar uma instância na camada de serviço regional com o desempenho personalizado ativado. Para detalhes sobre como criar instâncias, consulte Criar uma instância.

1. Criar uma instância do Filestore. Configure a instância desta maneira:

   • Nomeie a instância nfs-server.
   • Defina a sinalização --region como us-central1.
   • Defina a sinalização --tier como REGIONAL.

   • Defina a flag --performance como max-iops-per-tb=17000.

     Observação : depois de ativar o desempenho personalizado para uma instância, não é possível desativá-lo para ela. As instâncias com desempenho personalizado ativado são cobradas de acordo com as IOPS compradas. Para mais detalhes, consulte configurar desempenho personalizado e preços do Filestore.

   • Defina a flag --file-share como name="vol1",capacity=1TB.

   • Defina a sinalização --network como name="default".

     gcloud filestore instances create nfs-server --region=us-central1 --tier=REGIONAL --performance=max-iops-per-tb=17000 --file-share=name="vol1",capacity=1TB --network=name="default"

2. Receba informações sobre a instância do Filestore que você acabou de criar:

     gcloud filestore instances describe nfs-server --region=us-central1 

   O comando retorna algo como:

       createTime: '2025-02-12T09:15:08.163246004Z'
       customPerformanceSupported: true
       fileShares:
        -capacityGb: '1024'
           name: vol1
       name: projects/yourproject/locations/us-central1/instances/nfs-server
       networks:
       -connectMode: DIRECT_PEERING
         ipAddresses:
          - 10.0.0.2
         network: default
         reservedIpRange: 10.0.0.2/26
       performanceConfig:
         iopsPerTb:
           maxIopsPerTb: '17000'
       performanceLimits:
         maxIops: '17000'
         maxReadIops: '17000'
         maxReadThroughputBps: '417792000'
         maxWriteIops: '5100'
         maxWriteThroughputBps: '139264000'
       protocol: NFS_V3
       state: READY
       tier: REGIONAL

Copie o endereço IP da instância que será usada ao ativar o compartilhamento de arquivos. Neste guia de início rápido, usamos o endereço IP 10.0.0.2.

Ativar o compartilhamento de arquivos do Filestore na instância nfs-client

Linux

1. Establish an SSH connection to the nfs-client instância:

   gcloud compute ssh nfs-client

1. Instale o NFS executando os seguintes comandos na janela do terminal de nfs-client:

   sudo apt-get -y update &&
   sudo apt-get -y install nfs-common
   

2. Crie um diretório de montagem na instância nfs-client para o compartilhamento de arquivos do Filestore:

   sudo mkdir /mnt/test
   

3. Ative o compartilhamento de arquivos na instância nfs-client com o comando mount especificando o endereço IP da instância do Filestore, o nome do compartilhamento de arquivos e o diretório de ativação para ativação:

   sudo mount 10.0.0.2:/vol1 /mnt/test
   

   Observação: para recomendações de opções de montagem do NFS, consulte Montagem de compartilhamentos de arquivos.

4. Torne o compartilhamento de arquivos acessível alterando as permissões:

   sudo chmod go+rw /mnt/test
   

Importante: recomendamos configurar permissões mais específicas em um ambiente de produção. Para mais informações, consulte Como configurar o acesso em um compartilhamento de arquivos.

Windows

Faça login na instância nfs-client e abra um prompt de comando como administrador.

1. Crie uma conta e defina uma senha inicial para a instância nfs-client:

   gcloud compute reset-windows-password nfs-client
   

2. Configure a instância para ativar a conexão a portas seriais:

   gcloud compute instances add-metadata nfs-client --metadata=serial-port-enable=1
   

3. Insira uma sessão interativa:

   gcloud compute connect-to-serial-port nfs-client --port=2
   

4. No prompt SAC>, crie um novo canal:

   cmd
   

   Um canal com o nome Cmd0001 é criado.

5. Conecte-se ao canal:

   ch -sn Cmd0001
   

6. Digite o nome de usuário e a senha da instância nfs-client e deixe o campo Domain em branco. Você está conectado à interface Command Prompt da instância nfs-client.

Instalar o cliente NFS

1. Em Command Prompt de nfs-client, alterne para Windows PowerShell:

   powershell
   

2. Instalar o cliente NFS:

   Install-WindowsFeature -Name NFS-Client
   

3. Reinicie a instância nfs-client quando solicitado:

   restart-computer
   

4. No prompt SAC>, aguarde a seguinte notificação aparecer:

   EVENT: The CMD command is now available.

   Em seguida, execute os comandos cmd e ch -sn conforme instruído anteriormente para fazer login e reconectar-se à instância nfs-client.

Configurar o código de usuário utilizado pelo cliente NFS

1. No prompt de comando, execute powershell para alternar para o Windows PowerShell.

2. Em PowerShell, execute os seguintes comandos para criar duas novas entradas de registro, AnonymousUid e AnonymousGid:

   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
       -Name "AnonymousUid" -Value "0" -PropertyType DWORD
   
   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
       -Name "AnonymousGid" -Value "0" -PropertyType DWORD
   

3. Reinicie o serviço do cliente NFS:

   nfsadmin client stop
   
   nfsadmin client start
   

Mapear o compartilhamento de arquivos vol1 para a instância nfs-client

1. Saia de PowerShell:

   exit
   

2. Em Command Prompt, monte o compartilhamento de arquivos na instância nfs-client com o comando mount especificando o endereço IP da instância do Filestore, o nome do compartilhamento de arquivos e a letra da unidade para montar:

   mount -o mtype=hard 10.0.0.2:/vol1 z:
   

Criar um arquivo no compartilhamento de arquivos ativado

Linux

1. Na janela do terminal nfs-client, crie um arquivo chamado testfile executando o seguinte comando:

   echo 'This is a test' > /mnt/test/testfile
   

2. Confirme se o arquivo foi criado executando o seguinte comando e verificando se testfile está no conteúdo do diretório retornado:

   ls /mnt/test
   

Windows

1. Na janela de prompt de comando da instância nfs-client, crie um arquivo chamado testfile:

   echo 'This is a test' > Z:\testfile
   

2. Confirme se o arquivo foi criado executando o seguinte comando:

   dir Z:
   

   e verifique se testfile está no conteúdo do diretório retornado.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, exclua o projeto do Google Cloud e os recursos.

Excluir o projeto do Google Cloud

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto atual para as tarefas neste documento, a exclusão dele vai resultar na exclusão de outros trabalhos feitos nele.
• Os IDs de projeto personalizados são perdidos. É possível que, ao criar o projeto, você tenha criado um ID de projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja explorar várias arquiteturas, tutoriais e guias de início rápido, a reutilização de projetos pode evitar que você exceda limites da cota.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

Excluir a instância do Filestore

Exclua a instância nfs-server:

gcloud filestore instances delete nfs-server --zone=us-central1-c

Excluir a instância do Compute Engine

Exclua a instância:

gcloud compute instances delete nfs-client

A seguir

• Leia a Visão geral do Filestore para saber mais sobre os princípios básicos do Filestore.
• Configure uma instância do Filestore por conta própria seguindo as instruções em Como criar instâncias.
• Leia Controle de acesso para saber como controlar o acesso às operações do Filestore e aos recursos de uma instância.
• Saiba como copiar dados para ou de uma instância do Filestore.
• Saiba como transferir grandes conjuntos de dados do Cloud Storage para o Filestore.