Mulai cepat: Menerapkan aplikasi web ASP.NET

  • Artikel

Dalam mulai cepat ini, Anda mempelajari cara membuat dan menyebarkan aplikasi web ASP.NET pertama Anda ke Azure App Service. App Service mendukung berbagai versi aplikasi .NET, dan menyediakan layanan hosting web yang sangat dapat diskalakan dan melakukan patch sendiri. Aplikasi web ASP.NET bersifat lintas platform dan dapat dihosting di Linux atau Windows. Setelah selesai, Anda memiliki grup sumber daya Azure yang terdiri dari paket hosting App Service dan App Service dengan aplikasi web yang disebarkan.

Atau, Anda dapat menyebarkan aplikasi web ASP.NET sebagai bagian dari kontainer Windows atau Linux di App Service.

Prasyarat

Jika Anda telah menginstal Visual Studio 2022:

  1. Pasang pembaruan terbaru di Visual Studio dengan memilih Bantuan>Periksa Pembaruan.
  2. Tambahkan beban kerja dengan memilih Alat>Dapatkan Alat dan Fitur.

1. Membuat aplikasi web ASP.NET

  1. Buka Visual Studio, lalu pilih Buat proyek baru.

  2. Di Buat proyek baru, cari, dan pilih ASP.NET Core Web App, lalu pilih Berikutnya.

  3. Di Konfigurasikan proyek baru Anda, beri nama aplikasi MyFirstAzureWebApp, lalu pilih Berikutnya.

    Cuplikan layar Visual Studio - Mengonfigurasi aplikasi web ASP.NET 7.0.

  4. Pilih .NET 7.0 (Dukungan istilah standar).

  5. Pastikan Jenis Autentikasi diatur ke Tidak Ada. Pilih Buat.

    Cuplikan layar Visual Studio - Info tambahan saat memilih .NET 7.0.

  6. Di menu Visual Studio, pilih Debug>Mulai Tanpa Menelusuri Kesalahan untuk menjalankan aplikasi web secara lokal. Jika Anda melihat pesan yang meminta Anda untuk mempercayai sertifikat yang ditandatangani sendiri, pilih Ya.

    Cuplikan layar Visual Studio - ASP.NET Core 7.0 berjalan secara lokal.

  1. Buka jendela terminal pada komputer Anda ke direktori kerja. Buat aplikasi web .NET baru menggunakan perintah dotnet new webapp, lalu ubah direktori ke aplikasi yang baru dibuat.

    dotnet new webapp -n MyFirstAzureWebApp --framework net7.0
cd MyFirstAzureWebApp

  2. Dari sesi terminal yang sama, jalankan aplikasi secara lokal menggunakan perintah dotnet run.

    dotnet run --urls=https://localhost:5001/

  3. Buka browser web, dan navigasi ke aplikasi di https://localhost:5001.

    Anda melihat templat ASP.NET aplikasi web Core 7.0 ditampilkan di halaman.

    Cuplikan layar Visual Studio Code - ASP.NET Core 7.0 di browser lokal.

Dalam langkah ini, Anda membuat fork proyek demo untuk disebarkan.

  1. Buka aplikasi sampel .NET 7.0.
  2. Pilih tombol Fork di sisi kanan atas di halaman GitHub.
  3. Pilih Pemilik dan biarkan Nama repositori default.
  4. Pilih Buat fork.

2. Terbitkan aplikasi web Anda

Untuk memublikasikan aplikasi web, Anda harus terlebih dahulu membuat dan mengonfigurasi App Service baru tempat Anda dapat mempublikasikan aplikasi Anda.

Sebagai bagian dari menyiapkan App Service, Anda membuat:

  • Grup sumber daya baru untuk memuat semua sumber daya Azure untuk layanan ini.
  • Paket Hosting baru yang menentukan lokasi, ukuran, dan fitur farm server web yang menghosting aplikasi Anda.

Ikuti langkah-langkah berikut untuk membuat App Service dan menerbitkan aplikasi web Anda:

  1. Di Penjelajah Solusi, klik kanan proyek MyFirstAzureWebApp dan pilih Terbitkan.

  2. Di Terbitkan, pilih Azure, lalu klik Berikutnya.

    Cuplikan layar Visual Studio - Terbitkan aplikasi web dan jadikan Azure sebagai target.

  3. Pilih Target tertentu, baik Azure App Service (Linux) atau Azure App Service (Windows) . Kemudian, pilih Berikutnya.

    Penting

    Saat menargetkan ASP.NET Framework 4.8, gunakan Azure App Service (Windows) .

  4. Opsi Anda bergantung pada apakah Anda sudah masuk ke Azure dan apakah Anda memiliki akun Visual Studio yang ditautkan ke akun Azure. Pilih Tambahkan akun atau Masuk untuk masuk ke langganan Azure Anda. Jika Anda sudah masuk, pilih akun yang Anda inginkan.

    Cuplikan layar Visual Studio - Pilih dialog masuk ke Azure.

  5. Di sebelah kanan instans App Service, pilih + .

    Cuplikan layar Visual Studio - Dialog aplikasi Azure App Service Baru.

  6. Untuk Langganan, terima langganan yang tercantum atau pilih langganan baru dari daftar gulir.

  7. Untuk Grup sumber daya, pilih Baru. Di Nama grup sumber daya baru, masukkan myResourceGroup dan pilih Oke.

  8. Untuk Paket Hosting, pilih Baru.

  9. Di dialog Paket Hosting: Buat baru, masukkan nilai yang ditentukan dalam tabel berikut ini:

    Pengaturan Nilai yang disarankan Deskripsi
    Paket Hosting MyFirstAzureWebAppPlan Nama paket App Service.
    Lokasi Eropa Barat Pusat data tempat aplikasi web dihosting.
    Ukuran Gratis Tingkat harga yang menentukan fitur hosting.

  10. Di Nama, masukkan nama aplikasi unik yang hanya menyertakan karakter yang valid yaitu a-z, A-Z, 0-9, dan -. Anda dapat menerima nama unik yang dihasilkan secara otomatis. URL aplikasi web adalah http://<app-name>.azurewebsites.net, dengan <app-name> merupakan nama aplikasi Anda.

  11. Pilih Buat untuk membuat sumber daya Azure.

    Cuplikan layar Visual Studio - Buat dialog sumber daya aplikasi.

    Setelah wizard selesai, sumber daya Azure dibuat untuk Anda, dan Anda siap untuk menerbitkan proyek ASP.NET Core Anda.

  12. Dalam dialog Terbitkan, pastikan aplikasi App Service baru Anda dipilih, lalu pilih Selesai, lalu pilih Tutup. Visual Studio membuat profil publikasi untuk Anda untuk Azure App Service Aplikasi yang dipilih.

  13. Di halaman Terbitkan, pilih Terbitkan. Jika Anda melihat pesan peringatan, pilih Lanjutkan.

    Visual Studio membangun, mengemas, dan menerbitkan aplikasi ke Azure, lalu meluncurkan aplikasi di browser default.

    Anda melihat aplikasi web ASP.NET Core 7.0 ditampilkan di halaman.

    Cuplikan layar Visual Studio - ASP.NET aplikasi web Core 7.0 di Azure.

  1. Di Visual Studio Code, buka Palet Perintah dengan memilih Tampilkan>Palet Perintah.

  2. Cari dan pilih "Azure App Service: Buat Aplikasi Web Baru (Tingkat Lanjut)".

  3. Tanggapi perintah sebagai berikut:

    1. Jika diminta, masuk ke akun Azure Anda.
    2. Pilih Langganan Anda.
    3. Pilih Buat Aplikasi Web baru... Tingkat lanjut.
    4. Untuk Masukkan nama unik global, gunakan nama yang unik di seluruh Azure (karakter yang valid adalah a-z, 0-9, dan - ). Pola yang baik adalah menggunakan kombinasi nama perusahaan dan pengidentifikasi aplikasi Anda.
    5. Pilih Buat grup sumber daya baru dan berikan nama seperti myResourceGroup.
    6. Saat diminta untuk Memilih tumpukan runtime, pilih .NET 7 (STS).
    7. Pilih sistem operasi (Windows atau Linux).
    8. Pilih lokasi di dekat Anda.
    9. Pilih Buat paket App Service baru, beri nama, dan pilih tingkat hargaF1 Gratis.
    10. Pilih Lewati untuk saat ini untuk sumber daya Application Insights.
    11. Saat diminta, klik Sebarkan.
    12. Pilih MyFirstAzureWebApp sebagai folder yang akan digunakan.
    13. Pilih Tambahkan Konfigurasi saat diminta.

  4. Di popup Selalu sebarkan ruang kerja "MyFirstAzureWebApp" ke <app-name>", pilih Ya agar Visual Studio Code disebarkan ke aplikasi App Service yang sama setiap kali Anda berada di ruang kerja itu.

  5. Saat penerbitan selesai, pilih Telusuri Situs Web pada pemberitahuan dan pilih Buka saat diminta.

    Anda melihat aplikasi web ASP.NET Core 7.0 ditampilkan di halaman.

    Cuplikan layar Visual Studio Code - aplikasi web ASP.NET Core 7.0 di Azure.

  1. Masuk ke akun Azure Anda dengan menggunakan az login perintah dan mengikuti prompt:

    az login

  2. Terapkan kode di direktori MyFirstAzureWebApp lokal Anda menggunakan perintah az webapp up:

    az webapp up --sku F1 --name <app-name> --os-type <os>
    • Jika perintah az tidak dikenali, pastikan Anda telah menginstal Azure CLI seperti yang dijelaskan di Prasyarat.
    • Ganti <app-name> dengan nama yang unik di seluruh Azure (<app-name> ). Pola yang baik adalah menggunakan kombinasi nama perusahaan Anda dan pengidentifikasi aplikasi.
    • Argumen --sku F1 membuat aplikasi web pada tingkat hargaGratis. Hapus argumen ini untuk menggunakan tingkat premium yang lebih cepat, yang akan dikenakan biaya per jam.
    • Ganti <os> dengan linux atau windows.
    • Anda dapat secara opsional menyertakan argumen --location <location-name> dengan <location-name> sebagai wilayah Azure yang tersedia. Anda dapat mengambil daftar wilayah yang diizinkan untuk akun Azure Anda dengan menjalankan perintah az account list-locations.

    Perintah mungkin memerlukan waktu beberapa menit untuk diselesaikan. Saat berjalan, perintah menyediakan pesan tentang membuat grup sumber daya, paket App Service, dan aplikasi hosting, mengonfigurasi pengelogan, lalu melakukan penyebaran ZIP. Kemudian akan menampilkan pesan dengan URL aplikasi:

    You can launch the app at http://<app-name>.azurewebsites.net

  3. Buka browser web dan navigasi ke URL:

    Anda melihat aplikasi web ASP.NET Core 7.0 ditampilkan di halaman.

    Cuplikan layar aplikasi web CLI - ASP.NET Core 7.0 di Azure.

Catatan

Azure PowerShell direkomendasikan untuk membuat aplikasi di platform hosting Windows. Untuk membuat aplikasi di Linux, gunakan alat yang berbeda, seperti Azure CLI.

  1. Masuk ke akun Azure Anda dengan menggunakan Connect-AzAccount perintah dan mengikuti prompt:

    Connect-AzAccount

  1. Buat aplikasi fungsi dengan menggunakan perintah New-AzFunctionApp.

    New-AzWebApp -Name <app-name> -Location westeurope
    • Ganti <app-name> dengan nama yang unik di seluruh Azure (karakter yang valid adalah a-z, 0-9, dan - ). Kombinasi nama perusahaan Anda dan pengidentifikasi aplikasi adalah pola yang baik.
    • Anda dapat secara opsional menyertakan argumen -Location <location-name> dengan <location-name> sebagai wilayah Azure yang tersedia. Anda dapat mengambil daftar wilayah yang diizinkan untuk akun Azure Anda dengan menjalankan perintah Get-AzLocation.

    Perintah mungkin memerlukan waktu beberapa menit untuk diselesaikan. Saat berjalan, perintah membuat grup sumber daya, paket App Service, dan sumber daya App Service.

  2. Dari folder root aplikasi, siapkan aplikasi MyFirstAzureWebApp lokal Anda untuk penyebaran menggunakan dotnet publish perintah:

    dotnet publish --configuration Release

  3. Ubah ke direktori rilis dan buat file zip dari konten:

    cd bin\Release\net7.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip

  4. Publikasikan file zip ke aplikasi Azure menggunakan perintah Publish-AzWebApp:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force

    Catatan

    -ArchivePath membutuhkan jalur penuh dari file zip.

  5. Buka browser web dan navigasi ke URL:

    Anda melihat aplikasi web ASP.NET Core 7.0 ditampilkan di halaman.

    Cuplikan layar aplikasi web CLI - ASP.NET Core 7.0 di Azure.

  1. Ketik layanan aplikasi dalam pencarian. Di bagian Layanan, pilih App Services.

    Cuplikan layar kotak pencarian portal Microsoft Azure.

  2. Di halaman App Services, pilih + Buat.

  3. Di tab Dasar:

    • Pada Grup Sumber Daya, pilih Buat baru. Ketik myResourceGroup untuk namanya.
    • Di bagian Nama, ketik nama yang unik secara global untuk aplikasi web Anda.
    • Di bagian Terbitkan, pilih Kode.
    • Di bawah Tumpukan runtime pilih .NET 7 (STS).
    • Pilih Sistem Operasi dan Wilayah tempat aplikasi Anda ingin ditayangkan.
    • Di bawah App Service Paket, pilih Buat baru dan ketik myAppServicePlan untuk nama tersebut.
    • Di bawah Paket harga, pilih F1 Gratis.

    Cuplikan layar konfigurasi aplikasi App Service baru untuk .NET 7 di portal Azure.

  4. Pilih tombol Berikutnya: Penyebaran > di bagian bawah halaman.

  5. Di tab Penyebaran, di bagian Pengaturan GitHub Actions pastikan Penyebaran berkelanjutanAktif.

  6. Di bawah Detail GitHub Actions, autentikasi dengan akun GitHub Anda dan pilih opsi berikut:

    • Untuk Organisasi pilih organisasi tempat Anda telah membuat proyek demo.
    • Untuk Repositori pilih proyek dotnetcore-docs-hello-world.
    • Untuk Cabang pilih master.

    Cuplikan layar opsi penyebaran untuk aplikasi yang menggunakan runtime .NET 6.

  7. Pilih tombol Tinjau + buat di bagian bawah halaman.

  8. Setelah validasi berjalan, pilih tombol Create di bagian bawah halaman.

  9. Setelah penyebaran selesai, pilih Buka sumber daya.

    Cuplikan layar langkah selanjutnya menuju sumber daya.

  10. Lakukan penelusuran ke aplikasi yang disebarkan menggunakan browser web Anda di URL http://<app-name>.azurewebsites.net.

3. Perbarui aplikasi dan sebarkan ulang

Ikuti langkah-langkah berikut untuk memperbarui dan menerapkan ulang aplikasi web Anda:

  1. Di Penjelajah Solusi, di bawah proyek Anda, buka Index.cshtml.

  2. Ganti elemen pertama <div> dengan kode berikut:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    Simpan perubahan Anda.

  3. Untuk menerapkan ulang ke Azure, klik kanan proyek MyFirstAzureWebApp di Penjelajah Solusi dan pilih Terbitkan.

  4. Di halaman ringkasan Terbitkan, pilih Terbitkan.

    Saat penerbitan selesai, Visual Studio akan meluncurkan browser ke URL aplikasi web.

    Anda melihat aplikasi web ASP.NET Core 7.0 yang diperbarui ditampilkan di halaman.

    Cuplikan layar Visual Studio - Aplikasi web ASP.NET Core 7.0 yang diperbarui di Azure.

  1. Buka Index.cshtml.

  2. Ganti elemen pertama <div> dengan kode berikut:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    Simpan perubahan Anda.

  3. Di Visual Studio Code, buka Palet Perintah, Ctrl+Shift+P.

  4. Cari dan pilih "Azure App Service: Terapkan ke Aplikasi Web".

  5. Pilih Terapkan saat diminta.

  6. Saat penerbitan selesai, pilih Telusuri Situs Web pada pemberitahuan dan pilih Buka saat diminta.

    Anda melihat aplikasi web ASP.NET Core 7.0 yang diperbarui ditampilkan di halaman.

    Cuplikan layar Visual Studio Code - Aplikasi web ASP.NET Core 7.0 yang diperbarui di Azure.

Di direktori lokal, buka file Index.cshtml. Ganti elemen pertama <div>:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Simpan perubahan Anda, lalu terapkan ulang aplikasi menggunakan perintah az webapp up lagi:

ASP.NET Core 7.0 bersifat lintas platform, berdasarkan penyebaran Anda sebelumnya, ganti <os> dengan linux atau windows.

az webapp up --os-type <os>

Perintah ini menggunakan nilai yang disimpan cache secara lokal dalam file .azure/config, termasuk nama aplikasi, grup sumber daya, dan paket App Service.

Setelah penyebaran selesai, beralih kembali ke jendela browser yang dibuka di langkah Telusuri aplikasi, dan tekan refresh.

Anda melihat aplikasi web ASP.NET Core 7.0 yang diperbarui ditampilkan di halaman.

Cuplikan layar CLI - Aplikasi web ASP.NET Core 7.0 yang diperbarui di Azure.

  1. Di direktori lokal, buka file Index.cshtml. Ganti elemen pertama <div>:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

  2. Dari folder root aplikasi, siapkan aplikasi MyFirstAzureWebApp lokal Anda untuk penyebaran menggunakan dotnet publish perintah:

    dotnet publish --configuration Release

  3. Ubah ke direktori rilis dan buat file zip dari konten:

    cd bin\Release\net7.0\publish
Compress-Archive -Path * -DestinationPath deploy.zip

  4. Publikasikan file zip ke aplikasi Azure menggunakan perintah Publish-AzWebApp:

    Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force

    Catatan

    -ArchivePath membutuhkan jalur penuh dari file zip.

  5. Setelah penyebaran selesai, beralih kembali ke jendela browser yang dibuka di langkah Telusuri aplikasi, dan tekan refresh.

    Anda melihat aplikasi web ASP.NET Core 7.0 yang diperbarui ditampilkan di halaman.

    Cuplikan layar CLI - Aplikasi web ASP.NET Core 7.0 yang diperbarui di Azure.

  1. Telusuri ke fork GitHub Anda dari kode sampel.

  2. Pada halaman repo Anda, tekan . untuk memulai Visual Studio Code dalam browser Anda.

    Catatan

    URL tersebut akan berubah dari GitHub.com menjadi GitHub.dev. Fitur ini hanya berfungsi dengan repositori yang memiliki file. Ini tidak berfungsi pada repositori yang kosong.

  3. Buka Index.cshtml.

    Index.cshtml terletak di folder Pages.

    Cuplikan layar jendela Explorer dari Visual Studio Code di browser, menyoroti Index.cshtml di repositori dotnetcore-docs-hello-world.

  4. Ganti elemen pertama <div> dengan kode berikut:

    <div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

    Simpan perubahan Anda.

  5. Dari menu Kontrol Sumber, pilih tombol Perubahan Tahapan untuk melakukan perubahan tersebut.

  6. Masukkan pesan penerapan seperti We love Azure. Lalu, pilih Terapkan dan Dorong.

  7. Setelah penyebaran diselesaikan, beralih kembali ke jendela browser yang dibuka di langkah Telusuri aplikasi, dan refresh halaman.

    Anda melihat aplikasi web ASP.NET Core 7.0 yang diperbarui ditampilkan di halaman.

    Cuplikan layar aplikasi web CLI - Diperbarui ASP.NET Core 7.0 di Azure.

4. Mengelola aplikasi Azure

Untuk mengelola aplikasi web Anda, buka portal Microsoft Azure, dan cari dan pilih App Services.

Cuplikan layar portal Azure - Pilih opsi App Services.

Pada halaman App Services, pilih nama aplikasi web Anda.

Cuplikan layar portal Azure - Halaman App Services dengan contoh aplikasi web yang dipilih.

Halaman Gambaran Umum untuk aplikasi web Anda, berisi opsi untuk manajemen dasar seperti menelusuri, menghentikan, memulai, memulai ulang, dan menghapus. Menu sebelah kiri menyediakan halaman lebi lanjut untuk mengonfigurasikan aplikasi Anda.

Cuplikan layar portal Azure - Halaman gambaran umum App Service.

Membersihkan sumber daya

Dalam langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak berharap membutuhkan sumber daya ini di masa mendatang, Anda dapat menghapusnya dengan menghapus grup sumber daya.

  1. Dari halaman Gambaran umum aplikasi web di portal Microsoft Azure, pilih tautan myResourceGroup di bawah Grup sumber daya.
  2. Di halaman grup sumber daya, pastikan sumber daya yang tercantum adalah sumber daya yang ingin Anda hapus.
  3. Pilih Hapus, ketik myResourceGroup di kotak teks, lalu pilih Hapus.

Membersihkan sumber daya

Dalam langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak berharap membutuhkan sumber daya ini di masa mendatang, Anda dapat menghapusnya dengan menghapus grup sumber daya.

  1. Dari halaman Gambaran umum aplikasi web di portal Microsoft Azure, pilih tautan myResourceGroup di bawah Grup sumber daya.
  2. Di halaman grup sumber daya, pastikan sumber daya yang tercantum adalah sumber daya yang ingin Anda hapus.
  3. Pilih Hapus, ketik myResourceGroup di kotak teks, lalu pilih Hapus.

Membersihkan sumber daya

Dalam langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak ingin membutuhkan sumber daya ini di masa mendatang, hapus grup sumber daya dengan menjalankan perintah berikut ini di Cloud Shell:

az group delete --name myResourceGroup

Perintah ini mungkin perlu waktu satu menit untuk dijalankan.

Membersihkan sumber daya

Dalam langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak membutuhkan sumber daya ini di masa mendatang, hapus grup sumber daya dengan menjalankan perintah PowerShell berikut:

Remove-AzResourceGroup -Name myResourceGroup

Perintah ini mungkin perlu waktu satu menit untuk dijalankan.

Membersihkan sumber daya

Dalam langkah-langkah sebelumnya, Anda membuat sumber daya Azure dalam grup sumber daya. Jika Anda tidak berharap membutuhkan sumber daya ini di masa mendatang, Anda dapat menghapusnya dengan menghapus grup sumber daya.

  1. Dari halaman Gambaran umum aplikasi web di portal Microsoft Azure, pilih tautan myResourceGroup di bawah Grup sumber daya.
  2. Di halaman grup sumber daya, pastikan sumber daya yang tercantum adalah sumber daya yang ingin Anda hapus.
  3. Pilih Hapus, ketik myResourceGroup di kotak teks, lalu pilih Hapus.

Langkah berikutnya

Lanjutkan ke artikel berikutnya untuk mempelajari cara membuat aplikasi .NET Core dan menghubungkannya ke Microsoft Azure SQL Database:

Tutorial: Aplikasi ASP.NET Core dengan database SQL

Templat Aplikasi: ASP.NET aplikasi Core dengan database SQL dan App Insights yang disebarkan menggunakan Ci/CD GitHub Actions

Mengonfigurasi aplikasi ASP.NET Core