Menemukan penyimpanan objek dengan alat gsutil

Panduan memulai: Menemukan penyimpanan objek dengan alat gsutil

Menemukan penyimpanan objek dengan alat gsutil

Penting: gsutil adalah kumpulan perintah CLI lama yang digunakan untuk berinteraksi dengan Cloud Storage. Pengguna baru harus menggunakan perintah gcloud storage, bukan perintah gsutil.

Halaman ini menunjukkan cara melakukan tugas-tugas dasar di Cloud Storage menggunakan alat command line gsutil yang terinstal sebagai bagian dari 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

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. Menginstal Google Cloud CLI.

3. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

4. Buat project Google Cloud.

   gcloud projects create PROJECT_ID

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

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

6. Menginstal Google Cloud CLI.

7. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

8. Buat project Google Cloud.

   gcloud projects create PROJECT_ID

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

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

10. Jika Anda menggunakan lingkungan pengembangan lokal, instal Python 3.8.

    Jika Anda menggunakan Windows dan membiarkan kotak yang relevan dicentang saat menginstal gcloud CLI, ini dilakukan secara otomatis.

Catatan: Jika Anda menggunakan Cloud Shell atau instance Compute Engine, Python dan gsutil sudah terinstal lebih dulu dan diautentikasi.

Catatan: Jika Anda menggunakan Windows dan tidak menginstal gsutil sebagai bagian dari gcloud CLI, Anda perlu mengawali setiap perintah gsutil dengan python (misalnya, python gsutil mb gs://my-awesome-bucket). Untuk informasi selengkapnya, lihat FAQ Python di Windows.

Membuat bucket

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

Untuk membuat bucket:

1. Buka jendela terminal.

2. Gunakan perintah gsutil mb dan nama unik untuk membuat bucket:

   gsutil mb -b on -l us-east1 gs://my-awesome-bucket/

   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 pisah (-), garis bawah (_), dan titik (.). Spasi tidak diperbolehkan. 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 tidak 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".
   Perhatian: Jangan sertakan 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.

   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 gsutil cp untuk menyalin image dari lokasi tempat Anda menyimpannya ke bucket yang Anda buat:

   gsutil 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 gsutil cp untuk mendownload image yang Anda simpan di bucket ke suatu tempat di komputer, seperti desktop:

   gsutil 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 gsutil cp untuk membuat folder dan menyalin image ke dalamnya:

   gsutil 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 image ke dalam folder baru di bucket Anda.

Mencantumkan konten dari bucket atau folder

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

   gsutil 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 bagian atas bucket.

Mencantumkan detail untuk objek

1. Gunakan perintah gsutil ls dengan flag -l untuk mendapatkan beberapa detail tentang image:

   gsutil ls -l gs://my-awesome-bucket/kitten.png

   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 gsutil iam ch untuk memberikan izin kepada semua pengguna untuk membaca image yang disimpan di bucket Anda:

   gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket

   Perintah berhasil jika tidak ada error yang ditampilkan.

   Sekarang, siapa saja bisa mendapatkan image Anda.

2. Untuk menghapus akses ini, gunakan perintah:

   gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket

   Perintah berhasil jika tidak ada error yang ditampilkan.

   Anda telah menghapus akses publik ke image di bucket Anda.

Catatan: Setelah menghapus akses publik, Anda mungkin masih dapat mengakses versi cache dari salah satu image Anda selama periode waktu tertentu.

Memberi seseorang akses ke bucket Anda

1. Gunakan perintah gsutil iam ch untuk memberikan izin ke alamat email tertentu untuk membaca dan menulis objek di bucket Anda:

   gsutil iam ch user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   Perintah berhasil jika tidak ada error yang ditampilkan.

   Sekarang, orang lain dapat memasukkan barang ke dalam dan melihat apa yang ada di bucket Anda.

2. Untuk menghapus izin ini, gunakan perintah:

   gsutil iam ch -d user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   Perintah berhasil jika tidak ada error yang ditampilkan.

   Anda telah menghapus akses pengguna ke bucket ini.

Menghapus objek

1. Gunakan perintah gsutil rm untuk menghapus salah satu image Anda:

   gsutil rm gs://my-awesome-bucket/kitten.png

   Jika berhasil, perintah menampilkan:

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

   Salinan image 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, hapus project Google Cloud dengan resource tersebut.

1. Buka jendela terminal (jika belum terbuka).

2. Gunakan perintah gsutil rm dengan flag -r untuk menghapus bucket dan apa pun di dalamnya:

   gsutil rm -r gs://my-awesome-bucket

   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 dan isinya akan dihapus.

Langkah berikutnya

• Bekerja melalui Panduan Memulai Cloud Storage menggunakan Konsol Google Cloud.
• Baca Ringkasan produk Cloud Storage.
• Pelajari harga Cloud Storage.
• Lihat halaman referensi untuk perintah gsutil, seperti make bucket (mb), copy (cp), list (ls), identity access management (iam), dan remove (rm).