Panduan memulai: Menemukan penyimpanan objek dengan alat gcloud

Menemukan penyimpanan objek dengan alat gcloud

Halaman ini menunjukkan cara melakukan tugas dasar di Cloud Storage menggunakan alat command line gcloud.

Biaya yang dikenakan di Cloud Storage didasarkan pada resource yang Anda gunakan. Panduan memulai ini biasanya menggunakan resource Cloud Storage senilai kurang dari $0,01 USD.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. Di konsol Google Cloud, pada halaman pemilih project, klik Buat project untuk mulai membuat project Google Cloud baru.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Menginstal Google Cloud CLI.
  5. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init
  6. Di konsol Google Cloud, pada halaman pemilih project, klik Buat project untuk mulai membuat project Google Cloud baru.

    Buka pemilih project

  7. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  8. Menginstal Google Cloud CLI.
  9. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init

Membuat bucket

Bucket adalah container dasar yang menyimpan data Anda di Cloud Storage.

Untuk membuat bucket:

  1. Buka jendela terminal.
  2. Gunakan perintah gcloud storage buckets create dan nama yang unik untuk membuat bucket:

    gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access

    Kode ini menggunakan bucket bernama "my-awesome-bucket". Anda harus memilih nama bucket Anda sendiri yang unik secara global.

    Jika berhasil, perintah menampilkan:

    Creating gs://my-awesome-bucket/...

Anda berhasil membuat bucket tempat Anda bisa menyimpan data!

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Coba lagi dengan nama bucket yang berbeda.

Mengupload objek ke dalam bucket

Gambar anak kucing yang akan diupload ke bucket.

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

  2. Gunakan perintah gcloud storage cp untuk menyalin gambar dari lokasi tempat Anda menyimpannya ke bucket yang Anda buat:

    gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

    Jika berhasil, perintah menampilkan:

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    Anda berhasil menyimpan objek di dalam bucket.

Mendownload objek dari bucket Anda

  1. Gunakan perintah gcloud storage cp untuk mendownload gambar yang Anda simpan di bucket ke suatu tempat di komputer, seperti desktop:

    gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    Jika berhasil, perintah menampilkan:

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    Anda baru saja mendownload sesuatu dari bucket Anda.

Menyalin objek ke folder di dalam bucket

  1. Gunakan perintah gcloud storage cp untuk membuat folder dan menyalin gambar ke dalamnya:

    gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    Jika berhasil, perintah menampilkan:

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    Anda baru saja menyalin gambar ke dalam folder baru di bucket Anda.

Mencantumkan konten dari bucket atau folder

  1. Gunakan perintah gcloud storage ls untuk menampilkan daftar konten di level teratas bucket Anda:

    gcloud storage ls gs://my-awesome-bucket

    Jika berhasil, perintah menampilkan pesan yang mirip dengan:

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    Anda baru saja melihat konten di level atas bucket Anda.

Mencantumkan detail untuk objek

  1. Gunakan perintah gcloud storage ls, dengan flag --long untuk mendapatkan beberapa detail tentang salah satu gambar Anda:

    gcloud storage ls gs://my-awesome-bucket/kitten.png --long

    Jika berhasil, perintah menampilkan pesan yang mirip dengan:

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    Anda baru saja memperoleh informasi tentang ukuran dan tanggal pembuatan gambar.

Membuat objek dapat diakses secara publik

  1. Gunakan perintah gcloud storage buckets add-iam-policy-binding untuk memberikan izin kepada semua pengguna untuk membaca gambar yang disimpan di bucket Anda:

    gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

    Perintah tersebut berhasil jika respons Anda berisi berikut ini:

    bindings:
      - members:
        - allUsers
        role: roles/storage.objectViewer
    

    Sekarang siapa saja bisa mendapatkan gambar Anda.

  2. Untuk menghapus akses ini, gunakan perintah:

    gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

    Perintah berhasil jika tidak ada error yang ditampilkan.

    Anda telah menghapus akses publik ke gambar di bucket Anda.

Memberi seseorang akses ke bucket Anda

  1. Gunakan perintah gcloud storage buckets add-iam-policy-binding untuk memberikan izin alamat email tertentu guna menambahkan objek ke bucket Anda:

    gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:jane@gmail.com --role=roles/storage.objectCreator

    Perintah tersebut berhasil jika respons Anda berisi berikut ini:

    bindings:
      - members:
        - user:jane@gmail.com
        role: roles/storage.objectCreator
    

    Sekarang orang lain dapat menambahkan item ke bucket Anda.

  2. Untuk menghapus izin ini, gunakan perintah:

    gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:jane@gmail.com --role=roles/storage.objectCreator

    Perintah berhasil jika tidak ada error yang ditampilkan.

    Anda telah menghapus akses pengguna ke bucket ini.

Menghapus objek

  1. Gunakan perintah gcloud storage rm untuk menghapus salah satu gambar Anda:

    gcloud storage rm gs://my-awesome-bucket/kitten.png

    Jika berhasil, perintah menampilkan:

    Removing gs://my-awesome-bucket/kitten.png...

    Salinan gambar ini tidak lagi disimpan di Cloud Storage (meskipun salinan yang Anda buat di folder just-a-folder/ masih ada).

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut ini.

  1. Buka jendela terminal (jika belum terbuka).
  2. Gunakan perintah gcloud storage rm dengan flag --recursive untuk menghapus bucket dan apa pun yang ada di dalamnya:

    gcloud storage rm gs://my-awesome-bucket --recursive

    Jika berhasil, perintah menampilkan pesan yang mirip dengan:

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    Bucket Anda beserta isinya dihapus.

Langkah berikutnya