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. Anda dapat memilih versi Java 11+ yang baru atau menggunakan versi Eclipse Jetty 9.3 atau Java 8 lama. Untuk Eclipse Jetty 9.3 dan Java 8, Anda dapat menggunakan Maven atau Gradle.

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 sebelum dapat membuat dan men-deploy file app.yaml untuk layanan tambahan.

app.yaml berikut menunjukkan cara mengonfigurasi aplikasi untuk Java versi 8, 11, 17, dan yang lebih baru. Perhatikan bahwa Anda harus mengupdate file app.yaml untuk menggunakan versi baru. Lihat Runtime Java untuk mengetahui informasi selengkapnya tentang penggunaan versi baru.

versi 17 dan yang lebih baru 

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

versi 11 

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

manual_scaling:
instances: 1

versi 8 

runtime: java
env: flex

handlers:
- url: /.*
  script: this field is required, but ignored

Bergantung pada kompleksitas layanan aplikasi, Anda mungkin hanya perlu mendefinisikan beberapa elemen dalam file app.yaml yang sesuai. Contoh berikut menunjukkan apa yang mungkin diperlukan oleh aplikasi Java sederhana dalam 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, baca Membuat struktur layanan web.

Semua elemen konfigurasi

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

Mengaktifkan koleksi 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"