Ekinlikler
17 Mar 23 - 21 Mar 23
Diğer geliştiriciler ve uzmanlarla gerçek dünyadaki kullanım örneklerini temel alan ölçeklenebilir yapay zeka çözümleri oluşturmak için toplantı serisine katılın.
Hemen kaydolunBu tarayıcı artık desteklenmiyor.
En son özelliklerden, güvenlik güncelleştirmelerinden ve teknik destekten faydalanmak için Microsoft Edge’e yükseltin.
Azure Uygulaması Hizmeti, yüksek oranda ölçeklenebilir bir kendi kendine düzeltme eki uygulamalı web barındırma hizmeti sağlar. Ayrıca App Service, RESTful API'leri için çıkış noktaları arası kaynak paylaşımı (CORS) için yerleşik desteğe sahiptir. Bu öğreticide CORS desteğiyle ASP.NET Core API uygulamasının App Service'e nasıl dağıtılacağı gösterilir. Komut satırı araçlarını kullanarak uygulamayı yapılandırır ve Git kullanarak dağıtırsınız.
Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:
Bu öğreticiyi macOS, Linux veya Windows'da tamamlayabilirsiniz.
Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
Bu adımda, yerel ASP.NET Core projesini ayarlarsınız. App Service API'ler için diğer dillerde yazılmış aynı iş akışını destekler.
Terminal penceresinde, bir çalışma dizinine gitmek için kullanın cd
.
Örnek depoyu kopyalayın ve ardından depo köküne gidin.
git clone https://github.com/Azure-Samples/dotnet-core-api
cd dotnet-core-api
Bu depo, Swagger / OpenAPI ile Core web API'si belgeleri ASP.NET öğreticisi temelinde oluşturulmuş bir uygulama içerir. Swagger kullanıcı arabirimine ve Swagger JSON uç notasına hizmet vermek için bir Swagger oluşturucusu kullanır.
Varsayılan dalın olduğundan main
emin olun.
git branch -m main
İpucu
Dal adı değişikliği App Service tarafından gerekli değildir. Ancak, birçok depo varsayılan dalını main
olarak değiştirdiğinden (bkz . Dağıtım dalını değiştirme), bu öğreticide bir deponun 'den main
nasıl dağıtılacağı gösterilir.
Gerekli paketleri yüklemek, veritabanı geçişlerini çalıştırmak ve uygulamayı başlatmak için aşağıdaki komutları çalıştırın.
dotnet restore
dotnet run
Swagger kullanıcı arabirimini http://localhost:5000/swagger
denemek için tarayıcıda adresine gidin.
http://localhost:5000/api/todo
ToDo JSON öğelerinin listesini görmek için adresine gidin.
Tarayıcı uygulamasına http://localhost:5000
gidin ve bu uygulamayla denemeler yapın. Daha sonra, CORS işlevselliğini test etmek için tarayıcı uygulamasını App Service'te uzak bir API'ye işaret edersiniz. Tarayıcı uygulamasının kodu deponun wwwroot dizininde bulunabilir.
ASP.NET Core'u istediğiniz zaman durdurmak için terminalde Ctrl+C tuşlarına basın.
Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı olan Azure Cloud Shell'i barındırıyor. Azure hizmetleriyle çalışmak için Cloud Shell ile Bash veya PowerShell kullanabilirsiniz. Yerel ortamınıza herhangi bir şey yüklemek zorunda kalmadan bu makaledeki kodu çalıştırmak için Cloud Shell önceden yüklenmiş komutlarını kullanabilirsiniz.
Azure Cloud Shell'i başlatmak için:
Seçenek | Örnek/Bağlantı |
---|---|
Kodun veya komut bloğunun sağ üst köşesindeki Deneyin'i seçin. Deneyin seçildiğinde kod veya komut otomatik olarak Cloud Shell'e kopyalanmaz. | ![]() |
https://shell.azure.comadresine gidin veya Cloud Shell'i tarayıcınızda açmak için Cloud Shell'i Başlat düğmesini seçin. | ![]() |
Azure portalının sağ üst kısmındaki menü çubuğunda Cloud Shell düğmesini seçin. | ![]() |
Azure Cloud Shell'i kullanmak için:
Cloud Shell'i başlatın.
Kodu veya komutu kopyalamak için kod bloğundaki (veya komut bloğundaki) Kopyala düğmesini seçin.
Windows ve Linux'ta Ctrl+Shift V'yi seçerek veya macOS üzerinde Cmd+Shift++V'yi seçerek kodu veya komutu Cloud Shell oturumuna yapıştırın.
Kodu veya komutu çalıştırmak için Enter'ı seçin.
Bu adımda,.NET Core uygulamanızı App Service'e dağıtacaksınız.
FTP ve yerel Git, dağıtım kullanıcısını kullanarak azure web uygulamasına dağıtabilir. Dağıtım kullanıcınızı yapılandırdıktan sonra, bunu tüm Azure dağıtımlarınız için kullanabilirsiniz. Hesap düzeyinde dağıtım kullanıcı adınız ve parolanız Azure aboneliği kimlik bilgilerinizden farklıdır.
Dağıtım kullanıcısını yapılandırmak için Azure Cloud Shell'de az webapp deployment user set komutunu çalıştırın. Kullanıcı adını> ve <parolayı> dağıtım kullanıcı adı ve parolasıyla değiştirin<.
az webapp deployment user set --user-name <username> --password <password>
JSON çıktısı parolayı olarak null
gösterir. 'Conflict'. Details: 409
hatası alırsanız kullanıcı adını değiştirin. 'Bad Request'. Details: 400
hatası alırsanız daha güçlü bir parola kullanın.
Web uygulamalarınızı dağıtmak için kullanmak üzere kullanıcı adınızı ve parolanızı kaydedin.
Kaynak grubu, web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği mantıksal bir kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.
Cloud Shell içinde az group create
komutuyla bir kaynak grubu oluşturun. Aşağıdaki örnek Batı Avrupa konumunda myResourceGroup adlı bir kaynak grubu oluşturur. Ücretsiz katmanda App Service için desteklenen tüm konumları görüntülemek için az appservice list-locations --sku FREE
komutunu çalıştırın.
az group create --name myResourceGroup --location "West Europe"
Genellikle kaynak grubunuzu ve kaynakları kendinize yakın bir bölgede oluşturursunuz.
Komut tamamlandığında, bir JSON çıkışı size kaynak grubu özelliklerini gösterir.
Cloud Shell’de, az appservice plan create
komutuyla bir App Service planı oluşturun.
Aşağıdaki örnekte, Ücretsiz fiyatlandırma katmanı kullanılarak myAppServicePlan
adlı bir App Service planı oluşturulmaktadır:
az appservice plan create --name myAppServicePlan --resource-group myResourceGroup --sku FREE
App Service planı oluşturulduğunda Azure CLI, aşağıdaki örneğe benzer bilgiler gösterir:
{ "adminSiteName": null, "appServicePlanName": "myAppServicePlan", "geoRegion": "West Europe", "hostingEnvironmentProfile": null, "id": "/subscriptions/0000-0000/resourceGroups/myResourceGroup/providers/Microsoft.Web/serverfarms/myAppServicePlan", "kind": "app", "location": "West Europe", "maximumNumberOfWorkers": 1, "name": "myAppServicePlan", < JSON data removed for brevity. > "targetWorkerSizeId": 0, "type": "Microsoft.Web/serverfarms", "workerTierName": null }
myAppServicePlan
App Service planında bir web uygulaması oluşturun.
Cloud Shell'de, az webapp create
komutunu kullanabilirsiniz. Aşağıdaki örnekte <app-name>
kısmını genel olarak benzersiz bir uygulama adıyla değiştirin (geçerli karakterler a-z
, 0-9
ve -
şeklindedir).
az webapp create --resource-group myResourceGroup --plan myAppServicePlan --name <app-name> --deployment-local-git
Web uygulaması oluşturulduğunda Azure CLI aşağıda yer alan çıktıdaki gibi bilgiler gösterir:
Local git is configured with url of 'https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git' { "availabilityState": "Normal", "clientAffinityEnabled": true, "clientCertEnabled": false, "clientCertExclusionPaths": null, "cloningInfo": null, "containerSize": 0, "dailyMemoryTimeQuota": 0, "defaultHostName": "<app-name>.azurewebsites.net", "deploymentLocalGitUrl": "https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git", "enabled": true, < JSON data removed for brevity. > }
Not
Git uzak URL’si deploymentLocalGitUrl
özelliği içinde https://<username>@<app-name>.scm.azurewebsites.net/<app-name>.git
biçiminde gösterilir. Bu URL’ye daha sonra ihtiyacınız olacağı için URL’yi kaydedin.
Dalı dağıttığınızdan main
App Service uygulamanız main
için varsayılan dağıtım dalını olarak ayarlamanız gerekir (bkz . Dağıtım dalını değiştirme). Cloud Shell'de, komutuyla az webapp config appsettings set
uygulama ayarını ayarlayınDEPLOYMENT_BRANCH
.
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings DEPLOYMENT_BRANCH='main'
Yerel terminal penceresine dönüp yerel Git deponuza bir Azure uzak deposu ekleyin. deploymentLocalGitUrl-from-create-step değerini, Web uygulaması oluştur'dan kaydettiğiniz Git uzak penceresinin URL'si ile değiştirin<.>
git remote add azure <deploymentLocalGitUrl-from-create-step>
Aşağıdaki komutla uygulamanızı dağıtmak için Azure uzak deposuna gönderin. Git Kimlik Bilgileri Yöneticisi sizden kimlik bilgilerini istediğinizde, Azure portalında oturum açmak için kullandığınız kimlik bilgilerini değil Yerel git dağıtımını yapılandırma bölümünde oluşturduğunuz kimlik bilgilerini girdiğinizden emin olun.
git push azure main
Bu komutun çalıştırılması birkaç dakika sürebilir. Çalıştırıldığında, aşağıdaki örneğe benzer bilgiler görüntüler:
Enumerating objects: 83, done.
Counting objects: 100% (83/83), done.
Delta compression using up to 8 threads
Compressing objects: 100% (78/78), done.
Writing objects: 100% (83/83), 22.15 KiB | 3.69 MiB/s, done.
Total 83 (delta 26), reused 0 (delta 0)
remote: Updating branch 'master'.
remote: Updating submodules.
remote: Preparing deployment for commit id '509236e13d'.
remote: Generating deployment script.
remote: Project file path: .\TodoApi.csproj
remote: Generating deployment script for ASP.NET MSBuild16 App
remote: Generated deployment script files
remote: Running deployment command...
remote: Handling ASP.NET Core Web Application deployment with MSBuild16.
remote: .
remote: .
remote: .
remote: Finished successfully.
remote: Running post deployment command(s)...
remote: Triggering recycle (preview mode disabled).
remote: Deployment successful.
To https://<app_name>.scm.azurewebsites.net/<app_name>.git
* [new branch] master -> master
Tarayıcıda adresine http://<app_name>.azurewebsites.net/swagger
gidin ve Swagger kullanıcı arabirimini görüntüleyin.
Dağıtılan API'nizin swagger.json dosyasını görmek için http://<app_name>.azurewebsites.net/swagger/v1/swagger.json
adresine gidin.
Dağıtılan API'nizin çalıştığını görmek için http://<app_name>.azurewebsites.net/api/todo
adresine gidin.
Ardından, API'niz için App Service'te yerleşik CORS desteğini etkinleştirirsiniz.
Yerel deponuzda wwwroot/index.html dosyasını açın.
51. satırda apiEndpoint
değişkeni dağıtılan API'nizin (http://<app_name>.azurewebsites.net
) URL'sine ayarlayın. appname değerini App Service'teki uygulama adınız ile değiştirin<.>
Yerel terminal pencerenizde örnek uygulamayı yeniden çalıştırın.
dotnet run
http://localhost:5000
adresindeki tarayıcı uygulamasına gidin. Tarayıcınızda geliştirici araçları penceresini açın (Windows için Chrome'da Ctrl+Shift+i) ve Konsol sekmesini inceleyin. Şimdi hata iletisini görmeniz gerekir: No 'Access-Control-Allow-Origin' header is present on the requested resource
.
Tarayıcı uygulaması () ile uzak kaynakhttp://<app_name>.azurewebsites.net
(http://localhost:5000
) arasındaki etki alanı uyumsuzluğu tarayıcınız tarafından çıkış noktaları arası kaynak isteği olarak tanınır. Ayrıca, App Service uygulaması üst bilgiyi göndermediğinden Access-Control-Allow-Origin
tarayıcı etki alanları arası içeriğin yüklenmesini engellemiştir.
Üretimde tarayıcı uygulamanızın localhost URL'si yerine genel BIR URL'si olur, ancak CORS'yi localhost URL'sine etkinleştirme işlemi, genel URL'nin işlemiyle aynıdır.
Cloud Shell'de komutunu kullanarak istemcinizin URL'sinde CORS'yi az webapp cors add
etkinleştirin. Uygulama adı> yer tutucusunun <yerine geçin.
az webapp cors add --resource-group myResourceGroup --name <app-name> --allowed-origins 'http://localhost:5000'
komutunu birden çok kez çalıştırarak veya içinde virgülle ayrılmış bir liste --allowed-origins
ekleyerek birden çok izin verilen kaynak ekleyebilirsiniz. Tüm çıkış noktalarına izin vermek için kullanın --allowed-origins '*'
.
http://localhost:5000
adresindeki tarayıcı uygulamasını yenileyin. Konsol penceresindeki hata iletisi artık kaldırılır; dağıtılan API'den verileri görebilir ve etkileşimli çalışabilirsiniz. Uzak API'niz artık yerel olarak çalıştırılan tarayıcı uygulamanıza CORS'yi destekler.
Tebrikler, Azure App Service'te CORS destekli bir API çalıştırıyorsunuz.
Daha fazla esneklik elde etmek için App Service CORS'si yerine kendi CORS yardımcı programlarınızı kullanabilirsiniz. Örneğin, farklı yollar veya yöntemler için farklı izin verilen çıkış noktaları belirtmek isteyebilirsiniz. App Service CORS, tüm API yolları ve yöntemleri için yalnızca bir kabul edilen kaynak kümesi belirtmenize olanak tanır, bu nedenle kendi CORS kodunuzu kullanmak istersiniz. CORS'yi etkinleştirme bölümünde ASP.NET Core'da CORS'nin nasıl etkinleştirildiğini görün.
Yerleşik App Service CORS özelliği, belirttiğiniz her kaynak için yalnızca belirli HTTP yöntemlerine veya fiillerine izin verme seçeneklerine sahip değildir. Tanımlanan her kaynak için tüm yöntemlere ve üst bilgilere otomatik olarak izin verir. Bu davranış, ASP.NET Çekirdek CORS ilkelerine benzer. Bu davranış, seçenekleri .AllowAnyHeader()
ve .AllowAnyMethod()
kodda kullandığınızda kullanılmaktadır.
Not
App Service CORS'si ile kendi CORS kodunuzu birlikte kullanmaya çalışmayın. Bunları birlikte kullanmaya çalışırsanız App Service CORS önceliklidir ve kendi CORS kodunuzun hiçbir etkisi yoktur.
gibi *.contoso.com
bir joker karakter alt etki alanı joker karakter kaynağından *
daha kısıtlayıcıdır. Uygulamanın Azure portalındaki CORS yönetim sayfası, joker karakter alt etki alanını izin verilen kaynak olarak ayarlamanıza izin vermez. Ancak, azure CLI kullanarak bunu yapabilirsiniz, örneğin:
az webapp cors add --resource-group <group-name> --name <app-name> --allowed-origins 'https://*.contoso.com'
Uygulamanız tanımlama bilgileri veya kimlik doğrulama belirteçleri gibi kimlik bilgilerinin gönderilmesini gerektiriyorsa, tarayıcı yanıtta ACCESS-CONTROL-ALLOW-CREDENTIALS
üst bilgi gerektirebilir. App Service'te bunu etkinleştirmek için olarak true
ayarlayınproperties.cors.supportCredentials
:
az resource update --name web --resource-group <group-name> \
--namespace Microsoft.Web --resource-type config \
--parent sites/<app-name> --set properties.cors.supportCredentials=true
İzin verilen kaynaklar joker karakter kaynağını '*'
içerdiğinde bu işleme izin verilmez. ve AllowCredentials
belirtilmesi AllowAnyOrigin
güvenli değildir. Bunun yapılması siteler arası istek sahteciliğiyle sonuçlanabilir. Kimlik bilgilerine izin vermek için joker karakter kaynağını joker karakter alt etki alanlarıyla değiştirmeyi deneyin.
Ö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.
Öğrendikleriniz:
Kullanıcıların kimliğini doğrulamayı ve yetkilendirmeyi öğrenmek için sonraki öğreticiye gidin.
Ekinlikler
17 Mar 23 - 21 Mar 23
Diğer geliştiriciler ve uzmanlarla gerçek dünyadaki kullanım örneklerini temel alan ölçeklenebilir yapay zeka çözümleri oluşturmak için toplantı serisine katılın.
Hemen kaydolunEğitim
Modül
Azure Static Web Apps ile .NET API ve Blazor WebAssembly uygulamasını yayımlama - Training
Azure Static Web Apps ile .NET API ve Blazor WebAssembly uygulamasını yayımlama
Sertifikasyon
Microsoft Sertifikalı: Azure Geliştirici İş Ortağı - Certifications
Azure İşlevleri oluşturmak, web uygulamalarını uygulamak ve yönetmek, Azure depolamayı kullanan çözümler geliştirmek ve daha fazlasını yapmak için Microsoft Azure'da uçtan uca çözümler oluşturun.