Menyiapkan Google Cloud Storage

Anda dapat menggunakan bucket Cloud Storage untuk menyimpan dan menyajikan file, seperti film, gambar, atau konten statis lainnya. Dokumen ini menjelaskan cara menyiapkan lingkungan Anda untuk menggunakan library klien App Engine untuk Cloud Storage.

API ini didukung untuk runtime generasi pertama dan dapat digunakan saat mengupgrade ke runtime generasi kedua yang sesuai. Jika Anda mengupdate ke runtime App Engine Go 1.12+, lihat panduan migrasi guna mempelajari opsi migrasi Anda untuk layanan paket lama.

Menyiapkan project

Buat project Google Cloud, dan pahami struktur aplikasi Go 1.11 di App Engine. Tuliskan dan simpan project ID Anda untuk digunakan dengan aplikasi.

Mengaktifkan bucket Cloud Storage

Untuk menggunakan Cloud Storage, Anda harus mengaktifkan setidaknya satu bucket. Anda dapat menggunakan bucket default yang menyediakan penyimpanan 5 GB pertama secara gratis. Anda dapat mengaktifkan dan menggunakan bucket Cloud Storage lain. Bucket default menyertakan penyimpanan pertama sebesar 5 GB secara gratis. Bucket default juga menyertakan kuota gratis untuk operasi I/O Cloud Storage. Baca artikel Harga, kuota, dan batas untuk mengetahui detail selengkapnya.

Untuk mengaktifkan bucket Cloud Storage default untuk aplikasi Anda:

1. Klik Buat di bagian Bucket Cloud Storage Defeult di halaman Setelan App Engine project Anda. Perhatikan nama bucket ini: formatnya <project-id>.appspot.com.

2. Jika memerlukan penyimpanan lebih besar dari batas 5 GB, Anda dapat meningkatkannya dengan mengaktifkan penagihan untuk project Anda agar menjadi bucket berbayar. Anda akan ditagih untuk penyimpanan yang melebihi batas 5 GB.

Jika Anda ingin mengaktifkan satu atau beberapa bucket berbayar, ikuti petunjuk di bagian Membuat bucket untuk mengaktifkannya.

Catatan: Saat membuat bucket default, Anda juga mendapatkan bucket staging dengan nama yang sama, kecuali staging. ditambahkan di depannya. Anda dapat menggunakan bucket staging ini untuk file sementara yang digunakan untuk tujuan staging dan pengujian; terdapat juga batas penyimpanan sebesar 5 GB, tetapi penyimpanan ini otomatis dikosongkan setiap minggu.

Menetapkan izin bucket dan objek

Anda dapat menemukan informasi tentang cara mengizinkan akun layanan aplikasi atau pengguna lain untuk mengakses bucket penyimpanan beserta isinya di Menetapkan izin bucket dan Menetapkan izin objek ini.

Mendownload library klien

Library klien App Engine untuk Cloud Storage tersedia melalui alat go. Untuk mendownload library:

1. Setel GOPATH jika perlu. Jika menggunakan Linux dan macOS, Anda dapat menyetel GOPATH sebagai berikut:

   mkdir -p $HOME/go
   export GOPATH=$HOME/go

   Catatan: Untuk petunjuk Windows, lihat bagian Windows pada Memulai Bahasa Pemrograman Go.

2. Download paket oauth2, storage, dan appengine:

   go get -u golang.org/x/oauth2
   go get -u cloud.google.com/go/storage
   go get -u google.golang.org/appengine/...

   Catatan: Paket-paket ini akan didownload ke direktori src GOPATH Anda.

Untuk mengetahui detail tentang cara menginstal library klien, lihat halaman Library Klien Cloud Storage.

Menggunakan library klien dengan server aplikasi pengembangan

Anda dapat menggunakan library klien dengan server pengembangan. Namun, karena tidak ada emulasi lokal Cloud Storage, semua permintaan untuk membaca dan menulis file harus dikirim melalui Internet ke bucket Cloud Storage yang sebenarnya.

Untuk menggunakan library klien dengan server aplikasi pengembangan:

1. Aktifkan bucket Cloud Storage.

2. Jalankan dev_appserver.py dengan flag --default_gcs_bucket_name [BUCKET_NAME], yang mengganti [BUCKET_NAME] dengan nama bucket Cloud Storage yang Anda gunakan.

   Flag ini mengontrol bucket yang akan ditampilkan saat aplikasi Anda memanggil file.DefaultBucketName(ctx).

Harga, kuota, dan batas

Tidak ada biaya bandwidth yang terkait dengan panggilan ke Cloud Storage dari library klien App Engine. Namun, ada biaya operasi. Selain itu, panggilan juga mengurangi kuota URL-fetch karena library menggunakan layanan URL-fetch untuk berinteraksi dengan Cloud Storage.

Perhatikan bahwa Cloud Storage adalah layanan bayar sesuai penggunaan; Anda akan dikenai biaya sesuai dengan lembar harga Cloud Storage.

Cara alternatif untuk mengakses Cloud Storage

Daripada menggunakan library klien, Anda dapat menggunakan hal berikut:

• Browser Cloud Storage di konsol Google Cloud, yang berguna untuk mengupload objek dengan cepat.
• gsutil, yang merupakan alat command line untuk bekerja dengan file di Cloud Storage.

Langkah berikutnya

• Baca dokumentasi Referensi API.
• Pelajari cara membaca dan menulis ke Cloud Storage dengan library klien App Engine untuk Cloud Storage.
• Tinjau contoh App Engine dan Google Cloud Storage.
• Lihat kumpulan lengkap dokumentasi Cloud Storage, termasuk contoh dan tutorial tambahan.