Monte um bucket do Cloud Storage usando o Cloud Storage FUSE

O Cloud Storage FUSE permite montar um bucket do Cloud Storage como um sistema de arquivos local. Assim, é possível interagir com seus objetos usando a semântica padrão de sistema de arquivos. Neste guia de início rápido, você vai instalar o Cloud Storage FUSE no Debian ou no Ubuntu, montar um bucket como uma pasta na sua máquina e fazer upload de um objeto para o bucket.

Use a Google Cloud CLI para criar e gerenciar o objeto no bucket de armazenamento e a Cloud Storage FUSE para montar o bucket na sua máquina.

Antes de começar

Para configurar um projeto, siga estas etapas:

  1. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho sem custos financeiros.

  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 role (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.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.

  5. Install the Google Cloud CLI.

  6. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  7. To initialize the gcloud CLI, run the following command: 

    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 role (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.

      Go to IAM
    2. Select the project.
    3. Click Grant access.

    4. In the New principals field, enter your user identifier. This is typically the email address for a Google Account.

    5. Click Select a role, then search for the role.
    6. To grant additional roles, click Add another role and add each additional role.
    7. Click Save.

  11. Install the Google Cloud CLI.

  12. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  13. To initialize the gcloud CLI, run the following command: 

    gcloud init
  14. Tenha um bucket do Cloud Storage que você queira montar. Se você ainda não tiver um, crie um novo bucket.

Instale o Cloud Storage FUSE

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

Monte o bucket

Para montar o bucket no sistema de arquivos local, siga estas etapas:

  1. Gere o Application Default Credentials usando o comando gcloud auth application-default login:

    gcloud auth application-default login

    O Cloud Storage FUSE carrega automaticamente as credenciais.

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

    mkdir "$HOME/mount-folder"

  3. Monte o bucket de armazenamento usando o comando gcsfuse:

    gcsfuse BUCKET_NAME "$HOME/mount-folder"

    Substitua BUCKET_NAME pelo nome do bucket que você quer montar.

    Se bem-sucedido, o comando vai retornar uma saída com um texto semelhante ao seguinte:

    File system has been successfully mounted.

faça upload de um objeto no bucket

Para fazer o download de um objeto de exemplo e fazer upload dele para o bucket montado, siga estas etapas:

Imagem de um gatinho para fazer upload no bucket.

  1. Clique com o botão direito do mouse na imagem e salve-a em algum lugar do computador, por exemplo, na área de trabalho.

    Também é possível fazer o download da imagem usando o comando cURL curl -O https://cloud.google.com/storage/images/kitten.png.

  2. Copie a imagem do local salvo para a pasta em que o bucket está montado usando o comando cp:

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

  3. Verifique se a imagem foi copiada para o sistema de arquivos local e se o upload dela para o bucket foi bem-sucedido seguindo as etapas abaixo:

    1. Para verificar se kitten.png foi copiado para o sistema de arquivos local, execute ls na pasta em que o bucket está montado:

      ls "$HOME/mount-folder"

      Se a operação de cópia tiver sido bem-sucedida, kitten.png será retornado na saída.

    2. Para listar o conteúdo do bucket, use o comando gcloud storage ls:

      gcloud storage ls gs://BUCKET_NAME

      Substitua BUCKET_NAME pelo nome do bucket.

      Se o upload da imagem para o bucket foi bem-sucedido, kitten.png será retornado na saída.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, exclua os recursos seguindo estas etapas:

  1. Desconecte o bucket de armazenamento da sua máquina Linux usando a ferramenta fusermount:

    fusermount -u "$HOME/mount-folder"

  2. Para excluir o bucket e tudo que estiver dentro dele, use o comando gcloud storage rm com o sinalizador --recursive:

    gcloud storage rm gs://BUCKET_NAME --recursive

    Substitua BUCKET_NAME pelo nome do bucket.

    Se for bem-sucedido, o comando retornará uma saída semelhante a esta:

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

A seguir