Menggunakan .NET Core di platform Linux

AWS Elastic Beanstalk .NET Core di platform Linux adalah satu set versi platform untuk aplikasi .NET Core yang berjalan di sistem operasi Linux.

Untuk detail tentang berbagai cara memperluas platform berbasis Linux Elastic Beanstalk, lihat Memperluas platform Linux Elastic Beanstalk. Berikut ini adalah beberapa pertimbangan khusus platform.

Pengantar .NET Core di platform Linux

Server proksi

Elastic Beanstalk .NET Core di platform Linux mencakup proksi terbalik yang meneruskan permintaan untuk aplikasi Anda. Secara default, Elastic Beanstalk menggunakan nginx sebagai server proksi. Anda dapat memilih untuk tidak menggunakan server proksi, dan mengonfigurasi Kestrel sebagai server web Anda. Kestrel disertakan secara default di templat proyek ASP.NET Core.

Struktur aplikasi

Anda dapat mempublikasikan aplikasi yang bergantung pada waktu aktif yang menggunakan waktu aktif .NET Core yang disediakan oleh Elastic Beanstalk. Anda juga dapat mempublikasikan aplikasi mandiri yang mencakup waktu aktif .NET Core dan dependensi aplikasi Anda di paket sumber. Untuk pelajari selengkapnya, lihat Aplikasi paketan untuk .NET Core di platform Linux.

Konfigurasi platform

Untuk mengonfigurasi proses yang berjalan di instans server di lingkungan Anda, sertakan Procfile opsional di paket sumber Anda. Procfile diperlukan jika Anda memiliki lebih dari satu aplikasi di paket sumber Anda.

Kami merekomendasikan Anda agar selalu menyediakan Procfile di paket sumber dengan aplikasi Anda. Dengan cara ini, Anda secara tepat mengontrol proses mana yang dijalankan Elastic Beanstalk untuk aplikasi Anda.

Opsi konfigurasi tersedia di konsol Elastic Beanstalk untuk memodifikasi konfigurasi dari lingkungan yang sedang berjalan. Untuk menghindari kehilangan konfigurasi lingkungan ketika Anda mengakhirinya, Anda dapat menggunakan konfigurasi tersimpan untuk menyimpan pengaturan Anda 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.

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.

Mengonfigurasi .NET Core Anda di lingkungan Linux

.NET Core di pengaturan platform Linux memungkinkan Anda untuk menyempurnakan perilaku instans Amazon EC2 Anda. Anda dapat mengedit konfigurasi instans Amazon EC2 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.

Untuk mengonfigurasi .NET Core di lingkungan Linux Anda menggunakan konsol Elastic Beanstalk

1. Buka konsol Elastic Beanstalk, dan di daftar Wilayah, pilih konsol Elastic Beanstalk. Wilayah AWS

2. Di panel navigasi, pilih Lingkungan, dan kemudian pilih nama lingkungan Anda dari daftar.

   catatan

   Jika Anda memiliki banyak lingkungan, gunakan bilah pencarian untuk memfilter daftar lingkungan.

3. Di panel navigasi, pilih Konfigurasi.

4. Dalam kategori konfigurasi Pembaruan, pemantauan, dan pencatatan, pilih Edit.

Opsi log

Bagian Opsi Log memiliki dua pengaturan:

• Profil instans – Menentukan profil instans yang memiliki izin untuk mengakses bucket Amazon S3 yang terkait dengan aplikasi Anda.

• Aktifkan rotasi file log ke Amazon S3 — Menentukan apakah berkas log untuk instans Amazon EC2 aplikasi Anda disalin ke bucket Amazon S3 yang terkait dengan aplikasi Anda.

Properti lingkungan

Bagian Properti Lingkungan memungkinkan Anda untuk menentukan pengaturan konfigurasi lingkungan di instans Amazon EC2 yang menjalankan aplikasi Anda. Properti lingkungan diberikan sebagai pasangan nilai kunci ke aplikasi.

Di dalam .NET Core di lingkungan Linux yang berjalan di Elastic Beanstalk, variabel lingkungan dapat diakses menggunakan Environment.GetEnvironmentVariable("variable-name"). Sebagai contoh, Anda dapat membaca properti bernama API_ENDPOINT ke variabel dengan kode berikut.

string endpoint = Environment.GetEnvironmentVariable("API_ENDPOINT");

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

.NET Core di namespace konfigurasi Linux

Anda dapat menggunakan file konfigurasi untuk mengatur opsi konfigurasi dan melakukan tugas-tugas konfigurasi instans lain selama deployment. Opsi konfigurasi dapat ditentukan oleh layanan Elastic Beanstalk atau platform yang Anda gunakan dan disusun ke dalam namespace.

.NET Core di platform Linux mendukung opsi di namespace berikut, selain opsi yang didukung untuk semua lingkungan Elastic Beanstalk:

• aws:elasticbeanstalk:environment:proxy – Pilih untuk menggunakan nginx atau tanpa server proksi. Nilai yang benar adalah nginx atau none.

File konfigurasi contoh berikut menunjukkan penggunaan .NET Core di opsi konfigurasi khusus Linux.

contoh .ebextensions/proxy-settings.config

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: none

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.