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 struktur aplikasi Python 2 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:
Klik Buat di bagian Bucket Cloud Storage Defeult di halaman Setelan App Engine project Anda. Perhatikan nama bucket ini: formatnya
<project-id>.appspot.com
.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
Anda dapat mendownload library klien App Engine untuk Cloud Storage menggunakan alat populer seperti pip
atau Git. Atau, Anda dapat mendownload
library secara manual dari GitHub. Pilih metode yang Anda inginkan:
Git
Jika sudah menginstal Git, Anda dapat meng-clone repositori GitHub untuk library klien Cloud Storage App Engine sebagai berikut:
git clone https://github.com/googleapis/python-storage.git
pip
Anda dapat menggunakan pip
untuk menginstal library klien Cloud Storage sebagai berikut:
pip install google-cloud-storage
Download manual
Anda dapat mendownload file ZIP yang berisi library klien App Engine untuk Cloud Storage dari GitHub:
Instal library ke direktori yang Anda gunakan untuk library pihak ketiga,
seperti lib
. Untuk informasi selengkapnya, lihat Menggunakan library
pihak ketiga.
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:
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
- 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.