Memasang bucket Cloud Storage menggunakan Cloud Storage FUSE

Pelajari cara memasang bucket Cloud Storage sebagai sistem file lokal menggunakan Cloud Storage FUSE, sehingga Anda dapat berinteraksi dengan objek menggunakan semantik sistem file standar.

Dalam panduan memulai ini, Anda akan menyelesaikan tugas berikut:

  • Menginstal Cloud Storage FUSE di Debian atau Ubuntu

  • Memasang bucket sebagai folder di mesin

  • Mengupload objek ke bucket

Anda harus menggunakan Google Cloud CLI untuk membuat dan mengelola objek di bucket penyimpanan, dan menggunakan gcsfuse CLI untuk memasang bucket ke mesin Anda.

Sebelum Anda memulai

Untuk menyiapkan project, selesaikan langkah-langkah berikut:

  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.

    Go to project selector

  3. Make sure 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.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.

    4. Di kolom Akun utama baru, masukkan ID pengguna Anda. Biasanya berupa alamat email untuk Akun Google.

    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.

  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.

    Go to project selector

  9. Make sure 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.

      Buka IAM
    2. Pilih project.
    3. Klik Berikan akses.

    4. Di kolom Akun utama baru, masukkan ID pengguna Anda. Biasanya berupa alamat email untuk Akun Google.

    5. Di daftar Pilih peran, pilih peran.
    6. Untuk memberikan peran tambahan, klik Tambahkan peran lain, lalu tambahkan setiap peran tambahan.
    7. Klik Simpan.

  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. Memiliki bucket Cloud Storage yang ingin Anda pasang. Jika Anda belum memilikinya, buat bucket baru.

    15. Menginstal Cloud Storage FUSE

    Untuk menginstal Cloud Storage FUSE, selesaikan petunjuk berikut menggunakan shell lokal Anda di Debian atau Ubuntu:

    1. Tambahkan URL distribusi Cloud Storage FUSE sebagai sumber paket:

      export GCSFUSE_REPO=gcsfuse-`lsb_release -c -s`
       
      echo "deb https://packages.cloud.google.com/apt $GCSFUSE_REPO main" | sudo tee /etc/apt/sources.list.d/gcsfuse.list

    2. Impor kunci publik repositori APT Google Cloud :

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    3. Perbarui daftar paket yang tersedia:

      sudo apt-get update

    4. Instal Cloud Storage FUSE dan FUSE dependensinya:

      sudo apt-get install fuse gcsfuse

    5. Saat diminta, tekan Enter untuk mengonfirmasi.

    6. Pastikan Cloud Storage FUSE telah diinstal:

      gcsfuse -v

      Jika berhasil, perintah akan menampilkan output yang mirip dengan berikut ini:

      gcsfuse version 0.41.12 (Go version go1.18.4)

    Memasang bucket

    Untuk memasang bucket ke sistem file lokal, selesaikan langkah-langkah berikut:

    1. Buat Kredensial Default Aplikasi menggunakan perintah gcloud auth application-default login:

      gcloud auth application-default login

      Cloud Storage FUSE memuat kredensial secara otomatis.

    2. Buat direktori untuk memasang bucket penyimpanan ke:

      mkdir "$HOME/mount-folder"

    3. Pasang bucket penyimpanan Anda menggunakan perintah gcsfuse:

      gcsfuse BUCKET_NAME "$HOME/mount-folder"

      Ganti BUCKET_NAME dengan nama bucket yang ingin Anda pasang.

      Jika berhasil, perintah akan menampilkan output yang berisi teks yang mirip dengan berikut ini:

      File system has been successfully mounted.

    Mengupload objek ke dalam bucket

    Untuk mendownload objek contoh dan menguploadnya ke bucket yang terpasang, selesaikan langkah-langkah berikut:

    Gambar anak kucing yang akan diupload ke bucket.

    1. Klik kanan gambar dan simpan di mana saja di komputer Anda, misalnya di desktop.

      Anda juga dapat mendownload gambar menggunakan perintah cURL curl -O https://cloud.google.com/storage/images/kitten.png.

    2. Salin gambar dari lokasi tersimpannya ke folder tempat bucket Anda dipasang, menggunakan perintah cp:

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

    3. Pastikan gambar telah disalin ke sistem file lokal dan berhasil diupload ke bucket dengan mengikuti langkah-langkah berikut:

      1. Untuk memeriksa apakah kitten.png telah disalin ke sistem file lokal, jalankan ls di folder tempat bucket Anda dipasang:

        ls "$HOME/mount-folder"

        Jika operasi penyalinan berhasil, kitten.png akan ditampilkan dalam output.

      2. Untuk menampilkan daftar isi bucket, gunakan perintah gcloud storage ls:

        gcloud storage ls gs://BUCKET_NAME

        Ganti BUCKET_NAME dengan nama bucket Anda.

        Jika gambar berhasil diupload ke bucket Anda, kitten.png akan ditampilkan dalam output.

    Pembersihan

    Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan di halaman ini, hapus resource dengan menyelesaikan langkah-langkah berikut:

    1. Lepaskan bucket penyimpanan dari mesin Linux menggunakan alat fusermount:

      fusermount -u "$HOME/mount-folder"

    2. Untuk menghapus bucket dan semua yang ada di dalamnya, gunakan perintah gcloud storage rm dengan flag --recursive:

      gcloud storage rm gs://BUCKET_NAME --recursive

      Ganti BUCKET_NAME dengan nama bucket Anda.

      Jika berhasil, perintah akan menampilkan output yang mirip dengan berikut ini:

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

    Langkah berikutnya