Monte um contentor do Cloud Storage através do Cloud Storage FUSE

Saiba como montar um contentor do Cloud Storage como um sistema de ficheiros local através do Cloud Storage FUSE, para poder interagir com os seus objetos através da semântica do sistema de ficheiros padrão.

Neste guia de início rápido, vai concluir as seguintes tarefas:

  • Instale o Cloud Storage FUSE no Debian ou Ubuntu

  • Montar o contentor como uma pasta na máquina

  • Carregue um objeto para o contentor

Vai usar a CLI do Google Cloud para criar e gerir o objeto no seu contentor de armazenamento, e vai usar a CLI do Cloud Storage FUSE para montar o seu contentor na sua máquina.

Antes de começar

Para configurar um projeto, conclua os seguintes passos:

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.

    Roles required to create a project

    To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Make sure that you have the following role or roles on the project: Storage Admin (roles/storage.admin), Storage Bucket Viewer (roles/storage.bucketViewer)

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Aceder ao IAM
    2. Selecione o projeto.
    3. Clique em Conceder acesso.

    4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

    5. Na lista Selecionar uma função, selecione uma função.
    6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
    7. Clique em Guardar.

  5. Install the Google Cloud CLI.

  6. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  7. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  8. In the Google Cloud console, on the project selector page, click Create project to begin creating a new Google Cloud project.

    Roles required to create a project

    To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

  10. Make sure that you have the following role or roles on the project: Storage Admin (roles/storage.admin), Storage Bucket Viewer (roles/storage.bucketViewer)

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Aceder ao IAM
    2. Selecione o projeto.
    3. Clique em Conceder acesso.

    4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

    5. Na lista Selecionar uma função, selecione uma função.
    6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
    7. Clique em Guardar.

  11. Install the Google Cloud CLI.

  12. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

  13. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init
  14. Ter um contentor do Cloud Storage que quer montar. Se ainda não tiver um, crie um novo contentor.

    15. Instale o FUSE do Cloud Storage

    Para instalar o Cloud Storage FUSE, siga as instruções em Instale o Cloud Storage FUSE.

    Monte o balde

    Para montar o contentor no seu sistema de ficheiros local, conclua os seguintes passos:

    1. Gere Credenciais padrão da aplicação com o comando gcloud auth application-default login:

      gcloud auth application-default login

      O FUSE do Cloud Storage carrega automaticamente as credenciais.

    2. Crie um diretório para montar o contentor de armazenamento:

      mkdir "$HOME/mount-folder"

    3. Monte o contentor de armazenamento com o comando gcsfuse:

      gcsfuse BUCKET_NAME "$HOME/mount-folder"

      Substitua BUCKET_NAME pelo nome do contentor que quer montar.

      Se for bem-sucedido, o comando devolve uma saída que contém texto semelhante ao seguinte:

      File system has been successfully mounted.

    Carregue um objeto para o contentor

    Para transferir um objeto de exemplo e carregá-lo para o contentor montado, conclua os passos seguintes:

    A imagem de um gatinho a carregar para o contentor.

    1. Clique com o botão direito do rato na imagem e guarde-a num local do computador, como o ambiente de trabalho.

      Também pode transferir a imagem através do comando cURL curl -O https://cloud.google.com/storage/images/kitten.png.

    2. Copie a imagem da respetiva localização guardada para a pasta onde o seu contentor está montado, através do comando cp:

      cp kitten.png "$HOME/mount-folder/kitten.png"

    3. Siga estes passos para verificar se a imagem foi copiada para o sistema de ficheiros local e carregada com êxito para o contentor:

      1. Para verificar se kitten.png foi copiado para o seu sistema de ficheiros local, execute ls na pasta onde o seu contentor está montado:

        ls "$HOME/mount-folder"

        Se a operação de cópia for bem-sucedida, é devolvido kitten.png na saída.

      2. Para apresentar o conteúdo do seu contentor, use o comando:gcloud storage ls

        gcloud storage ls gs://BUCKET_NAME

        Substitua BUCKET_NAME pelo nome do seu contentor.

        Se a imagem tiver sido carregada com êxito para o seu contentor, é devolvido kitten.png na saída.

    Limpar

    Para evitar incorrer em encargos na sua Google Cloud conta pelos recursos usados nesta página, elimine os recursos seguindo os passos abaixo:

    1. Desmonte o contentor de armazenamento da sua máquina Linux através da ferramenta fusermount:

      fusermount -u "$HOME/mount-folder"

    2. Para eliminar o contentor e tudo o que está no respetivo interior, use o comando gcloud storage rm com a flag --recursive:

      gcloud storage rm gs://BUCKET_NAME --recursive

      Substitua BUCKET_NAME pelo nome do seu contentor.

      Se for bem-sucedido, o comando devolve uma saída semelhante à seguinte:

      Removing gs://my-bucket/kitten.png#1676488739323620...
 Removing gs://my-bucket/...

    O que se segue?