Membuat aplikasi Node.js di lingkungan fleksibel App Engine

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.

Oke

Panduan memulai ini menunjukkan cara membuat dan men-deploy aplikasi yang menampilkan pesan singkat. Aplikasi contoh menggunakan Node.js versi terbaru. Anda dapat menggunakan contoh kode yang sama untuk Node.js 18 dan yang lebih baru, dengan menentukan versi di file app.yaml Anda.

Contoh kode untuk versi Node.js 16 dan yang lebih lama tersedia di GitHub.

Sebelum memulai

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

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Aktifkan Cloud Build API.

   Mengaktifkan API

5. Menginstal Google Cloud CLI.

6. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

7. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

8. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

9. Aktifkan Cloud Build API.

   Mengaktifkan API

10. Menginstal Google Cloud CLI.

11. Untuk initialize gcloud CLI, jalankan perintah berikut:

    gcloud init

Prasyarat tambahan

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

   Perhatian: Anda tidak dapat mengubah region aplikasi setelah ditetapkan.

2. Instal prasyarat berikut:

   • Download dan instal Git.
   • Menyiapkan lingkungan Anda untuk pengembangan Node.js.

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.

Catatan: Dua lokasi, yang disebut europe-west dan us-central dalam perintah App Engine dan di konsol Google Cloud, masing-masing disebut europe-west1 dan us-central1, di bagian lain dalam dokumentasi Google.

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.

Oke

Panduan memulai ini menunjukkan aplikasi Node.js sederhana yang ditulis dengan framework Express.js.

Penting: Untuk pengalaman terbaik di Windows, upgrade pengelola paket Node.js ke versi terbaru (npm) dengan menjalankannpm install -g npm. npm terbaru menginstal dependensi dalam struktur direktori datar, sehingga penginstalan mungkin tidak akan bentrok dengan panjang jalur maksimum Windows, yaitu 255 karakter. Jika memilih untuk tetap menggunakan versi npm yang lebih lama, Anda dapat mengurangi panjang jalur dengan memindahkan project ke root drive, misalnya, C:\.

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

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

2. Ubah ke direktori yang berisi kode contoh.

      cd nodejs-docs-samples/appengine/hello-world/flexible/
   

Jalankan Halo Dunia di komputer lokal

1. Instal dependensi untuk project ini.

   npm install
   

   Atau jika Anda menggunakan Benang.

   yarn install
   

2. Jalankan skrip awal.

   npm start
   

   Atau jika Anda menggunakan Benang.

   yarn start
   

3. 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:

   http://localhost:8080

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:

1. 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 alat gcloud. 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.

   Oke
   Catatan: Selama deployment, npm install digunakan secara default untuk menginstal dependensi kecuali jika file yarn.lock ada dan tidak tidak tercantum di bagian skip_files file app.yaml, dalam hal ini yarn install --production digunakan sebagai gantinya. Agar build kembali ke npm install, hapus file yarn.lock atau tambahkan yarn.lock ke bagian skip_files dari file app.yaml Anda.

2. Luncurkan browser Anda untuk melihat aplikasi di https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

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

Perhatian: Menghapus project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.
1. Di konsol Google Cloud, buka halaman Manage resource.

   Buka Manage resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. 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 fleksibel App Engine

Berikut beberapa topik yang dapat membantu Anda melanjutkan pembelajaran tentang App Engine:

• Ringkasan App Engine
• Meminta pemilihan rute
• Meminta penanganan
• Mengelola instance

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.

const express = require('express');

const app = express();

app.get('/', (req, res) => {
  res.status(200).send('Hello, world!').end();
});

// Start the server
const PORT = parseInt(process.env.PORT) || 8080;
app.listen(PORT, () => {
  console.log(`App listening on port ${PORT}`);
  console.log('Press Ctrl+C to quit.');
});

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.

  runtime: nodejs
  env: flex
  runtime_config:
    operating_system: ubuntu22
  # This sample incurs costs to run on the App Engine flexible environment.
  # The settings below are to reduce costs during testing and are not appropriate
  # for production use. For more information, see:
  # https://cloud.google.com/appengine/docs/flexible/nodejs/configuring-your-app-with-app-yaml
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  

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

  {
    "name": "appengine-hello-world",
    "description": "Simple Hello World Node.js sample for Google App Engine Flexible Environment.",
    "version": "0.0.2",
    "private": true,
    "license": "Apache-2.0",
    "author": "Google Inc.",
    "repository": {
      "type": "git",
      "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
    },
    "engines": {
      "node": ">=16.0.0"
    },
    "scripts": {
      "start": "node app.js",
      "test": "c8 mocha -p -j 2 --exit test/*.test.js"
    },
    "dependencies": {
      "express": "^4.17.1"
    },
    "devDependencies": {
      "c8": "^8.0.0",
      "mocha": "^10.0.0",
      "supertest": "^6.0.0"
    }
  }
  

  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.