Guia de início rápido sobre como usar a ferramenta gcloud

Este guia de início rápido mostra como começar a usar o Filestore rapidamente usando a ferramenta de linha de comando gcloud. Neste guia de início rápido, você aprenderá a:

  • 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. Selecione ou crie um projeto do GCP:

    Crie um projeto

     gcloud projects create project-id
    

    Selecione um projeto

     gcloud config set project-id
    

    em que project-id é o ID do projeto do Google Cloud.

  2. Verifique se o faturamento foi ativado no projeto do Google Cloud Platform. Saiba como ativar o faturamento.

  3. Instale e inicie o SDK do Cloud.

    Se já tiver feito a instalação, execute o comando a seguir para atualizar o SDK do Cloud:

    gcloud components update
    

Ao concluir este tutorial, exclua os recursos criados para evitar o faturamento contínuo. Para mais informações, consulte Como fazer a limpeza.

Criar uma VM do Compute Engine para ser o cliente

Linux

  1. Crie uma instância do Compute Engine. Configure a instância da seguinte maneira:
    • Nome da instância nfs-client.
    • Defina a sinalização --zone como us-central1-c.
    • Defina a sinalização --image-project como debian-cloud.
    • Defina a sinalização --image-family como debian-10.
    • Defina a sinalização --tags como http-server,.
    gcloud compute instances create nfs-client --zone us-central1-c --image-project debian-cloud --image-family debian-10 --tags http-server,

Windows

  1. Crie uma instância do Compute Engine. Configure a instância da seguinte maneira:
    • Nome da instância nfs-client.
    • Defina a sinalização --zone como us-central1-c.
    • Defina a sinalização --image-project como windows-cloud.
    • Defina a sinalização --image-family como windows-2012-r2.
    • Defina a sinalização --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 Firestore

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

    • Nomeie a instância nfs-server.
    • Defina a sinalização --zone como us-central1-c.
    • Defina a sinalização --tier como BASIC_HDD.
    • Defina a sinalização --file-share como name="vol1",capacity=1TB.
    • Defina a sinalização --network como name="default".
    gcloud beta filestore instances create nfs-server --zone=us-central1-c --tier=BASIC_HDD --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 --zone=us-central1-c
    

    O resultado será semelhante ao seguinte:

    createTime: '2019-10-11T17:28:23.340943077Z'
    fileShares:
    - capacityGb: '1024'
     name: vol1
    name: projects/yourproject/locations/us-central1-c/instances/nfs-server
    networks:
    - ipAddresses:
     - 10.0.0.2
     network: default
     reservedIpRange: 10.0.0.0/29
    state: READY
    tier: BASIC_HDD
    

    Copie o endereço IP da instância que será usada ao montar 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. Estabeleça uma conexão SSH com a instância nfs-client :
    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 montagem para montar:

    sudo mount 10.0.0.2:/vol1 /mnt/test
    
  4. Torne o compartilhamento de arquivos acessível alterando as permissões:

    sudo chmod go+rw /mnt/test
    

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. Isso conecta você à 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, mapeie o compartilhamento de arquivos vol1 para o drive Z: de nfs-server:

    net use z: \\10.0.0.2\vol1
    

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 sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

Como excluir o projeto do Google Cloud

  1. No Console do Cloud, acesse a página Gerenciar recursos:

    Acessar a página "Gerenciar recursos"

  2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
  3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Como excluir a instância do Filestore

Exclua a instância nfs-server:

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

Como 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, bem como os recursos em uma instância.