Menyiapkan Google Cloud Storage

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

Menyiapkan project

Buat project Google Cloud, dan pahami pembuatan struktur aplikasi Go 1.11 di App Engine. Tulis 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.

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
  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/...
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 selanjutnya