Mengonfigurasi aplikasi dengan app.yaml

Aplikasi App Engine dikonfigurasi menggunakan file app.yaml, yang berisi resource CPU, memori, jaringan dan disk, penskalaan, dan setelan umum lainnya, termasuk variabel lingkungan.

Tentang file app.yaml

Anda dapat menentukan konfigurasi runtime untuk aplikasi Java, termasuk versi dan URL, dalam file app.yaml. File ini berfungsi sebagai deployment descriptor versi layanan tertentu.

Anda harus membuat file app.yaml terlebih dahulu untuk layanan default aplikasi Anda sebelum dapat membuat dan men-deploy file app.yaml untuk layanan tambahan.

Contoh app.yaml berikut menunjukkan cara mengonfigurasi aplikasi Anda untuk versi Java terbaru. Untuk mengetahui informasi selengkapnya tentang penggunaan runtime Java yang didukung, lihat runtime Java.

  runtime: java
  env: flex
  runtime_config:
  operating_system: "ubuntu22"
  runtime_version: "21"
  handlers:
  - url: /.*
  script: this field is required, but ignored

  manual_scaling:
  instances: 1

Bergantung pada kompleksitas layanan aplikasi, Anda mungkin hanya perlu mendefinisikan beberapa elemen dalam file app.yaml yang sesuai. Contoh berikut menunjukkan hal yang mungkin diperlukan aplikasi Java sederhana di lingkungan fleksibel:

Anda dapat menentukan nama unik untuk file app.yaml, tetapi juga harus menentukan nama file dengan perintah deployment. Misalnya, jika Anda menamai file app.yaml sebagai service-name-app.yaml atau app.flexible.yaml, Anda harus men-deploy aplikasi menggunakan:

gcloud app deploy service-name-app.yaml
gcloud app deploy app.flexible.yaml
Untuk mempelajari lebih lanjut cara menyusun beberapa layanan dan file app.yaml dalam aplikasi Anda, lihat Membuat struktur layanan web.

Semua elemen konfigurasi

Untuk mengetahui daftar lengkap semua elemen yang didukung dalam file konfigurasi ini, baca Referensi app.yaml.

Mengaktifkan pengumpulan metrik Java Virtual Machine

Anda dapat mengonfigurasi lingkungan fleksibel App Engine untuk Java guna mengumpulkan metrik umum untuk proses Java Virtual Machine (JVM). Metrik dikumpulkan menggunakan plugin pemantauan JVM yang sama dengan yang digunakan Cloud Monitoring. Untuk melihat daftar lengkap metrik untuk App Engine, lihat panduan metrik Google Cloud.

Jika Anda ingin mengumpulkan metrik JVM ini untuk aplikasi Anda:

  • appengine.googleapis.com/flex/instance/jvm/gc/count
  • appengine.googleapis.com/flex/instance/jvm/gc/time

Anda harus menyetel properti sistem JMX berikut pada variabel lingkungan di app.yaml dan men-deploy aplikasi.

JAVA_USER_OPTS: "-Djava.rmi.server.hostname=172.17.0.1 -Dcom.sun.management.jmxremote.port=10403 -
Dcom.sun.management.jmxremote.rmi.port=10403 -Dcom.sun.management.jmxremote.local.only=false -
Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"