Menggunakan platform Elastic Beanstalk Tomcat

Topik ini menjelaskan cara mengonfigurasi, membangun, dan menjalankan aplikasi Java Anda yang berjalan di platform Elastic Beanstalk Tomcat.

Platform AWS Elastic Beanstalk Tomcat adalah seperangkat versi platform untuk aplikasi web Java yang dapat berjalan dalam wadah web Tomcat. Tomcat berjalan di belakang server proksi nginx. Setiap cabang platform sesuai dengan versi utama Tomcat.

Opsi konfigurasi tersedia di konsol Elastic Beanstalk untuk memodifikasi konfigurasi dari lingkungan yang sedang berjalan. Agar Anda tidak kehilangan konfigurasi lingkungan ketika mengakhirinya, Anda dapat menggunakan konfigurasi tersimpan untuk menyimpan pengaturan dan kemudian menerapkannya ke lingkungan lain.

Untuk menyimpan pengaturan di kode sumber, Anda dapat menyertakan file konfigurasi. Pengaturan di file konfigurasi diterapkan setiap kali Anda membuat lingkungan atau men-deploy aplikasi Anda. Anda juga dapat menggunakan file konfigurasi untuk menginstal paket, menjalankan penulisan, dan melakukan operasi penyesuaian instans lainnya selama deployment.

Platform Tomcat Elastic Beanstalk mencakup proksi terbalik yang meneruskan permintaan ke aplikasi Anda. Anda dapat menggunakan opsi konfigurasi untuk mengonfigurasi server proksi untuk melayani aset statis dari folder di kode sumber Anda untuk mengurangi beban di aplikasi Anda. Untuk skenario lanjutan, Anda dapat menyertakan file .conf milik Anda sendiri di paket sumber Anda untuk memperluas konfigurasi proksi Elastic Beanstalk atau menimpa sepenuhnya.

Anda harus mengemas aplikasi Java di file arsip aplikasi web (WAR) dengan struktur tertentu. Untuk informasi tentang struktur yang diperlukan dan bagaimana kaitannya dengan struktur direktori proyek Anda, lihat Menata folder proyek Anda.

Untuk menjalankan beberapa aplikasi di server web yang sama, Anda dapat memaket beberapa file WAR menjadi paket sumber tunggal. Setiap aplikasi di beberapa paket sumber WAR berjalan di jalur akar (ROOT.war berjalan di myapp.elasticbeanstalk.com/) atau di jalur yang berada langsung di bawahnya (app2.war berjalan di myapp.elasticbeanstalk.com/app2/), seperti yang ditentukan oleh nama WAR. Di satu paket sumber WAR, aplikasi selalu berjalan di jalur akar.

Pengaturan yang diterapkan di konsol Elastic Beanstalk mengganti pengaturan yang sama di file konfigurasi, jika ada. Hal tersebut memungkinkan Anda memiliki pengaturan default di file konfigurasi, dan mengganti keduanya dengan pengaturan khusus lingkungan di konsol tersebut. Untuk informasi selengkapnya tentang yang diutamakan, dan metode lain untuk mengubah pengaturan, lihat Opsi konfigurasi.

Untuk detail tentang berbagai cara memperluas platform berbasis Linux Elastic Beanstalk, lihat Memperluas platform Linux Elastic Beanstalk.

Mengonfigurasi lingkungan Tomcat Anda

Platform Elastic Beanstalk Tomcat menyediakan beberapa opsi khusus platform selain opsi standar yang dimiliki semua platform. Opsi ini memungkinkan Anda untuk mengonfigurasi mesin virtual Java (JVM) yang berjalan di server web lingkungan Anda, dan menentukan properti sistem yang menyediakan string konfigurasi informasi untuk aplikasi Anda.

Anda dapat menggunakan konsol Elastic Beanstalk untuk mengaktifkan rotasi log ke Amazon S3 dan mengonfigurasi variabel yang dapat dibaca aplikasi Anda dari lingkungan.

Opsi kontainer

Anda dapat menentukan opsi khusus platform berikut ini:

Opsi kontainer JVM

Ukuran tumpukan di mesin virtual Java (JVM) menentukan berapa banyak objek yang dapat dibuat aplikasi Anda di memori sebelum pengumpulan sampah terjadi. Anda dapat memodifikasi Ukuran Tumpukan JVM Awal (-Xms option) dan Ukuran Tumpukan JVM Maksimum (opsi). -Xmx Ukuran tumpukan awal yang lebih besar mengizinkan lebih banyak objek yang akan dibuat sebelum pengumpulan sampah terjadi, tetapi ini juga berarti bahwa pengumpul sampah akan memakan waktu lebih lama untuk memadatkan tumpukan. Ukuran tumpukan maksimum menentukan jumlah maksimum memori yang JVM dapat alokasikan ketika memperluas tumpukan selama aktivitas berat.

Generasi permanen adalah bagian dari tumpukan JVM yang menyimpan definisi kelas dan metadata terkait. Untuk memodifikasi ukuran generasi permanen, ketik ukuran baru di opsi Maximum JVM PermGen Size (-XX:MaxPermSize). Pengaturan ini hanya berlaku untuk Java 7 dan sebelumnya. Opsi ini tidak digunakan lagi di JDK 8 dan digantikan oleh opsi Size (). MaxMetaspace -XX:MaxMetaspaceSize

Untuk informasi selengkapnya tentang platform Elastic Beanstalk dan komponennya, lihat Platform yang Didukung dalam panduan Platform.AWS Elastic Beanstalk

Opsi log

Bagian Opsi Log memiliki dua pengaturan:

File statis

Untuk meningkatkan kinerja, Anda dapat menggunakan bagian File statis untuk mengkonfigurasi server proxy untuk melayani file statis (misalnya, HTML atau gambar) dari satu set direktori di dalam aplikasi web Anda. Untuk setiap direktori, Anda mengatur jalur virtual ke pemetaan direktori. Saat server proksi menerima permintaan untuk file di jalur yang ditentukan, server langsung menyajikan file daripada merutekan permintaan ke aplikasi Anda.

Untuk detail tentang mengonfigurasi file statis menggunakan file konfigurasi atau konsol Elastic Beanstalk, lihat. Menyajikan file statis

Properti lingkungan

Di bagian Properti Lingkungan, Anda dapat menentukan pengaturan konfigurasi lingkungan pada EC2 instans Amazon yang menjalankan aplikasi Anda. Properti lingkungan diberikan sebagai pasangan nilai kunci ke aplikasi.

Platform Tomcat menentukan properti placeholder bernama JDBC_CONNECTION_STRING untuk lingkungan Tomcat untuk melewati string koneksi ke basis data eksternal.

Di dalam lingkungan Tomcat yang berjalan di Elastic Beanstalk, variabel lingkungan dapat diakses menggunakan System.getProperty(). Sebagai contoh, Anda dapat membaca properti bernama API_ENDPOINT ke variabel dengan kode berikut.

String endpoint = System.getProperty("API_ENDPOINT");

Lihat Properti lingkungan dan pengaturan perangkat lunak lainnya untuk informasi selengkapnya.

Namespace konfigurasi Tomcat

Anda dapat menggunakan file konfigurasi untuk mengatur opsi konfigurasi dan melakukan tugas-tugas konfigurasi instans lain selama deployment. Opsi konfigurasi dapat berupa platform khusus atau berlaku untuk semua platform di layanan Elastic Beanstalk secara keseluruhan. Opsi konfigurasi diatur ke dalam ruang nama.

Platform Tomcat mendukung opsi di namespace berikut, selain opsi yang didukung untuk semua lingkungan Elastic Beanstalk:

File konfigurasi contoh berikut menunjukkan penggunaan opsi konfigurasi tertentu Tomcat.

option_settings:
  aws:elasticbeanstalk:container:tomcat:jvmoptions:
    Xms: 512m
    JVM Options: '-Xmn128m'
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: mywebapi.zkpexsjtmd.us-west-2.elasticbeanstalk.com
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

Elastic Beanstalk memberikan banyak opsi konfigurasi untuk menyesuaikan lingkungan Anda. Selain file konfigurasi, Anda juga dapat mengatur opsi konfigurasi menggunakan konsol tersebut, konfigurasi tersimpan, EB CLI, atau AWS CLI. Lihat Opsi konfigurasi untuk informasi selengkapnya.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    GzipCompression: 'true'
    ProxyServer: nginx

zip -ur your_application.war .ebextensions