Catatan: Go 1.11 telah mencapai akhir dukungan pada 30 Januari 2024. Aplikasi Go 1.11 Anda yang sudah ada akan terus berjalan dan menerima traffic. Namun, App Engine mungkin memblokir deployment ulang aplikasi yang menggunakan runtime setelah akhir tanggal dukungannya. Sebaiknya migrasikan ke versi Go terbaru yang didukung.

Ringkasan 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.

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 versions 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 tingkat atas yang mencakup resource instance, versi, dan layanan yang membentuk aplikasi Anda. Saat membuat aplikasi App Engine, semua resource Anda akan dibuat di region yang dipilih, termasuk kode aplikasi beserta kumpulan setelan, kredensial, dan metadata aplikasi Anda.

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:

Grafik hierarki layanan, versi, dan instance aplikasi

Layanan Google Cloud lainnya, misalnya Datastore, dibagikan di seluruh aplikasi App Engine Anda. Untuk mengetahui informasi selengkapnya, lihat Membuat struktur layanan web.

Service

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 traffic ke satu atau beberapa versi tertentu aplikasi dengan memigrasikan atau memisahkantraffic.

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 jumlah instance untuk meminimalkan instance yang tidak aktif dan mengurangi biaya. Untuk mengetahui informasi selengkapnya tentang instance, lihat Cara Instance Dikelola.

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 mengarahkan traffic ke resource tertentu menggunakan URL, misalnya:

https://VERSION-dot-SERVICE-dot-PROJECT_ID.REGION_ID.r.appspot.com

Perhatikan bahwa panjang gabungan dari VERSION-dot-SERVICE-dot-PROJECT_ID, dengan VERSION sebagai nama versi, SERVICE sebagai nama layanan, dan PROJECT_ID adalah project ID, tidak boleh lebih dari 63 karakter dan tidak boleh diawali atau diakhiri dengan tanda hubung. Jika panjang gabungan lebih dari 63 karakter, Anda mungkin akan melihat Error DNS address could not be found.

Permintaan pengguna yang masuk diarahkan 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 di Antara Layanan.

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, lihat Menulis Log Aplikasi.

Batas

Jumlah maksimum layanan dan versi yang dapat di-deploy bergantung pada harga aplikasi Anda:

Batas	Aplikasi gratis	Aplikasi berbayar
Layanan maksimum per aplikasi	5	210
Versi maksimum per aplikasi	15	210

Ada juga batasan jumlah instance untuk setiap layanan dengan penskalaan dasar atau manual:

Instance maksimum per versi penskalaan manual/dasar
Aplikasi gratis	Aplikasi berbayar Amerika Serikat	Aplikasi berbayar Uni Eropa
20	25 (200 untuk `us-central`)	25

Ada juga batas jumlah karakter di URL aplikasi Anda.

Deskripsi	Batas
Karakter maksimum di URL Project untuk URL `VERSION-dot-SERVICE-dot-PROJECT_ID`	63