Dokumen ini menjelaskan cara menggunakan Library Klien Cloud untuk Cloud Storage di aplikasi Anda untuk menyimpan data dan mengambil data
Sebelum memulai
- Ikuti petunjuk di bagian Menyiapkan lingkungan pengembangan Anda untuk menyiapkan lingkungan dan project Anda, serta untuk memahami struktur aplikasi di App Engine. Tuliskan dan simpan project ID Anda karena Anda akan membutuhkannya untuk menjalankan aplikasi contoh yang dijelaskan dalam dokumen ini.
Pastikan Anda membuat bucket Cloud Storage untuk aplikasi Anda dengan memanggil perintah berikut:
gsutil mb gs://[YOUR_BUCKET_NAME]
Jadikan bucket terbaca oleh publik sehingga dapat menayangkan file:
gsutil defacl set public-read gs://[YOUR_BUCKET_NAME]
Download sample
Go
Untuk meng-clone repositori:
v1.18 dan yang lebih baru
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
cd golang-samples/appengine_flexible/storage
v1.15 dan yang lebih lama
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
cd golang-samples/appengine_flexible/go115_and_earlier/storage
Java
Untuk meng-clone repositori:
versi 11/17
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-11/cloudstorage
versi 8
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-8/cloudstorage
Node.js
Untuk meng-clone repositori:
v18 dan yang lebih baru
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible
v16 dan yang lebih lama
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible_nodejs16_and_earlier
PHP
Untuk meng-clone repositori:
git clone https://github.com/GoogleCloudPlatform/php-docs-samples
cd php-docs-samples/appengine/flexible/storage
Python
Untuk meng-clone repositori:
v3.8 dan yang lebih baru
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible/storage
v3.7 dan yang lebih lama
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible_python37_and_earlier/storage
Ruby
Untuk meng-clone repositori:
versi 3.2
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/flexible/storage/
versi 3.1 dan yang lebih lama
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/flexible/ruby31-and-earlier/storage/
.NET
Download aplikasi contoh dan ekstrak aplikasi.
Jika Anda menggunakan command line, buka direktori aplikasi berikut:
versi 6 dan yang lebih baru
dotnet-docs-samples\appengine\flexible\CloudStorage\CloudStorage.Sample
versi 3.1 dan yang lebih lama
Gunakan cabang
flex-dotnet3-and-earlier
.dotnet-docs-samples\appengine\flexible\CloudStorage
Untuk menjalankan aplikasi secara lokal, siapkan akun layanan dan download kredensial:
Buka daftar kredensial di konsol Google Cloud.
Klik Buat kredensial.
Pilih Kunci akun layanan.
Jendela Buat kunci akun layanan akan terbuka.
Klik kotak drop-down di bawah Akun layanan, lalu klik Akun layanan default Compute Engine.
Pilih JSON untuk Jenis kunci.
Klik Create.
Jendela Kunci pribadi baru akan ditampilkan dan kunci pribadi akan didownload secara otomatis.
Klik Close.
Mengedit konfigurasi project dan menginstal dependensi
Go
Di app.yaml
, tetapkan GCLOUD_STORAGE_BUCKET
. Nilai ini adalah
nama bucket Cloud Storage yang Anda buat sebelumnya.
v1.18 dan yang lebih baru
v1.15 dan yang lebih lama
Java
Di app.yaml
, tetapkan BUCKET_NAME
ke Cloud Storage yang sebelumnya dibuat untuk project Anda.
versi 11/17
versi 8
Di pom.xml
, tetapkan com.google.cloud
sebagai dependensi, dan tentukan
google-cloud-storage
sebagai artifactID untuk dependensi tersebut; yang
menyediakan fungsi untuk menggunakan Cloud Storage.
versi 11/17
versi 8
Node.js
Di app.yaml
, tambahkan project ID Anda ke nilai
lingkungan GOOGLE_CLOUD_PROJECT
. Kemudian, tetapkan nilai lingkungan GCLOUD_STORAGE_BUCKET
ke nama
bucket Cloud Storage yang Anda buat sebelumnya.
v18 dan yang lebih baru
v16 dan yang lebih lama
Di package.json
, tambahkan @google-cloud/storage
sebagai dependensi, yang
menyediakan fungsi untuk menggunakan Cloud Storage.
v18 dan yang lebih baru
v16 dan yang lebih lama
Lihat file README.md
untuk mendapatkan petunjuk tentang cara menjalankan dan menguji secara lokal.
PHP
Di app.yaml
, tetapkan CLOUD_STORAGE_BUCKET
; nilai ini adalah
nama bucket Cloud Storage yang Anda buat sebelumnya.
Di composer.json
, perhatikan bahwa Anda harus menyertakan library Klien Cloud,
karena library ini menyediakan fungsi Cloud Storage.
Python
Di app.yaml
, tetapkan GOOGLE_STORAGE_BUCKET
; nilai ini adalah
nama bucket Cloud Storage yang Anda buat sebelumnya.
v3.8 dan yang lebih baru
v3.7 dan yang lebih lama
Di requirements.txt
, perhatikan bahwa Anda harus menyertakan
library google-cloud-storage
, karena library ini menyediakan fungsi
Cloud Storage.
v3.8 dan yang lebih baru
v3.7 dan yang lebih lama
Ruby
Di app.yaml
, tetapkan GCLOUD_STORAGE_BUCKET
ke Cloud Storage yang sebelumnya dibuat untuk project Anda.
versi 3.2
versi 3.1 dan yang lebih lama
Perhatikan bahwa Anda harus menyertakan library gcloud
di Gemfile
untuk menggunakan fungsi Cloud Storage.
.NET
Konfigurasi hal berikut ini:
versi 6 dan yang lebih baru
Di file app.yaml
, tetapkan TEST_GOOGLE_BUCKET_NAME
ke Cloud Storage
yang telah dibuat sebelumnya untuk project Anda.
env_variables:
TEST_GOOGLE_BUCKET_NAME: [your-bucket-name]
versi 3.1 dan yang lebih lama
Di appsettings.json
, tetapkan BucketName
; nilai ini adalah nama
bucket Cloud Storage yang Anda buat sebelumnya.
Kode aplikasi
Go
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik kirim, pengendali upload akan menulis file ke bucket Cloud Storage menggunakan fungsi NewWriter Cloud Storage.
Perhatikan bahwa untuk mengambil file ini dari Cloud Storage, Anda harus menentukan nama bucket dan nama file. Anda harus menyimpan nilai-nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
Java
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file
untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik
kirim, pengendali permintaan doPost
akan menulis file ke
bucket Cloud Storage menggunakan
Storage.create
Perhatikan bahwa untuk mengambil file ini dari Cloud Storage, Anda harus menentukan nama bucket dan nama file. Anda harus menyimpan nilai-nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
versi 11/17
versi 8
Node.js
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik kirim, pengendali upload akan memuat konten file ke dalam blob dan menuliskannya ke Cloud Storage.
Perhatikan bahwa setelah file diupload ke Cloud Storage, URL publik ke file ini akan ditampilkan. URL tersebut dapat digunakan untuk menyajikan file langsung dari Cloud Storage. Anda harus menyimpan nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
PHP
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik kirim, pengendali upload akan memuat konten file ke dalam blob dan menuliskannya ke Cloud Storage.
Perhatikan bahwa setelah file diupload ke Cloud Storage, URL publik ke file ini akan ditampilkan. URL tersebut dapat digunakan untuk menyajikan file langsung dari Cloud Storage. Anda harus menyimpan nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
Python
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik kirim, pengendali upload akan memuat konten file ke blob Cloud Storage dan menuliskannya ke bucket Cloud Storage.
Perhatikan bahwa setelah file diupload ke Cloud Storage, URL publik ke file ini akan ditampilkan. URL tersebut dapat digunakan untuk menyajikan file langsung dari Cloud Storage. Anda harus menyimpan nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
v3.8 dan yang lebih baru
v3.7 dan yang lebih lama
Ruby
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik kirim, pengendali upload akan memuat konten file ke dalam blob dan menuliskannya ke Cloud Storage.
Perhatikan bahwa setelah file diupload ke Cloud Storage, URL publik ke file ini akan ditampilkan. URL tersebut dapat digunakan untuk menyajikan file langsung dari Cloud Storage. Anda harus menyimpan nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
.NET
Aplikasi contoh menampilkan halaman web yang meminta pengguna menyediakan file untuk disimpan di Cloud Storage. Saat pengguna memilih file dan mengklik kirim, pengendali upload akan memuat konten file ke dalam blob dan menuliskannya ke Cloud Storage.
Perhatikan bahwa setelah file diupload ke Cloud Storage, URL publik ke file ini akan ditampilkan. URL tersebut dapat digunakan untuk menyajikan file langsung dari Cloud Storage. Anda harus menyimpan nilai ini di aplikasi Anda untuk digunakan di masa mendatang.
versi 6 dan yang lebih baru
versi 3.1 dan yang lebih lama
Untuk informasi selengkapnya
Untuk mengetahui informasi selengkapnya tentang Cloud Storage, lihat dokumentasi Cloud Storage.