Menerbitkan aplikasi ASP.NET Core ke Azure dengan Visual Studio Code

Dengan tutorial ini, Anda akan mempelajari cara membuat Aplikasi MVC Core ASP.Net dan menyebarkannya dalam Visual Studio Code. Tutorial mengasumsikan keakraban dengan Visual Studio Code. Untuk informasi selengkapnya, lihat Mulai menggunakan Visual Studio Code. Tutorial ini akan berfungsi di lingkungan Windows, macOS, atau Linux. Pastikan untuk menggunakan jalur yang benar yang memisahkan karakter (\ vs /) untuk lingkungan Anda.

Important

ASP.NET Core versi pratinjau dengan Azure App Service

Rilis pratinjau ASP.NET Core tidak dijalankan ke Azure App Service secara default. Untuk menghosting aplikasi yang menggunakan rilis pratinjau ASP.NET Core, lihat Menyebarkan rilis pratinjau ASP.NET Core ke Azure App Service.

Untuk memecahkan masalah penyebaran App Service, lihat Memecahkan masalah ASP.NET Core di Azure App Service dan IIS.

Prerequisites

• Langganan Azure. Dapatkan akun Azure gratis jika Anda tidak memilikinya.
• .NET SDK (rilis stabil terbaru).
• Kode Visual Studio.
  • Ekstensi C#.
  • Ekstensi Azure App Service. Gunakan ekstensi untuk masuk ke Azure sebelum melanjutkan.

Membuat proyek ASP.Net Core MVC

1. Buka terminal yang terintegrasi.

2. Atur direktori kerja Anda (cd) ke direktori yang akan berisi proyek.

3. Jalankan perintah berikut:

   dotnet new mvc -o MyMVCapp
   code -r MyMVCapp
   

   Untuk perintah sebelumnya:

   • dotnet new mvc -o MyMVCapp
     • Membuat proyek ASP.NET Core MVC baru di folder MyMVCapp .
   • code -r MyMVCapp
     • MyMVCapp.csproj Memuat file proyek di Visual Studio Code.
     • Visual Studio Code memperbarui terminal terintegrasi ke direktori proyek.

Note

Jika kotak dialog muncul dengan Aset yang diperlukan untuk membangun dan men-debug hilang dari 'MyMVCapp'. Tambahkan?, pilih Ya.

Proyek ASP.NET Core MVC baru dibuat di folder MyMVCapp dengan struktur yang mirip dengan yang berikut ini:

      appsettings.Development.json
      appsettings.json
<DIR> bin
<DIR> Controllers
<DIR> Models
      MyMVCapp.csproj
<DIR> obj
      Program.cs
<DIR> Properties
<DIR> Views
<DIR> wwwroot

Folder .vscode akan dibuat di bawah struktur proyek. Ini akan berisi file utilitas untuk membantu Anda membangun dan men-debug aplikasi web ASP.NET Core Anda.

Menguji proyek

Sebelum menyebarkan aplikasi ke Azure, pastikan aplikasi berjalan dengan benar di komputer lokal Anda.

1. Buka terminal terintegrasi (jika diperlukan).

2. Siapkan sertifikat pengembangan HTTPS tepercaya:

   • Percayai sertifikat pengembangan HTTPS dengan menjalankan perintah berikut:

     dotnet dev-certs https --trust
     

     Perintah sebelumnya memerlukan .NET 9 atau SDK yang lebih baru di Linux. Untuk Linux di .NET 8.0.401 atau SDK yang lebih lama, lihat dokumentasi distribusi Linux Anda untuk mempercayai sertifikat.

     Perintah sebelumnya menampilkan dialog berikut, asalkan sertifikat sebelumnya tidak tepercaya:

     

   • Pilih Ya jika Anda setuju untuk mempercayai sertifikat pengembangan tersebut.

     Untuk informasi selengkapnya, lihat bagian Percayai sertifikat pengembangan ASP.NET Core HTTPS di artikel Memberlakukan SSL.

   Untuk informasi tentang mempercayai browser Firefox, lihat artikel Firefox Kesalahan Sertifikat SEC_ERROR_INADEQUATE_KEY_USAGE.

3. Jalankan perintah berikut:

   dotnet run
   

   Perintah sebelumnya:

   • KestrelMulai, server web bawaan ASP.NET Core.
   • Menampilkan URL untuk menguji aplikasi web seperti http://localhost:<port>, di mana <port> adalah nomor port acak yang diatur dalam Properties\launchSettings.json saat pembuatan proyek.

   Output menunjukkan pesan yang mirip dengan yang berikut ini, menunjukkan bahwa aplikasi sedang berjalan dan menunggu permintaan:

   $ dotnet run
   Building...
   info: Microsoft.Hosting.Lifetime[14]
       Now listening on: https://localhost:7064
   info: Microsoft.Hosting.Lifetime[14]
       Now listening on: http://localhost:5119
   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]
       Content root path: D:\Src\MyMVCapp\
   

4. Ctrl+klik URL HTTPS di output untuk menguji aplikasi web di browser. Dalam contoh di atas, URL adalah https://localhost:7064.

5. Tekan Ctrl+C di terminal terintegrasi untuk mematikan aplikasi web setelah mengujinya.

Membuat paket penyebaran secara lokal

1. Di terminal terintegrasi, gunakan perintah berikut untuk menghasilkan Release paket di folder yang terletak di bin/Publish:

   dotnet publish -c Release -o ./bin/Publish
   

   Subfolder baru Publish akan dibuat di bin folder. Folder ini berisi file yang akan disebarkan ke Azure.

   

Menerbitkan ke Azure App Service

Memanfaatkan ekstensi Azure App Service untuk Visual Studio Code, ikuti langkah-langkah di bawah ini untuk menerbitkan situs web langsung ke Azure App Service.

Membuat sumber daya Azure Web App baru

Jika Anda tidak memiliki sumber daya Azure Web App yang ada untuk mempublikasikan, Anda harus membuatnya.

1. Di tab ekstensi Azure, di panel SUMBER DAYA , perluas langganan yang ingin Anda gunakan.
2. Klik kanan App Services dan pilih Buat Aplikasi Web Baru....
3. Ikuti perintah:
   1. Masukkan nama unik untuk aplikasi web.
   2. Pilih runtime .NET stabil terbaru (seperti .NET 6 (LTS)). Jangan pilih runtime ASP.NET, yaitu untuk aplikasi .NET Framework.
   3. Pilih tingkat harga Anda. Gratis (F1) sudah cukup untuk tutorial ini.

Menerbitkan ke Azure

1. bin\Publish Klik kanan folder dan pilih Deploy to Web App... dan ikuti perintah.

   1. Pilih langganan tempat sumber daya Azure Web App berada.
   2. Pilih sumber daya Azure Web App yang akan Anda terbitkan.
   3. Pilih Sebarkan saat diminta dengan dialog konfirmasi.

2. Setelah penyebaran selesai, klik Browse Website untuk memvalidasi penyebaran.

   

   Setelah mengklik Browse Website, Anda akan menavigasinya menggunakan browser default Anda:

   

Tip

Anda dapat mengulangi langkah-langkah di atas untuk menyebarkan ulang aplikasi ke sumber daya Azure Web App yang sama sesuai kebutuhan. Pastikan untuk menjalankan dotnet publish lagi sebelum Anda menyebarkan ke Azure.

Langkah selanjutnya

• Membuat alur Azure DevOps pertama Anda

Sumber daya tambahan

• Azure App Service
• Grup sumber daya Azure