Membuat aplikasi Node.js di lingkungan fleksibel 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 membuat dan men-deploy aplikasi yang menampilkan
pesan singkat. Anda dapat menggunakan aplikasi contoh dalam panduan memulai ini untuk versi Node.js apa pun yang didukung, dengan menentukan versi runtime dan sistem operasi dalam file app.yaml
.
Sebelum memulai
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
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 hal berikut di komputer lokal Anda:
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. Secara umum, 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 harga 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.
Panduan memulai ini menunjukkan aplikasi Node.js sederhana yang ditulis dengan framework Express.js.
Men-download aplikasi Halo Dunia
Kami telah membuat aplikasi Hello World untuk App Engine agar Anda dapat dengan cepat memahami cara men-deploy aplikasi ke Google Cloud.
Buat clone repositori aplikasi contoh Halo Dunia ke komputer lokal Anda.
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.
Ubah ke direktori yang berisi kode contoh.
cd nodejs-docs-samples/appengine/hello-world/flexible/
Jalankan Halo Dunia di komputer lokal
Instal dependensi untuk project ini.
npm install
Atau jika Anda menggunakan Yarn.
yarn install
Jalankan skrip awal.
npm start
Atau jika Anda menggunakan Yarn.
yarn start
Lihat aplikasi Anda di browser web.
Jika Anda menggunakan Cloud Shell, di toolbar, klik Web Preview dan pilih Preview on port 8080 sebagai gantinya.
Jika Anda tidak menggunakan Cloud Shell, masukkan alamat berikut:
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 fleksibel App Engine:-
Deploy aplikasi Halo Dunia dengan menjalankan perintah berikut dari direktori
hello-world/flexible/
: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 project ID Google Cloud Anda.
Kali ini, halaman yang menampilkan pesan Halo Dunia dikirim oleh server web yang berjalan di instance App Engine.
Selamat! Anda telah men-deploy aplikasi App Engine pertama Anda ke lingkungan fleksibel App Engine.
Jika Anda mengalami error saat men-deploy aplikasi, lihat tips pemecahan masalah.Lihat bagian berikut untuk mengetahui informasi tentang pembersihan serta link ke kemungkinan langkah berikutnya yang dapat Anda lakukan.
Pembersihan
Agar tidak menimbulkan biaya, Anda dapat menghapus project Google Cloud untuk menghentikan penagihan semua resource yang digunakan dalam project tersebut.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Langkah berikutnya
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 fleksibel App Engine
Berikut beberapa topik yang dapat membantu Anda melanjutkan pembelajaran tentang App Engine:
Ulasan kode Halo Dunia
Halo Dunia adalah aplikasi App Engine paling sederhana, karena hanya berisi satu layanan, hanya memiliki satu versi, dan semua kode berada dalam direktori utama aplikasi. Bagian ini menjelaskan setiap file aplikasi secara mendetail.
app.js
File app.js
berisi kode JavaScript untuk memulai server dan merespons
permintaan.
Kode berikut merespons permintaan dari klien web dengan menampilkan
pesan 'Hello World', melalui server yang berjalan pada port 8080
.
app.yaml
File app.yaml
mendeskripsikan konfigurasi berikut untuk aplikasi Anda:
- Menetapkan
env: flex
, yang menunjukkan bahwa aplikasi Anda menggunakan lingkungan fleksibel App Engine. Menentukan runtime yang digunakan oleh aplikasi.
Untuk mengetahui informasi lebih lanjut tentang cara kerja runtime Node.js, baca Runtime Node.js.
Untuk mengetahui detail selengkapnya tentang cara mendesain aplikasi yang memanfaatkan versi dan layanan, lihat Ringkasan App Engine.
Untuk mengetahui detail selengkapnya tentang setelan konfigurasi untuk App Engine, lihat Mengonfigurasi aplikasi dengan app.yaml.
package.json
package.json
digunakan untuk menentukan dependensi aplikasi, versi node, dan startup aplikasi.Dalam contoh sebelumnya, file
package.json
menentukan bahwa aplikasi menggunakan Node.js versi 18 dan yang lebih baru, serta bergantung pada express. Untuk mengetahui detail selengkapnya tentang cara menginstal dan menjalankan aplikasi, lihat dokumentasi runtime Node.js.