Menemukan penyimpanan objek dengan Google Cloud CLI

Menemukan penyimpanan objek dengan Google Cloud CLI

Halaman ini menunjukkan cara melakukan tugas-tugas dasar di Cloud Storage menggunakan Google Cloud CLI.

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

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.
Instal Google Cloud CLI.
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
gcloud init
Buat atau pilih Google Cloud project.
Peran yang diperlukan untuk memilih atau membuat project
• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.
Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.
• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.
Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.
Memberikan peran ke akun pengguna Anda. Jalankan perintah berikut satu kali untuk setiap peran IAM berikut: roles/storage.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Ganti kode berikut:
• PROJECT_ID: Project ID Anda.
• USER_IDENTIFIER: ID untuk akun pengguna Anda. Misalnya, [e-mail].
• ROLE: Peran IAM yang Anda berikan ke akun pengguna Anda.

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Memberikan peran ke akun pengguna Anda. Jalankan perintah berikut satu kali untuk setiap peran IAM berikut: roles/storage.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• USER_IDENTIFIER: ID untuk akun pengguna Anda. Misalnya, [e-mail].
• ROLE: Peran IAM yang Anda berikan ke akun pengguna Anda.

Catatan: Jika Anda menggunakan instance Cloud Shell atau Compute Engine, Google Cloud SDK sudah diinstal lebih dulu dan diautentikasi. Jika instance Compute Engine Anda disiapkan tanpa cakupan akun layanan ke Cloud Storage, jalankan gcloud init dan ikuti petunjuknya.

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 secara global untuk membuat bucket:

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

   Ganti BUCKET_NAME dengan nama untuk bucket Anda.

   Perhatian: Jangan sertakan informasi sensitif di nama bucket, karena namespace bucket bersifat global dan dapat dilihat publik.
   Lihat persyaratan penamaan bucket.

   • Nama bucket hanya boleh berisi huruf kecil, karakter numerik, tanda hubung (-), garis bawah (_), dan titik (.). Tidak diperbolehkan ada spasi. Nama yang mengandung titik memerlukan verifikasi.
   • Nama bucket harus diawali dan diakhiri dengan angka atau huruf.
   • Nama bucket harus berisi 3-63 karakter. Nama yang mengandung titik dapat berisi hingga 222 karakter, tetapi masing-masing komponen yang dipisahkan titik dapat berisi lebih dari 63 karakter.
   • Nama bucket tidak dapat direpresentasikan sebagai alamat IP dalam notasi desimal bertitik (misalnya, 192.168.5.4).
   • Nama bucket tidak boleh dimulai dengan awalan "goog".
   • Nama bucket tidak boleh berisi "google" atau salah ejaan yang mirip, seperti "g00gle".

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

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

   Jika nama bucket yang Anda pilih sudah digunakan, baik oleh Anda atau orang lain, perintah akan menampilkan respons seperti ServiceException: 409 Bucket my-awesome-bucket already exists. Coba lagi dengan nama bucket yang berbeda.

Anda berhasil membuat bucket tempat Anda bisa menyimpan data!

Mengupload objek ke dalam bucket Anda

1. Simpan gambar berikut ke komputer Anda, misalnya di desktop.

   

   Catatan: Jika Anda menggunakan instance Cloud Shell atau Compute Engine, download image menggunakan perintah berikut: wget https://docs.cloud.google.com/storage/images/kitten.png

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

   gcloud storage cp Desktop/kitten.png gs://BUCKET_NAME

   Tips: Saat mengetik nama bucket, Anda bisa menggunakan tombol tab untuk melengkapinya secara otomatis.

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

   Copying file://Desktop/kitten.png to gs://my-awesome-bucket/kitten.png
     Completed files 1/1 | 8.6kiB/8.6kiB

   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://BUCKET_NAME/kitten.png Desktop/kitten2.png

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

   Copying gs://my-awesome-bucket/kitten.png to file://Desktop/kitten2.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

   Anda baru saja mendownload sesuatu dari bucket Anda.

Menyalin objek ke folder simulasi di dalam bucket

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

   gcloud storage cp gs://BUCKET_NAME/kitten.png gs://BUCKET_NAME/quickstart-folder/kitten3.png

   Catatan: Folder simulasi di Cloud Storage memiliki batasan dibandingkan dengan sistem file lokal atau folder di bucket yang mengaktifkan namespace hierarkis, tetapi banyak operasi yang sama didukung.

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

   Copying gs://my-awesome-bucket/kitten.png to gs://my-awesome-bucket/quickstart-folder/kitten3.png
     Completed files 1/1 | 8.6kiB/8.6kiB 

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

Mencantumkan isi bucket

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

   gcloud storage ls gs://BUCKET_NAME

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/quickstart-folder/

   Anda baru saja melihat konten di level atas bucket Anda.

Menampilkan 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://BUCKET_NAME/kitten.png --long

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

   8775  2026-01-21T01:22:17Z  gs://srs-bucketcli/kitten.png
   TOTAL: 1 objects, 8775 bytes (8.57kiB)

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

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://BUCKET_NAME --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 image Anda.

2. Untuk menghapus akses ini, gunakan perintah berikut:

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

   Perintah berhasil jika tidak ada error yang ditampilkan.

   Anda telah menghapus akses publik ke gambar di bucket Anda.

Catatan: Setelah menghapus akses publik, Anda mungkin masih dapat mengakses versi gambar Anda yang di-cache selama jangka waktu tertentu.

Memberi seseorang akses ke bucket Anda

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

   gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME --member=user:[e-mail] --role=roles/storage.objectCreator

   Perintah tersebut berhasil jika respons Anda berisi berikut ini:

   bindings:
     - members:
       - user:[e-mail]
       role: roles/storage.objectCreator
   

   Sekarang, pengguna ini dapat menambahkan item ke bucket Anda.

2. Untuk menghapus izin ini, gunakan perintah berikut:

   gcloud storage buckets remove-iam-policy-binding gs://BUCKET_NAME --member=user:[e-mail] --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 image Anda:

   gcloud storage rm gs://BUCKET_NAME/kitten.png

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

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

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

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

1. Gunakan perintah gcloud storage rm dengan flag --recursive untuk menghapus bucket dan apa pun yang ada di dalamnya:

   gcloud storage rm gs://BUCKET_NAME --recursive

   Jika berhasil, perintah akan menampilkan respons seperti berikut:

   Removing objects:
   Removing gs://my-awesome-bucket/quickstart-folder/kitten3.png#1768960201129254
     Completed 1/1
   Removing buckets:
   Removing gs://my-awesome-bucket/...
     Completed 1/1

   Bucket Anda beserta isinya dihapus.

Langkah berikutnya

• Selesaikan Panduan Memulai Cloud Storage menggunakan Google Cloud konsol.
• Baca Ringkasan produk Cloud Storage.
• Pelajari harga Cloud Storage.
• Lihat halaman referensi untuk perintah gcloud CLI. Contoh:
  • Membuat bucket (buckets create)
  • Mengupload, mendownload, dan menyalin objek (cp)
  • Mencantumkan bucket dan objek (ls)
  • Menambahkan akses ke bucket (buckets add-iam-policy-binding)
  • Menghapus objek dan bucket (rm)