Tutorial ini ditujukan bagi mereka yang baru mempelajari cara membangun aplikasi di cloud, seperti engineer dan developer web, yang ingin mempelajari konsep pengembangan aplikasi utama saat diterapkan di Google Cloud.
Tujuan
- Pelajari alat-alat dasar Google Cloud, seperti Konsol Google Cloud dan
gcloud
. - Deploy aplikasi Anda ke Cloud Run.
- Mempertahankan data Anda dengan Firestore.
- Simpan upload file di Cloud Storage.
- Pantau aplikasi Anda menggunakan Kemampuan Observasi Google Cloud.
Biaya
Dalam dokumen ini, Anda menggunakan komponen Google Cloud yang dapat ditagih berikut:
Petunjuk dalam dokumen ini dirancang untuk menjaga penggunaan resource Anda tetap sesuai
batas-batas tingkat Selalu Gratis Google Cloud.
Untuk membuat perkiraan biaya berdasarkan proyeksi penggunaan Anda,
gunakan kalkulator harga.
Setelah menyelesaikan tugas yang dijelaskan dalam dokumen ini, Anda dapat menghindari penagihan berkelanjutan dengan menghapus resource yang Anda buat. Untuk mengetahui informasi selengkapnya, lihat Pembersihan.
Sebelum memulai
- 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.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Untuk membuat database Firestore dalam mode Native, selesaikan langkah-langkah berikut:
-
Di konsol Google Cloud, buka halaman Viewer Firestore.
Buka penampil Firestore - Dari layar Select a Cloud Firestore mode, klik Select Native Mode.
- Pilih lokasi untuk database Firestore Anda. Setelan lokasi ini merupakan lokasi resource Google Cloud default untuk project Google Cloud Anda . Lokasi ini digunakan untuk layanan Google Cloud di project Google Cloud yang memerlukan setelan lokasi, khususnya, bucket Cloud Storage default dan aplikasi Cloud Run.
- Klik Create database.
-
Di konsol Google Cloud, buka halaman Viewer Firestore.
-
Aktifkan API Cloud Run Admin, Cloud Storage, Cloud Logging, and Error Reporting.
-
Buat clone untuk repo sampel dan buka aplikasi contoh di Cloud Shell:
Buka Cloud ShellCloud Shell menyediakan akses command line ke resource Google Cloud langsung dari browser.
- Untuk mendownload kode contoh dan berpindah ke direktori aplikasi, klik Lanjutkan.
-
Di Cloud Shell, konfigurasikan alat
gcloud
untuk menggunakan project Google Cloud baru Anda:# Configure gcloud for your project gcloud config set project PROJECT_ID
Ganti PROJECT_ID dengan project ID Google Cloud yang Anda buat menggunakan Konsol Google Cloud.
Google Cloud CLI adalah cara utama Anda berinteraksi dengan resource Google Cloud dari command line. Dalam tutorial ini, Anda menggunakan alat
gcloud
untuk men-deploy dan memantau aplikasi.
Menjalankan aplikasi Anda
-
Instal dependensi aplikasi Anda menggunakan
composer
:composer install
-
Jalankan server web bawaan PHP:
Ganti PROJECT_ID dengan project ID Google Cloud yang Anda buat.GOOGLE_CLOUD_PROJECT=PROJECT_ID php -S localhost:8080
- Di Cloud Shell, klik Web preview , lalu pilih Preview on port 8080. Tindakan ini akan membuka jendela baru dengan aplikasi yang sedang berjalan.
Men-deploy aplikasi Anda ke Cloud Run
Google Cloud menawarkan beberapa opsi untuk menjalankan kode Anda. Dalam contoh ini, Anda men-deploy aplikasi skalabel ke Cloud Run. Cloud Run tidak mengharuskan Anda mengelola server dan melakukan penskalaan secara otomatis untuk mendukung lonjakan traffic.
- Deploy container ke Cloud Run:
gcloud run deploy bookshelf --region us-central1 --allow-unauthenticated \ --set-env-vars="GOOGLE_CLOUD_PROJECT=
PROJECT_ID
" --source .Aplikasi Anda sekarang dapat dilihat di URL yang ditampilkan di output
gcloud run
:Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving 100 percent of traffic. Service URL: https://bookshelf-swsmmh5s5a-uc.a.run.app
-
Salin URL ke browser web untuk melihat aplikasi.
Untuk mengetahui informasi selengkapnya tentang cara men-deploy ke Cloud Run, lihat dokumentasi Cloud Run.
Mempertahankan data Anda dengan Firestore
Anda tidak dapat menyimpan informasi pada instance Cloud Run, karena informasi tersebut akan hilang jika instance dimulai ulang, dan tidak akan ada ketika instance baru dibuat. Sebagai gantinya, Anda menggunakan database tempat semua instance dapat dibaca dan ditulis.
Google Cloud menawarkan beberapa opsi untuk menyimpan data Anda. Dalam contoh ini, Anda menggunakan Firestore untuk menyimpan data setiap buku. Firestore adalah database dokumen NoSQL yang terkelola sepenuhnya, serverless, dan dapat digunakan untuk menyimpan serta mengkueri data. Firestore akan melakukan penskalaan otomatis untuk memenuhi kebutuhan aplikasi Anda, dan melakukan penskalaan hingga nol saat Anda tidak menggunakannya. Tambahkan buku pertama Anda sekarang.
-
Untuk membuat buku bagi aplikasi yang di-deploy, klik Tambahkan buku.
- Di kolom Title, masukkan
Moby Dick
. - Pada kolom Author, masukkan
Herman Melville
. -
Klik Save. Sekarang ada entri ke aplikasi Bookshelf Anda.
-
Di konsol Google Cloud, untuk memuat ulang halaman Firestore, klik Refresh refresh.
Data akan muncul di Firestore. Aplikasi Bookshelf menyimpan setiap buku sebagai dokumen Firestore dengan ID unik, dan semua dokumen ini disimpan dalam koleksi Firestore.
Untuk keperluan tutorial ini, koleksi disebut buku.
Firestore menyimpan buku dengan menggunakan Library Klien Firestore. Berikut adalah contoh pengambilan dokumen Firestore:
Untuk informasi lebih lanjut tentang penggunaan Firestore, lihat Menambahkan data ke Firestore.
Menyimpan upload file di Cloud Storage
Sekarang setelah Anda menambahkan buku, saatnya menambahkan gambar sampul buku. Anda tidak dapat menyimpan file di instance. {i>Database<i} bukan pilihan yang tepat untuk file gambar. Sebagai gantinya, Anda menggunakan Cloud Storage.
Cloud Storage adalah penyimpanan blob utama untuk Google Cloud. Anda dapat menggunakan Cloud Storage untuk menghosting aset aplikasi yang ingin dibagikan ke seluruh Google Cloud. Untuk menggunakan Cloud Storage, Anda perlu membuat bucket Cloud Storage, container dasar untuk menyimpan data Anda.
- Pada konsol Google Cloud, buka halaman Browser Cloud Storage.
- Klik Create bucket.
- Pada dialog Create bucket, masukkan nama untuk bucket Anda dengan menambahkan project ID Google Cloud ke string
_bucket
sehingga namanya tampak sepertiYOUR_PROJECT_ID_bucket
. Nama ini tunduk pada persyaratan nama bucket. Semua kolom lain dapat tetap memiliki nilai defaultnya. - Klik Create.
- Setelah bucket dibuat, objek harus dibuat agar dapat diakses secara publik agar dapat dilihat pengguna. Untuk membuat objek Anda dapat diakses secara publik, lihat Membuat Data menjadi Publik.
-
Klik Edit buku, lalu pilih gambar yang akan diupload sebagai sampul buku. Misalnya, Anda dapat menggunakan gambar
domain publik ini:
-
Klik Save. Anda akan dialihkan ke
halaman beranda, tempat terdapat entri ke aplikasi Bookshelf Anda.
Aplikasi bookshelf mengirimkan file yang diupload ke Cloud Storage menggunakan Library Klien Cloud Storage.
Untuk informasi selengkapnya tentang penggunaan Cloud Storage, lihat Pengantar Cloud Storage.
Memantau aplikasi menggunakan Kemampuan Observasi Google Cloud
Anda telah men-deploy aplikasi serta membuat dan memodifikasi buku. Untuk memantau peristiwa ini bagi pengguna Anda, gunakan Pengelolaan Performa Aplikasi.
Memantau log dengan Cloud Logging
-
Di Google Cloud, buka Logs Explorer
Buka Logs ExplorerAnda dapat memantau aplikasi secara real time. Jika Anda mengalami masalah dengan aplikasi, ini adalah salah satu hal pertama yang harus diperiksa.
- Di menu drop-down Resource, pilih Cloud Run revision, bookshelf.
Pantau error menggunakan Error Reporting
-
Di konsol Google Cloud, buka halaman Error Reporting.
Buka halaman Error Reporting
Error Reporting menandai error dan pengecualian di aplikasi Anda serta memungkinkan Anda menyiapkan pemberitahuan seputar error tersebut. -
Di browser, buka URL
/errors
di aplikasi Anda.
YOUR_CLOUD_RUN_URL/errors
Tindakan ini akan menghasilkan pengecualian pengujian baru dan mengirimkannya ke Kemampuan Observasi Google Cloud.
-
Di konsol Google Cloud, kembali ke halaman Error Reporting, dan error baru akan terlihat dalam beberapa saat. Klik Auto Reload sehingga Anda tidak perlu memuat ulang halaman secara manual.
Pembersihan
Agar tidak perlu membayar biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, hapus project yang berisi resource tersebut, atau simpan project dan hapus setiap resource.
Menghapus project
- Di konsol Google Cloud, buka halaman Manage resource.
- Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.