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.

Penting

ASP.NET Rilis pratinjau Core dengan Azure App Service

ASP.NET Rilis pratinjau Core tidak disebarkan 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.

Prasyarat

Membuat proyek ASP.Net Core MVC

  1. Buka terminal 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.

Catatan

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 tidak berfungsi di Linux. Lihat dokumentasi distribusi Linux Anda untuk mempercayai sertifikat.

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

      Security warning dialog

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

      Lihat Mempercayai sertifikat pengembangan HTTPS Inti ASP.NET untuk informasi selengkapnya.

    Untuk informasi tentang mempercayai browser Firefox, lihat Kesalahan sertifikat Firefox SEC_ERROR_INADEQUATE_KEY_USAGE.

  3. Jalankan perintah berikut:

    dotnet run
    

    Perintah sebelumnya:

    • KestrelMulai , ASP.NET server web bawaan 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 dalam 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.

    Publish folder structure

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 sudah ada untuk diterbitkan, 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) dapat diterima 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.

    Deployment succeeded message

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

    New Web App successfully deployed

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 berikutnya

Sumber Daya Tambahan: