Hızlı Başlangıç: ASP.NET web uygulaması dağıtma
Bu hızlı başlangıçta, ilk ASP.NET web uygulamanızı oluşturmayı ve Azure App Service dağıtmayı öğreneceksiniz. App Service, .NET uygulamalarının çeşitli sürümlerini destekler ve yüksek oranda ölçeklenebilir, kendi kendine düzeltme eki uygulamalı bir web barındırma hizmeti sağlar. ASP.NET web uygulamaları platformlar arasıdır ve Linux veya Windows üzerinde barındırılabilir. İşiniz bittiğinde, App Service barındırma planından ve dağıtılan web uygulamasına sahip bir App Service içeren bir Azure kaynak grubunuz olur.
Alternatif olarak, ASP.NET bir web uygulamasını App Service'da Bir Windows veya Linux kapsayıcısının parçası olarak dağıtabilirsiniz.
Ön koşullar
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- Visual Studio 2022 ile ASP.NET ve web geliştirme iş yükü.
Visual Studio 2022'yi zaten yüklediyseniz:
- Güncelleştirmeler için Yardım>Denetimi'ni seçerek Visual Studio'daki en son güncelleştirmeleri yükleyin.
- Araçlar Araçları>ve Özellikleri Al'ı seçerek iş yükünü ekleyin.
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- Visual Studio Code.
- Azure Araçları uzantısı.
- En son .NET 7.0 SDK'sı.
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- Azure CLI.
- En son .NET 7.0 SDK'sı.
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- Azure PowerShell.
- En son .NET 7.0 SDK'sı.
- Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.
- GitHub hesabı Ücretsiz bir hesap oluşturun.
1. ASP.NET web uygulaması oluşturma
Visual Studio'yu açın ve Yeni proje oluştur'u seçin.
Yeni proje oluştur bölümünde Web Uygulaması'ASP.NET Core bulun ve seçin, ardından İleri'yi seçin.
Yeni projenizi yapılandırın bölümünde uygulamaya MyFirstAzureWebApp adını verin ve İleri'yi seçin.
.NET 7.0 (Standart vadeli destek) seçeneğini belirleyin.
Kimlik Doğrulama Türü'ninYok olarak ayarlandığından emin olun. Oluştur’u seçin.
Web uygulamasını yerel olarak çalıştırmak için Visual Studio menüsündeHata Ayıklama Olmadan Başlat'ıseçin>. Otomatik olarak imzalanan bir sertifikaya güvenmenizi isteyen bir ileti görürseniz Evet'i seçin.
Makinenizde çalışan bir dizine yönelik bir terminal penceresi açın. komutunu kullanarak
dotnet new webapp
yeni bir .NET web uygulaması oluşturun ve ardından dizinleri yeni oluşturulan uygulama olarak değiştirin.dotnet new webapp -n MyFirstAzureWebApp --framework net7.0 cd MyFirstAzureWebApp
Aynı terminal oturumundan komutunu kullanarak
dotnet run
uygulamayı yerel olarak çalıştırın.dotnet run --urls=https://localhost:5001/
Bir web tarayıcısı açın ve
https://localhost:5001
konumundaki uygulamaya gidin.Şablon ASP.NET Core 7.0 web uygulamasının sayfada görüntülendiğini görürsünüz.
Bu adımda, dağıtılacak bir tanıtım projesi çatalı oluşturursunuz.
- .NET 7.0 örnek uygulamasına gidin.
- GitHub sayfasının sağ üst kısmındaki Çatal düğmesini seçin.
- Sahip'i seçin ve varsayılan Depo adını bırakın.
- Çatal oluştur'u seçin.
2. Web uygulamanızı yayımlama
Web uygulamanızı yayımlamak için önce uygulamanızı yayımlayabileceğiniz yeni bir App Service oluşturmanız ve yapılandırmanız gerekir.
App Service ayarlamanın bir parçası olarak şunları oluşturursunuz:
- Hizmetin tüm Azure kaynaklarını içeren yeni bir kaynak grubu .
- Uygulamanızı barındıran web sunucusu grubunun konumunu, boyutunu ve özelliklerini belirten yeni bir Barındırma Planı .
App Service kaynaklarınızı oluşturmak ve projenizi yayımlamak için şu adımları izleyin:
Çözüm Gezgini'daMyFirstAzureWebApp projesine sağ tıklayın ve Yayımla'yı seçin.
Yayımla bölümünde Azure'ı ve ardından İleri'yi seçin.
Azure App Service (Linux) veya Azure App Service (Windows) Belirli hedefi seçin. Ardından İleri'yi seçin.
Önemli
ASP.NET Framework 4.8'i hedeflerken Azure App Service (Windows) kullanın.
Seçenekleriniz, Azure'da zaten oturum açıp açmadığınıza ve Azure hesabına bağlı bir Visual Studio hesabınızın olup olmadığına bağlıdır. Azure aboneliğinizde oturum açmak için Hesap ekle veya Oturum aç'ı seçin. Zaten oturum açtıysanız, istediğiniz hesabı seçin.
App Service örneklerin sağındaki öğesini seçin+.
Abonelik için listelenen aboneliği kabul edin veya açılan listeden yeni bir abonelik seçin.
Kaynak grubu için Yeni'yi seçin. Yeni kaynak grubu adı alanına myResourceGroup yazın ve Tamam'ı seçin.
Barındırma Planı için Yeni'yi seçin.
Barındırma Planı: Yeni oluştur iletişim kutusunda, aşağıdaki tabloda belirtilen değerleri girin:
Ayar Önerilen değer Açıklama Barındırma Planı MyFirstAzureWebAppPlan App Service planının adı. Konum West Europe Web uygulamasının barındırıldığı veri merkezi. Boyut Ücretsiz Fiyatlandırma katmanı, barındırma özelliklerini belirler. Ad alanına, yalnızca geçerli karakterleri içeren benzersiz bir uygulama adı girin:
a-z
,A-Z
,0-9
ve-
. Otomatik olarak oluşturulan benzersiz adı kabul edebilirsiniz. Web uygulamasının URL'sihttp://<app-name>.azurewebsites.net
şeklindedir; burada<app-name>
, uygulamanızın adıdır.Azure kaynaklarını oluşturmak için Oluştur'u seçin.
Sihirbaz tamamlandıktan sonra azure kaynakları sizin için oluşturulur ve ASP.NET Core projenizi yayımlamaya hazırsınız demektir.
Yayımla iletişim kutusunda yeni App Service uygulamanızın seçili olduğundan emin olun, ardından Son'u ve ardından Kapat'ı seçin. Visual Studio, seçilen App Service uygulaması için sizin için bir yayımlama profili oluşturur.
Yayımla sayfasında Yayımla'yı seçin. Bir uyarı iletisi görürseniz Devam'ı seçin.
Visual Studio uygulamayı oluşturur, paketler ve Azure'da yayımlar ve ardından uygulamayı varsayılan tarayıcıda başlatır.
sayfada ASP.NET Core 7.0 web uygulamasının görüntülendiğini görürsünüz.
Visual Studio Code'da Komut PaletiniGörüntüle'yi> seçerekKomut Paleti'ni açın.
"Azure App Service: Yeni Web Uygulaması Oluştur (Gelişmiş)" ifadesini arayın ve seçin.
İstemlere aşağıdaki gibi yanıt verin:
- İstenirse Azure hesabınızda oturum açın.
- Aboneliğinizi seçin.
- Yeni Web Uygulaması oluştur... öğesini seçin. Gelişmiş.
- Genel olarak benzersiz bir ad girin için, tüm Azure'da benzersiz bir ad kullanın (geçerli karakterler ,
0-9
ve-
' dıra-z
). İyi bir desen, şirketinizin adıyla uygulama tanımlayıcısının bir bileşimini kullanmaktır. - Yeni kaynak grubu oluştur'u seçin ve gibi
myResourceGroup
bir ad sağlayın. - Çalışma zamanı yığını seçin sorulduğunda .NET 7 (STS) öğesini seçin.
- Bir işletim sistemi (Windows veya Linux) seçin.
- Size yakın bir konum seçin.
- Yeni App Service planı oluştur'u seçin, bir ad sağlayın ve F1 Ücretsizfiyatlandırma katmanını seçin.
- Application Insights kaynağı için Şimdilik atla'yı seçin.
- İstendiğinde Dağıt'a tıklayın.
- Dağıtılacak klasör olarak MyFirstAzureWebApp öğesini seçin.
- İstendiğinde Yapılandırma Ekle'yi seçin.
"MyFirstAzureWebApp" çalışma alanını her zaman uygulama adına> dağıt" <açılır penceresinde Evet'i seçerek Visual Studio Code bu çalışma alanında her zaman aynı App Service uygulamasına dağıtılır.
Yayımlama tamamlandığında bildirimde Web Sitesine Gözat'ı ve istendiğinde Aç'ı seçin.
sayfada ASP.NET Core 7.0 web uygulamasının görüntülendiğini görürsünüz.
komutunu kullanarak
az login
ve istemi izleyerek Azure hesabınızda oturum açın:az login
Komutunu kullanarak yerel MyFirstAzureWebApp dizininizde kodu dağıtın
az webapp up
:az webapp up --sku F1 --name <app-name> --os-type <os>
- Komut tanınmıyorsa
az
Önkoşullar bölümünde açıklandığı gibi Azure CLI'nin yüklü olduğundan emin olun. - değerini tüm Azure'da benzersiz bir adla değiştirin
<app-name>
(geçerli karakterler ,0-9
ve-
' dıra-z
). İyi bir desen, şirketinizin adıyla uygulama tanımlayıcısının bir bileşimini kullanmaktır. - bağımsız değişkeni,
--sku F1
ücretsizfiyatlandırma katmanında web uygulamasını oluşturur. Saatlik maliyete neden olan daha hızlı bir premium katmanı kullanmak için bu bağımsız değişkeni atlayın. - değerini veya
windows
ilelinux
değiştirin<os>
. - İsteğe bağlı olarak bağımsız değişkeni
--location <location-name>
kullanılabilir bir Azure bölgesi olduğunda<location-name>
ekleyebilirsiniz. komutunu çalıştırarak Azure hesabınız için izin verilebilen bölgelerinaz account list-locations
listesini alabilirsiniz.
Komutun tamamlanması birkaç dakika sürebilir. Komut çalışırken kaynak grubunu, App Service planını ve barındırma uygulamasını oluşturma, günlüğe kaydetmeyi yapılandırma ve ardından ZIP dağıtımı gerçekleştirme hakkında iletiler sağlar. Ardından uygulamanın URL'sini içeren bir ileti gösterilir:
You can launch the app at http://<app-name>.azurewebsites.net
- Komut tanınmıyorsa
Bir web tarayıcısı açın ve URL'ye gidin:
sayfada ASP.NET Core 7.0 web uygulamasının görüntülendiğini görürsünüz.
Not
Azure PowerShell, Windows barındırma platformunda uygulama oluşturmak için önerilir. Linux'ta uygulama oluşturmak için Azure CLI gibi farklı bir araç kullanın.
komutunu kullanarak
Connect-AzAccount
ve istemi izleyerek Azure hesabınızda oturum açın:Connect-AzAccount
New-AzWebApp komutunu kullanarak yeni bir uygulama oluşturun:
New-AzWebApp -Name <app-name> -Location westeurope
- değerini tüm Azure'da benzersiz bir adla değiştirin
<app-name>
(geçerli karakterler ,0-9
ve-
' dıra-z
). Şirketinizin adıyla uygulama tanımlayıcısının birleşimi iyi bir desendir. - İsteğe bağlı olarak parametresini
-Location <location-name>
kullanılabilir bir Azure bölgesi olan yere<location-name>
ekleyebilirsiniz. komutunu çalıştırarak Azure hesabınız için izin verilebilen bölgelerinGet-AzLocation
listesini alabilirsiniz.
Komutun tamamlanması birkaç dakika sürebilir. Komut çalışırken bir kaynak grubu, bir App Service planı ve App Service kaynağı oluşturur.
- değerini tüm Azure'da benzersiz bir adla değiştirin
Uygulama kök klasöründen komutunu kullanarak
dotnet publish
yerel MyFirstAzureWebApp uygulamanızı dağıtım için hazırlayın:dotnet publish --configuration Release
Yayın dizinine geçin ve içindekilerden bir zip dosyası oluşturun:
cd bin\Release\net7.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
Publish-AzWebApp komutunu kullanarak zip dosyasını Azure uygulamasında yayımlayın:
Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
Not
-ArchivePath
zip dosyasının tam yoluna ihtiyaç duyar.Bir web tarayıcısı açın ve URL'ye gidin:
sayfada ASP.NET Core 7.0 web uygulamasının görüntülendiğini görürsünüz.
Aramada uygulama hizmetleri yazın. Hizmetler'in altında Uygulama Hizmetleri'ne tıklayın.
App Services sayfasında + Oluştur'u seçin.
Temel Bilgiler sekmesinde:
- Kaynak grubu'nun altında Yeni oluştur'u seçin. Ad için myResourceGroup yazın.
- Ad'ın altında, web uygulamanız için genel olarak benzersiz bir ad yazın.
- Yayımla'nın altında Kod'a tıklayın.
- Çalışma zamanı yığını altında .NET 7 (STS) öğesini seçin.
- Bir İşletim Sistemi ve uygulamanızın hizmet vermek istediğiniz Bölge'yi seçin.
- plan App Service altında Yeni oluştur'u seçin ve ad olarak myAppServicePlan yazın.
- Fiyatlandırma planı'nın altında Ücretsiz F1'i seçin.
Sayfanın alt kısmındaki Sonraki: Dağıtım > düğmesini seçin.
Dağıtım sekmesinde, GitHub Actions ayarları altında Süreklidağıtım'ın Etkinleştir olduğundan emin olun.
GitHub Actions ayrıntıları altında GitHub hesabınızla kimlik doğrulaması yapın ve aşağıdaki seçenekleri belirleyin:
- Kuruluş için tanıtım projesinin çatalını oluşturduğunuz kuruluşu seçin.
- Depo için dotnetcore-docs-hello-world projesini seçin.
- Dal için master'ı seçin.
Sayfanın alt kısmındaki Gözden geçir ve oluştur düğmesini seçin.
Doğrulama çalıştırıldıktan sonra sayfanın en altındaki Oluştur düğmesini seçin.
Dağıtım tamamlandıktan sonra Kaynağa git'i seçin.
URL'sindeki
http://<app-name>.azurewebsites.net
web tarayıcınızda dağıtılan uygulamaya göz atın.
3. Uygulamayı güncelleştirme ve yeniden dağıtma
Web uygulamanızı güncelleştirmek ve yeniden dağıtmak için şu adımları izleyin:
Çözüm Gezgini'da, projenizin altında Index.cshtml dosyasını açın.
İlk
<div>
öğeyi aşağıdaki kodla değiştirin:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Yaptığınız değişiklikleri kaydedin.
Azure'a yeniden dağıtmak için Çözüm Gezgini'da MyFirstAzureWebApp projesine sağ tıklayın ve Yayımla'yı seçin.
Yayımlama özeti sayfasında Yayımla'yı seçin.
Yayımlama tamamlandığında Visual Studio, web uygulamasının URL’si ile bir tarayıcı başlatır.
Güncelleştirilmiş ASP.NET Core 7.0 web uygulamasının sayfada görüntülendiğini görürsünüz.
Index.cshtml sayfasını açın.
İlk
<div>
öğeyi aşağıdaki kodla değiştirin:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Yaptığınız değişiklikleri kaydedin.
Visual Studio Code'da Komut PaletiCtrl+Shift+P'yi açın.
"Azure App Service: Web Uygulamasına Dağıt"ı arayın ve seçin.
İstendiğinde Dağıt'ı seçin.
Yayımlama tamamlandığında bildirimde Web Sitesine Gözat'ı seçin ve istendiğinde Aç'ı seçin.
Güncelleştirilmiş ASP.NET Core 7.0 web uygulamasının sayfada görüntülendiğini görürsünüz.
Yerel dizinde Index.cshtml dosyasını açın. İlk <div>
öğeyi değiştirin:
<div class="jumbotron">
<h1>.NET 💜 Azure</h1>
<p class="lead">Example .NET app to Azure App Service.</p>
</div>
Değişikliklerinizi kaydedin ve ardından komutunu kullanarak uygulamayı yeniden dağıtın az webapp up
:
ASP.NET Core 7.0, önceki dağıtımınızın veya windows
ile linux
değiştirilmesine <os>
bağlı olarak platformlar arasıdır.
az webapp up --os-type <os>
Bu komut uygulama adı, kaynak grubu ve App Service planı dahil olmak üzere .azure/config dosyasında yerel olarak önbelleğe alınan değerleri kullanır.
Dağıtım tamamlandıktan sonra Uygulamaya göz at adımında açılan tarayıcı penceresine dönüp yenile öğesine dokunun.
Güncelleştirilmiş ASP.NET Core 7.0 web uygulamasının sayfada görüntülendiğini görürsünüz.
Yerel dizinde Index.cshtml dosyasını açın. İlk
<div>
öğeyi değiştirin:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Uygulama kök klasöründen, komutunu kullanarak
dotnet publish
yerel MyFirstAzureWebApp uygulamanızı dağıtım için hazırlayın:dotnet publish --configuration Release
Yayın dizinine geçin ve içindekilerden bir zip dosyası oluşturun:
cd bin\Release\net7.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
Publish-AzWebApp komutunu kullanarak zip dosyasını Azure uygulamasında yayımlayın:
Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
Not
-ArchivePath
zip dosyasının tam yoluna ihtiyaç duyar.Dağıtım tamamlandıktan sonra Uygulamaya göz at adımında açılan tarayıcı penceresine dönüp yenile öğesine dokunun.
Güncelleştirilmiş ASP.NET Core 7.0 web uygulamasının sayfada görüntülendiğini görürsünüz.
Örnek kodun GitHub çatalınıza göz atın.
Depo sayfanızda, tarayıcınızda Visual Studio Code başlatmak için basın
.
.Not
URL, GitHub.com GitHub.dev olarak değişir. Bu özellik yalnızca dosyaları olan depolarla çalışır. Bu, boş depolarda çalışmaz.
Index.cshtml sayfasını açın.
Index.cshtml klasöründe bulunur
Pages
.İlk
<div>
öğeyi aşağıdaki kodla değiştirin:<div class="jumbotron"> <h1>.NET 💜 Azure</h1> <p class="lead">Example .NET app to Azure App Service.</p> </div>
Yaptığınız değişiklikleri kaydedin.
Kaynak Denetimi menüsünde Değişiklikleri Hazırlama düğmesini seçerek değişikliği hazırlarsınız.
gibi
We love Azure
bir işleme iletisi girin. Ardından İşleme ve Gönderme'yi seçin.Dağıtım tamamlandıktan sonra Uygulamaya göz atma adımında açılan tarayıcı penceresine dönüp sayfayı yenileyin.
Güncelleştirilmiş ASP.NET Core 7.0 web uygulamasının sayfada görüntülendiğini görürsünüz.
4. Azure uygulamasını yönetme
Web uygulamanızı yönetmek için Azure portal gidin ve Uygulama Hizmetleri'ni arayın ve seçin.
App Services sayfasında web uygulamanızın adını seçin.
Web uygulamanızın Genel Bakış sayfası göz atma, durdurma, başlatma, yeniden başlatma ve silme gibi temel yönetim seçeneklerini içerir. Soldaki menüde uygulamanızı yapılandırmak için ek sayfalar sağlanır.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.
- Web uygulamanızın Azure portalındaki Genel Bakış sayfasından Kaynak grubu'nun altındaki myResourceGroup bağlantısını seçin.
- Kaynak grubu sayfasındaki listede yer alan kaynakların silmek istediğiniz kaynaklar olduğundan emin olun.
- Sil'i seçin, metin kutusuna myResourceGroup yazın ve ardından Sil'e tıklayın.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.
- Web uygulamanızın Azure portalındaki Genel Bakış sayfasından Kaynak grubu'nun altındaki myResourceGroup bağlantısını seçin.
- Kaynak grubu sayfasındaki listede yer alan kaynakların silmek istediğiniz kaynaklar olduğundan emin olun.
- Sil'i seçin, metin kutusuna myResourceGroup yazın ve ardından Sil'e tıklayın.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. Bu kaynakların gelecekte gerekli olacağını düşünmüyorsanız, Cloud Shell’de aşağıdaki komutu çalıştırarak kaynak grubunu silin:
az group delete --name myResourceGroup
Bu komutun çalıştırılması bir dakika sürebilir.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. Gelecekte bu kaynaklara ihtiyaç duymayabilirsiniz, aşağıdaki PowerShell komutunu çalıştırarak kaynak grubunu silin:
Remove-AzResourceGroup -Name myResourceGroup
Bu komutun çalıştırılması bir dakika sürebilir.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.
- Web uygulamanızın Azure portalındaki Genel Bakış sayfasından Kaynak grubu'nun altındaki myResourceGroup bağlantısını seçin.
- Kaynak grubu sayfasındaki listede yer alan kaynakların silmek istediğiniz kaynaklar olduğundan emin olun.
- Sil'i seçin, metin kutusuna myResourceGroup yazın ve ardından Sil'e tıklayın.
Sonraki adımlar
.NET Core uygulaması oluşturmayı ve bir SQL Veritabanı bağlamayı öğrenmek için sonraki makaleye ilerleyin: