Menemukan penyimpanan objek dengan alat gcloud

Menemukan penyimpanan objek dengan alat gcloud

Halaman ini menunjukkan cara melakukan tugas-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. 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. Install the Google Cloud CLI.

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

   gcloud init

6. 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

7. Make sure that billing is enabled for your Google Cloud project.

8. Install the Google Cloud CLI.

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

   gcloud init

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 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 sendiri nama bucket yang unik secara global.

   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 kesalahan ejaan yang menyerupainya, seperti "g00gle".
   Perhatian: Jangan menyertakan informasi sensitif di nama bucket, karena namespace bucket bersifat global dan dapat dilihat publik.

   Jika berhasil, perintah menampilkan:

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

Anda berhasil membuat bucket tempat Anda bisa menyimpan data!

Catatan: Jika nama bucket yang Anda pilih sudah digunakan, baik oleh Anda atau orang lain, perintah akan menampilkan:

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

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

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

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.

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

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

   Catatan: Folder di Cloud Storage memiliki batasan dibandingkan dengan sistem file lokal, tetapi banyak operasi yang sama didukung.

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

Catatan: Setelah menghapus akses publik, Anda mungkin masih dapat mengakses versi salah satu gambar Anda yang di-cache selama periode 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://my-awesome-bucket --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, 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:[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://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

• Selesaikan Panduan Memulai Cloud Storage menggunakan Konsol Google Cloud.
• Baca Ringkasan produk Cloud Storage.

• Pelajari harga Cloud Storage.

• Lihat halaman referensi untuk perintah Google Cloud CLI, seperti membuat bucket (buckets create), menyalin (cp), membuat daftar (ls), menambahkan akses (buckets add-iam-policy-binding), dan menghapus (rm).