Menentukan setelan runtime

Aplikasi App Engine dikonfigurasi menggunakan file app.yaml, yang berisi runtime, pengendali, 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.

Jika Anda tidak membuat file app.yaml, perintah gcloud app deploy dapat membuatnya saat Anda men-deploy aplikasi. File app.yaml yang dibuat App Engine hanya berisi setelan yang diperlukan untuk menjalankan aplikasi Anda.

Umumnya, file app.yaml hanya memerlukan elemen runtime untuk aplikasi Java sederhana di lingkungan standar, misalnya:

runtime: java21

App Engine memberikan nilai default untuk semua setelan lainnya, termasuk class instance F1, yang menentukan resource memori dan CPU yang tersedia untuk aplikasi Anda, dan penskalaan otomatis, yang mengontrol cara dan waktu pembuatan instance baru aplikasi Anda.

Jika Anda perlu mengganti setelan default, buat file app.yaml dan tentukan setelan yang diperlukan. Untuk informasi selengkapnya, lihat referensi file app.yaml.

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.standard.yaml, Anda harus men-deploy aplikasi menggunakan:

gcloud app deploy service-name-app.yaml
gcloud app deploy app.standard.yaml

Untuk mempelajari selengkapnya tentang cara membuat struktur beberapa layanan dan file app.yaml di aplikasi Anda, lihat Membuat struktur layanan web.

Untuk project Maven, lokasi standar untuk file app.yaml berada di direktori src/main/appengine. Plugin App Engine Maven akan membuat direktori target/appengine-staging yang benar yang berisi artefak JAR Anda dan file app.yaml ini, yang siap untuk deployment.

Berikut adalah contoh struktur project Maven:

MyDir/
  pom.xml
  [index.yaml]
  [cron.yaml]
  [dispatch.yaml]
  src/main/
    appengine/
      app.yaml
    java/com.example.mycode/
      MyCode.java

Jika memiliki lebih dari satu file JAR di direktori project, atau ingin menentukan titik entri kustom, Anda harus menentukannya dalam elemen entrypoint file app.yaml Anda.

Semua elemen konfigurasi

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