View a markdown version of this page

QuickStart: Menyebarkan aplikasi .NET Core pada Linux ke Elastic Beanstalk - AWS Elastic Beanstalk

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

QuickStart: Menyebarkan aplikasi .NET Core pada Linux ke Elastic Beanstalk

QuickStart Tutorial ini memandu Anda melalui proses pembuatan .NET Core pada aplikasi Linux dan menyebarkannya ke AWS Elastic Beanstalk lingkungan.

Bukan untuk penggunaan produksi

Contoh dimaksudkan untuk demonstrasi saja. Jangan gunakan contoh aplikasi dalam produksi.

Klaster AWS akun

Jika Anda belum menjadi AWS pelanggan, Anda perlu membuat AWS akun. Mendaftar memungkinkan Anda mengakses Elastic Beanstalk AWS dan layanan lain yang Anda butuhkan.

Jika Anda sudah memiliki AWS akun, Anda dapat melanjutkan kePrasyarat.

Mendaftar untuk Akun AWS

Untuk memulai AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat Memulai dengan Akun AWS di Panduan AWS Account Management Referensi.

Prasyarat

Untuk mengikuti prosedur di panduan ini, Anda memerlukan terminal atau shell baris perintah untuk menjalankan perintah. Perintah ditampilkan dalam daftar yang diawali dengan simbol prompt ($) dan nama direktori saat ini, bila perlu.

~/eb-project$ this is a command this is output

Di Linux dan macOS, Anda dapat menggunakan shell dan manajer paket pilihan Anda. Pada Windows Anda dapat menginstal Windows Subsystem untuk Linux untuk mendapatkan Windows-integrated versi Ubuntu dan Bash.

EB CLI

Tutorial ini menggunakan Elastic Beanstalk Command Line Interface (EB CLI). Untuk detail tentang pemasangan dan konfigurasi EB CLI, lihat Instal EB CLI dengan skrip pengaturan (disarankan) dan Mengonfigurasi EB CLI.

.NET Core pada Linux

Jika Anda tidak memiliki .NET SDK diinstal pada mesin lokal Anda, Anda dapat menginstalnya dengan mengikuti tautan Download.NET di situs web dokumentasi.NET.

Verifikasi instalasi .NET SDK Anda dengan menjalankan perintah berikut.

~$ dotnet --info

Langkah 1: Buat .NET Core pada aplikasi Linux

Buat direktori proyek.

~$ mkdir eb-dotnetcore ~$ cd eb-dotnetcore

Selanjutnya, buat contoh aplikasi Hello World dengan menjalankan perintah berikut.

~/eb-dotnetcore$ dotnet new web --name HelloElasticBeanstalk ~/eb-dotnetcore$ cd HelloElasticBeanstalk

Langkah 2: Jalankan aplikasi Anda secara lokal

Jalankan perintah berikut untuk menjalankan aplikasi Anda secara lokal.

~/eb-dotnetcore/HelloElasticBeasntalk$ dotnet run

Outputnya akan terlihat seperti teks berikut.

Building... info: Microsoft.Hosting.Lifetime[14] Now listening on: https://localhost:7294 info: Microsoft.Hosting.Lifetime[14] Now listening on: http://localhost:5052 info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down. info: Microsoft.Hosting.Lifetime[0] Hosting environment: Development info: Microsoft.Hosting.Lifetime[0]
catatan

dotnetPerintah memilih port secara acak saat menjalankan aplikasi secara lokal. Dalam contoh ini port adalah 5052. Saat Anda menerapkan aplikasi ke lingkungan Elastic Beanstalk Anda, aplikasi akan berjalan pada port 5000.

Masukkan alamat URL http://localhost:port di browser web Anda. Untuk contoh spesifik ini, perintahnya adalahhttp://localhost:5052. Browser web harus menampilkan “Hello World!”.

Langkah 3: Menyebarkan .NET Core Anda pada aplikasi Linux dengan EB CLI

Jalankan perintah berikut untuk membuat lingkungan Elastic Beanstalk untuk aplikasi ini.

Untuk membuat lingkungan dan menyebarkan .NET Core Anda di aplikasi Linux
  1. Kompilasi dan publikasikan aplikasi Anda ke folder untuk penyebaran ke lingkungan Elastic Beanstalk yang akan Anda buat.

    ~$ cd eb-dotnetcore/HelloElasticBeanstalk ~/eb-dotnetcore/HelloElasticBeanstalk$ dotnet publish -o site
  2. Arahkan ke direktori situs tempat Anda baru saja menerbitkan aplikasi.

    ~/eb-dotnetcore/HelloElasticBeanstalk$ cd site
  3. Inisialisasi repositori EB CLI Anda dengan perintah eb init.

    Perhatikan detail berikut mengenai versi cabang platform yang Anda tentukan dalam perintah:

    • Ganti x.y.z dalam perintah berikut dengan versi terbaru dari cabang platform .NET 6 pada AL2023.

    • Untuk menemukan versi cabang platform terbaru, lihat .NET Core pada platform yang Didukung Linux dalam panduan AWS Elastic Beanstalk Platform.

    • Contoh nama tumpukan solusi yang menyertakan nomor versi adalah64bit-amazon-linux-2023-v3.1.1-running-.net-6. Dalam contoh ini versi cabang adalah 3.1.1.

    ~eb-dotnetcore/HelloElasticBeanstalk/site$ eb init -p 64bit-amazon-linux-2023-vx.y.z-running-.net-6 dotnetcore-tutorial --region us-east-2 Application dotnetcore-tutorial has been created.

    Perintah ini membuat aplikasi bernama dotnetcore-tutorial dan mengkonfigurasi repositori lokal Anda untuk membuat lingkungan dengan.NET Core pada versi platform Linux yang ditentukan dalam perintah.

  4. (Opsional) Jalankan eb init lagi untuk mengonfigurasi pasangan kunci default, sehingga Anda dapat menggunakan SSH untuk terhubung ke instans EC2 yang menjalankan aplikasi Anda.

    ~eb-dotnetcore/HelloElasticBeanstalk/site$ eb init Do you want to set up SSH for your instances? (y/n): y Select a keypair. 1) my-keypair 2) [ Create new KeyPair ]

    Pilih pasangan kunci jika Anda sudah memilikinya, atau ikuti prompt untuk membuatnya. Jika Anda tidak melihat prompt atau perlu mengubah pengaturan Anda nanti, jalankan eb init -i.

  5. Buat lingkungan baru dan deploy aplikasi Anda dengan eb create. Elastic Beanstalk secara otomatis membuat file zip untuk aplikasi Anda dan memulainya pada port 5000.

    kepada

    ~eb-dotnetcore/HelloElasticBeanstalk/site$ eb create dotnet-tutorial

    Dibutuhkan sekitar lima menit untuk Elastic Beanstalk untuk menciptakan lingkungan Anda.

Langkah 4: Jalankan aplikasi Anda di Elastic Beanstalk

Ketika proses untuk membuat lingkungan Anda selesai, buka situs web Anda denganeb open.

~eb-dotnetcore/HelloElasticBeanstalk/site$ eb open

Selamat! Anda telah menerapkan aplikasi.NET Core di Linux dengan Elastic Beanstalk! Ini akan membuka jendela peramban menggunakan nama domain yang dibuat untuk aplikasi Anda.

Langkah 5: Bersihkan

Anda dapat menghentikan lingkungan Anda ketika Anda selesai bekerja dengan aplikasi Anda. Elastic Beanstalk AWS mengakhiri semua sumber daya yang terkait dengan lingkungan Anda.

Untuk mengakhiri lingkungan Elastic Beanstalk Anda dengan EB CLI jalankan perintah berikut.

~eb-dotnetcore/HelloElasticBeanstalk/site$ eb terminate

AWS sumber daya untuk aplikasi Anda

Anda baru saja membuat aplikasi instance tunggal. Ini berfungsi sebagai aplikasi sampel langsung dengan satu instans EC2, sehingga tidak memerlukan penyeimbangan beban atau penskalaan otomatis. Untuk aplikasi contoh tunggal Elastic Beanstalk menciptakan sumber daya berikut: AWS

  • Instans EC2 – Mesin virtual Amazon EC2 yang dikonfigurasi untuk menjalankan aplikasi web di platform yang Anda pilih.

    Setiap platform menjalankan satu set perangkat lunak, file konfigurasi, dan penulisan yang berbeda untuk mendukung versi bahasa, kerangka kerja, kontainer web tertentu, atau kombinasi dari semua ini. Sebagian besar platform menggunakan Apache atau nginx sebagai proksi terbalik yang memproses lalu lintas web di depan aplikasi web Anda, meneruskan permintaan ke aplikasi web, menyajikan aset statis, dan menghasilkan log akses dan kesalahan.

  • Grup keamanan instans – Grup keamanan Amazon EC2 yang dikonfigurasi untuk mengizinkan lalu lintas masuk di port 80. Sumber daya ini memungkinkan lalu lintas HTTP dari penyeimbang beban mencapai instans EC2 yang menjalankan aplikasi web Anda. Secara default, lalu lintas tidak diizinkan di port lain.

  • Bucket Amazon S3 – Lokasi penyimpanan untuk kode sumber, log, dan artifact lainnya yang dibuat saat Anda menggunakan Elastic Beanstalk.

  • CloudWatch Alarm Amazon — Dua CloudWatch alarm yang memantau beban pada instans di lingkungan Anda dan dipicu jika beban terlalu tinggi atau terlalu rendah. Saat alarm terpicu, grup Auto Scaling Anda akan menaikkan atau menurunkan skala sebagai respons.

  • CloudFormation stack - Elastic CloudFormation Beanstalk digunakan untuk meluncurkan sumber daya di lingkungan Anda dan menyebarkan perubahan konfigurasi. Sumber daya ditentukan di sebuah templat yang dapat Anda lihat di Konsol CloudFormation.

  • Nama domain — Nama domain yang merutekan ke aplikasi web Anda dalam formulir subdomain. region.elasticbeanstalk.com.

Elastic Beanstalk mengelola semua sumber daya tersebut. Ketika Anda mengakhiri lingkungan, Elastic Beanstalk mengakhiri semua sumber daya yang dimuatnya.

Langkah selanjutnya

Setelah lingkungan Anda menjalankan aplikasi, Anda dapat men-deploy versi baru aplikasi atau aplikasi yang berbeda kapan saja. Men-deploy versi aplikasi baru itu sangat cepat karena tidak memerlukan persediaan atau memulai ulang instans EC2. Anda juga dapat menjelajahi lingkungan baru Anda menggunakan konsol Elastic Beanstalk. Untuk langkah-langkah mendetail, lihat Menjelajahi lingkungan Anda di bagian Memulai panduan ini.

Setelah Anda menerapkan satu atau dua contoh aplikasi dan siap untuk mulai mengembangkan dan menjalankan .NET Core pada aplikasi Linux secara lokal, lihat. Menyiapkan inti .NET Anda di lingkungan pengembangan Linux untuk Elastic Beanstalk

Terapkan dengan konsol Elastic Beanstalk

Anda juga dapat menggunakan konsol Elastic Beanstalk untuk meluncurkan aplikasi sampel. Untuk langkah-langkah rinci, lihat Membuat aplikasi contoh di Bab Memulai panduan ini.