Menggunakan platform Node.js Elastic Beanstalk

Topik ini menjelaskan cara mengonfigurasi, membangun, dan menjalankan aplikasi Node.js Anda di Elastic Beanstalk.

AWS Elastic Beanstalk mendukung sejumlah cabang platform untuk berbagai versi bahasa pemrograman Node.js. Lihat Node.js di dokumen AWS Elastic Beanstalk Platform untuk daftar lengkap.

Elastic Beanstalk menyediakan opsi konfigurasi yang dapat Anda gunakan untuk menyesuaikan perangkat lunak yang berjalan di EC2 contoh di lingkungan Elastic Beanstalk Anda. Anda dapat mengonfigurasi variabel lingkungan yang diperlukan oleh aplikasi Anda, mengaktifkan rotasi log ke Amazon S3, dan memetakan folder di sumber aplikasi Anda yang berisi file statis ke jalur yang disajikan oleh server proxy.

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.

Anda dapat menyertakan Package.json file dalam bundel sumber Anda untuk menginstal paket selama penerapan, untuk memberikan perintah mulai, dan untuk menentukan Node.js versi yang Anda ingin aplikasi Anda gunakan. Anda dapat menyertakan file npm-shrinkwrap.json untuk mengunci versi dependensi.

Bagian Node.js Platform mencakup server proxy untuk melayani aset statis, meneruskan lalu lintas ke aplikasi Anda, dan mengompres respons. Anda dapat memperpanjang atau menimpa konfigurasi proksi default untuk skenario lanjutan.

Ada beberapa opsi untuk memulai aplikasi Anda. Anda dapat menambahkan Procfileke bundel sumber Anda untuk menentukan perintah yang memulai aplikasi Anda. Jika Anda tidak memberikan Procfile tetapi menyediakan package.json file, Elastic Beanstalk berjalan. npm start Jika Anda juga tidak menyediakannya, Elastic Beanstalk app.js mencari server.js file atau, dalam urutan ini, dan menjalankan skrip.

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.

Mengkonfigurasi Node.js lingkungan

Anda dapat menggunakan Node.js pengaturan platform untuk menyempurnakan perilaku instans Amazon EC2 Anda. Anda dapat mengedit konfigurasi EC2 instans Amazon untuk lingkungan Elastic Beanstalk menggunakan konsol Elastic Beanstalk.

Gunakan 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 log

Bagian Opsi Log memiliki dua pengaturan:

File statis

Untuk meningkatkan kinerja, Anda dapat menggunakan bagian File statis untuk mengkonfigurasi server proxy untuk menyajikan 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

Gunakan bagian Properti Lingkungan untuk menentukan pengaturan konfigurasi lingkungan pada EC2 instance Amazon yang menjalankan aplikasi Anda. Pengaturan ini diteruskan sebagai pasangan nilai kunci ke aplikasi.

Di dalam Node.js lingkungan yang berjalan di AWS Elastic Beanstalk, Anda dapat mengakses variabel lingkungan dengan menjalankanprocess.env.ENV_VARIABLE.

var endpoint = process.env.API_ENDPOINT

Bagian Node.js platform menetapkan PORT variabel lingkungan ke port yang server proxy meneruskan lalu lintas ke. Untuk informasi selengkapnya, lihat Mengonfigurasi server proksi.

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

Node.js konfigurasi namespace

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.

Anda dapat memilih proxy yang akan digunakan pada instance untuk lingkungan Anda dengan menggunakan aws:elasticbeanstalk:environment:proxy namespace. Contoh berikut mengonfigurasi lingkungan Anda untuk menggunakan Apache HTTPD server proxy.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

Anda dapat mengonfigurasi proksi untuk menyajikan file statis dengan menggunakan namespace aws:elasticbeanstalk:environment:proxy:staticfiles. Untuk informasi lebih lanjut dan contoh, lihat Menyajikan file statis.

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

var port = process.env.PORT || 8080;

app.listen(port, function() {
  console.log('Server running at http://127.0.0.1:%s', port);
});

option_settings:
  aws:elasticbeanstalk:container:nodejs: 
    NodeCommand: "npm start"
    ProxyServer: apache
    GzipCompression: true
  aws:elasticbeanstalk:container:nodejs:staticfiles:
    /html: statichtml
    /images: staticimages