Membuat aplikasi Ruby di lingkungan standar App Engine
ID region
REGION_ID
adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r
disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.
Pelajari ID region lebih lanjut.
Panduan memulai ini menunjukkan cara men-deploy aplikasi contoh di App Engine.
Biaya
Panduan ini bersifat gratis. Kuota gratis Anda tidak akan terlampaui meskipun aplikasi contoh ini dijalankan.
Panduan memulai ini menunjukkan cara membuat aplikasi App Engine kecil yang menampilkan pesan singkat.
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.
-
Aktifkan Cloud Build API.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan Cloud Build API.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
Prasyarat tambahan
Lakukan inisialisasi aplikasi App Engine dengan project Anda, lalu pilih region:
gcloud app create --project=[YOUR_PROJECT_ID]
Saat diminta, pilih region tempat Anda ingin menemukan aplikasi App Engine.
Instal prasyarat berikut:
Lokasi App Engine
App Engine bersifat regional. Artinya, infrastruktur yang menjalankan aplikasi Anda terletak di region tertentu, dan Google mengelolanya sehingga aplikasi Anda tersedia secara redundan di semua zona dalam region tersebut.
Memenuhi persyaratan latensi, ketersediaan, atau ketahanan adalah faktor utama untuk memilih region tempat aplikasi dijalankan. Umumnya, Anda dapat memilih region yang paling dekat dengan pengguna aplikasi Anda, tetapi Anda harus mempertimbangkan lokasi tempat App Engine tersedia serta lokasi dari produk dan layanan Google Cloud lainnya yang digunakan aplikasi Anda. Penggunaan layanan di beberapa lokasi dapat memengaruhi latensi dan pricing aplikasi.
Anda tidak dapat mengubah region aplikasi setelah menyetelnya.
Jika sudah membuat aplikasi App Engine, Anda dapat melihat region-nya dengan melakukan salah satu tindakan berikut:
Jalankan perintah
gcloud app describe
.Buka Dasbor App Engine di konsol Google Cloud. Region muncul di dekat bagian atas halaman.
Mendownload aplikasi Halo Dunia
Kami telah membuat aplikasi Halo Dunia sederhana untuk App Engine agar Anda dapat dengan cepat membiasakan diri dalam men-deploy aplikasi ke Google Cloud.
Buat clone repositori aplikasi contoh Halo Dunia ke komputer lokal Anda.
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.
Ubah ke direktori yang berisi kode contoh.
cd ruby-docs-samples/appengine/hello_world
Menjalankan Halo Dunia di komputer lokal
Contoh ini menggunakan Bundler untuk menjalankan aplikasi Halo Dunia di komputer lokal:
Jika Anda belum menginstal bahasa pemrograman untuk runtime, download dan instal Ruby.
Instal Bundler:
gem install bundler
Instal dependensi untuk project ini:
bundle install
Mulai server web lokal.
bundle exec ruby app.rb -p 8080
Di browser web Anda, masukkan:
Pesan Halo Dunia dari aplikasi contoh akan ditampilkan di halaman. Di jendela terminal, tekan Ctrl+C untuk keluar dari server web.
Men-deploy dan menjalankan Halo Dunia di App Engine
Untuk men-deploy aplikasi Anda ke lingkungan Standar App Engine:
-
Deploy aplikasi Halo Dunia dengan menjalankan perintah berikut dari direktori
hello_world
:gcloud app deploy
Pelajari flag opsional.
Flag perintah
gcloud
umum-
Sertakan flag
--version
untuk menentukan ID yang secara unik mengidentifikasi versi aplikasi Anda. Jika tidak, ID akan dibuatkan untuk Anda. Contoh:--version [YOUR_VERSION_ID]
-
Sertakan flag
--project
untuk menentukan project ID Google Cloud alternatif dengan yang Anda inisialisasi sebagai default di alatgcloud
. Contoh:--project [YOUR_PROJECT_ID]
Contoh:
gcloud app deploy --version pre-prod-5 --project my-sample-app
Untuk mempelajari lebih lanjut cara men-deploy aplikasi dari command line, lihat bagian Menguji dan Men-deploy Aplikasi. Untuk daftar semua flag perintah, lihat referensi
gcloud app deploy
. -
Sertakan flag
-
Luncurkan browser Anda untuk melihat aplikasi di
https://PROJECT_ID.REGION_ID.r.appspot.com
dengangcloud app browse
PROJECT_ID
mewakili ID project Google Cloud Anda.
Kali ini, halaman yang menampilkan pesan Halo Dunia dikirim oleh server web yang berjalan di instance App Engine.
Selamat! Anda berhasil men-deploy aplikasi App Engine pertama Anda ke lingkungan standar App Engine.
Lihat bagian berikut untuk mengetahui informasi tentang pembersihan serta link ke langkah berikutnya yang dapat Anda ambil.
Pembersihan
Agar tidak menimbulkan biaya, Anda dapat menghapus project Google Cloud untuk menghentikan penagihan semua resource yang digunakan dalam project tersebut.
- 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.
Langkah selanjutnya
Mempelajari seluruh platform
Setelah mengetahui cara mengembangkan dan men-deploy aplikasi App Engine, Anda dapat menjelajahi bagian Google Cloud lainnya. Anda telah menginstal Google Cloud CLI yang menyediakan alat untuk berinteraksi dengan produk seperti Cloud SQL, Cloud Storage, Firestore, dan lainnya.
Mempelajari lingkungan standar App Engine
Berikut beberapa topik yang dapat membantu Anda melanjutkan pembelajaran tentang App Engine: