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.
Aplikasi App Engine terdiri dari satu resource aplikasi yang terdiri dari satu atau beberapa layanan. Setiap layanan dapat dikonfigurasi untuk menggunakan runtime yang berbeda dan beroperasi dengan setelan performa yang berbeda. Dalam setiap layanan, Anda dapat men-deploy versi layanan tersebut. Setiap versi kemudian berjalan dalam satu atau beberapa instance, bergantung pada jumlah traffic yang dikonfigurasi untuk ditangani.
Komponen aplikasi
Aplikasi App Engine dibuat di project Google Cloud saat Anda membuat resource aplikasi. Aplikasi App Engine adalah container level teratas yang mencakup resource layanan, versi, dan instance yang membentuk aplikasi Anda. Saat membuat aplikasi App Engine, semua resource akan dibuat di region yang Anda pilih, termasuk kode aplikasi beserta kumpulan setelan, kredensial, dan metadata aplikasi Anda. Pelajari "resource aplikasi" ( standar |fleksibel ) dan di region mana Anda dapat membuatnya.
Setiap aplikasi App Engine menyertakan setidaknya satu layanan, yaitu layanan default
, yang dapat memiliki banyak versi, bergantung pada status penagihan aplikasi Anda.
Untuk mengetahui informasi selengkapnya, lihat Batas di bawah.
Diagram berikut menggambarkan hierarki aplikasi App Engine yang berjalan dengan beberapa layanan. Dalam diagram ini, aplikasi memiliki dua layanan yang berisi beberapa versi, dan dua dari versi tersebut berjalan secara aktif di beberapa instance:
Layanan Google Cloud lainnya, misalnya Datastore, digunakan bersama di seluruh aplikasi App Engine Anda. Untuk informasi lebih lanjut, lihat "Membuat struktur layanan web" ( standar | fleksibel ).
Layanan
Gunakan layanan di App Engine untuk memasukkan aplikasi besar Anda ke dalam komponen logika yang dapat berbagi fitur App Engine secara aman dan berkomunikasi satu sama lain. Secara umum, layanan App Engine Anda berperilaku seperti microservice. Oleh karena itu, Anda dapat menjalankan seluruh aplikasi dalam satu layanan atau mendesain dan men-deploy beberapa layanan untuk dijalankan sebagai kumpulan microservice.
Misalnya, aplikasi yang menangani permintaan pelanggan Anda mungkin menyertakan beberapa layanan terpisah yang masing-masing menangani tugas yang berbeda, seperti:
- Permintaan API dari perangkat seluler
- Permintaan internal jenis administrasi
- Pemrosesan backend seperti pipeline penagihan dan analisis data
Setiap layanan di App Engine terdiri dari kode sumber dari aplikasi Anda dan file konfigurasi App Engine yang sesuai. Kumpulan file yang Anda deploy ke layanan mewakili satu versi layanan tersebut. Setiap kali Anda men-deploy ke layanan tersebut, Anda membuat versi tambahan di dalamnya layanan yang sama.
Versi
Dengan memiliki beberapa versi aplikasi dalam setiap layanan, Anda dapat beralih dengan cepat antar-versi aplikasi tersebut untuk rollback, pengujian, atau peristiwa sementara lainnya. Anda dapat mengarahkan semua traffic ke versi aplikasi tertentu dengan "memigrasikan traffic" ( standar | fleksibel ) atau rutekan ke beberapa versi aplikasi dengan "memisahkan traffic" ( standar | fleksibel ).
Instance
Versi dalam layanan Anda berjalan di satu atau beberapa instance. Secara default, App Engine menskalakan aplikasi Anda agar sesuai dengan beban. Aplikasi Anda akan meningkatkan jumlah instance yang berjalan untuk memberikan performa yang konsisten, atau menurunkan skala untuk meminimalkan instance yang tidak aktif dan mengurangi biaya. Untuk mengetahui informasi selengkapnya tentang instance, baca "Cara instance dikelola" ( standar | fleksibel ).
Di lingkungan fleksibel App Engine, instance didukung oleh resource Compute Engine. Beberapa resource yang digunakan oleh instance di lingkungan fleksibel App Engine, seperti disk, CPU, dan memori, diperhitungkan dalam kuota Compute Engine API project Anda. Untuk mengetahui detail selengkapnya tentang cara App Engine menggunakan resource Compute Engine, baca ringkasan lingkungan fleksibel App Engine.
Permintaan aplikasi
Setiap layanan aplikasi Anda dan setiap versi dalam layanan tersebut harus memiliki nama yang unik. Anda kemudian dapat menggunakan nama unik tersebut untuk menargetkan dan merutekan traffic ke resource tertentu menggunakan URL, misalnya:
https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com
Permintaan pengguna yang masuk dirutekan ke layanan atau versi yang dikonfigurasi untuk menangani traffic. Anda juga dapat menargetkan dan merutekan permintaan ke layanan dan versi tertentu. Untuk informasi selengkapnya, lihat "Berkomunikasi antar-Layanan" ( standar | fleksibel ).
Mencatat permintaan aplikasi
Saat menangani permintaan, aplikasi Anda juga dapat menulis pesan logging-nya sendiri ke stdout
dan stderr
.
Untuk mengetahui detail tentang log aplikasi Anda, lihat "Menulis Log Aplikasi"
( standar |
fleksibel ).
Batas
Lingkungan fleksibel dan lingkungan standar memiliki batas yang sama untuk layanan dan versi. Misalnya, jika Anda memiliki versi standar dan versi fleksibel di aplikasi yang sama, versi tersebut akan diperhitungkan dalam batas yang sama. Untuk mengetahui detailnya, lihat "Kuota dan batas" ( standar | fleksibel ).