Azure App Service'te Yönetilen Örneği dağıtma (önizleme)

Azure App Service'te Yönetilen Örnek, hizmet olarak platform basitliğini altyapı düzeyinde denetim esnekliğiyle birleştirir. Yönetilen Örnek, plan düzeyinde yalıtım, özelleştirme ve güvenli ağ tümleştirmesi gerektiren uygulamalar için tasarlanmıştır.

Önemli

Yönetilen Örnek önizleme aşamasındadır, belirli bölgelerdeki Windows web uygulamaları için kullanılabilir ve Pv4 ve Pmv4 fiyatlandırma planları ile sınırlıdır. İzleyebileceğiniz daha fazla bölge. Linux ve kapsayıcılar desteklenmez.

Bu hızlı başlangıçta aşağıdaki adımları tamamlaacaksınız:

1. Örnek kaynakları dağıtmak için Azure Geliştirici CLI'sini kullanın.
2. Azure App Service'te Yönetilen Örnek oluşturma (önizleme).
3. Örnek bir uygulama dağıtma.
4. Dağıtımı doğrulayın.

Önkoşullar

• Azure hesabı: Etkin aboneliği olan bir Azure hesabına ihtiyacınız vardır. Henüz bir hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.

• Onaylanan bölgelere erişim: Önizleme sırasında Yönetilen Örnek için bölgeler şunlardır: Doğu Asya, Doğu ABD, Kuzey Avrupa ve Orta Batı ABD. İzleyebileceğiniz daha fazla bölge.

• Yönetilen kimlik

• Hızlı Başlangıç: Azure portalı ile blobları karşıya yükleme, indirme ve listeleme

• Sıkıştırılmış bir .zip dosyasında yapılandırma (yükleme) betikleri (adlı Install.ps1PowerShell betiği)

Örnek kaynakları dağıtma

Azure Geliştirici CLI'sını (AZD) kullanarak bu hızlı başlangıçta gerekli tüm kaynakları hızla dağıtabilirsiniz. Bu hızlı başlangıçta kullanılan AZD şablonu Azure örneklerinden alınmıştı. Azure Cloud Shell'de aşağıdaki komutları çalıştırmanız ve istemleri izlemesi gerekir:

mkdir managed-instance-quickstart
cd managed-instance-quickstart
azd init --template https://github.com/Azure-Samples/managed-instance-azure-app-service-quickstart.git
azd env set AZURE_LOCATION northeurope
azd up

azd up komutu şu eylemleri gerçekleştirir:

1. Kullanıcı tarafından atanan bir yönetilen kimlik oluşturur.
2. Azure Depolama Blobu oluşturur.
3. Yönetilen kimliği depolama kapsayıcısına ve Yönetilen Örnek planına atar.
4. Depolama kapsayıcısı üzerinde Depolama-Blob-Data-Contributor erişimi verir.
5. Eklenen yazı tiplerini ve Install.ps1 scripts.zipsıkıştırır.
6. scripts.zip depolama kapsayıcısına yükleyin.

Uyarı

Örnek kaynaklarla dağıtılan yapılandırma betik paketi (scripts.zip), Microsoft Aptos yazı tipi dosyalarını C:\Windows\Fonts'a kopyalayan öğesini içerir Install.ps1. Daha sonra dağıttığınız örnek uygulama, bu yazı tiplerini kullanarak metni bir görüntüde işler. Bu işlem, bir Yönetilen Örnek yapılandırması (yükleme) betiğinin uygulama kodu çalıştırilmeden önce işletim sistemi düzeyi veya çerçeve bağımlılıklarını nasıl yerleştirebileceğini gösterir.

Aşağıdaki PowerShell kodu, şablonda kullanılan yapılandırma (yükleme) betiğidir.

# Install.ps1 - Copy and register fonts on Managed Instance
Write-Host "Installing custom fonts on Managed Instance..." -ForegroundColor Green

# Copy all TTF and OTF fonts to Windows Fonts folder and register them
Get-ChildItem -Recurse -Include *.ttf, *.otf | ForEach-Object {
    $FontFullName = $_.FullName
    $FontName = $_.BaseName + " (TrueType)"
    $Destination = "$env:windir\Fonts\$($_.Name)"

    Write-Host "Installing font: $($_.Name)"
    Copy-Item $FontFullName -Destination $Destination -Force
    New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts" -Name $FontName -PropertyType String -Value $_.Name -Force | Out-Null
}

Write-Host "Font installation completed." -ForegroundColor Green

öğesinin azd up son çıkışı aşağıdaki örneğe benzer olmalıdır.

=== Deployment Complete ===
Storage Account: stgpjqep6fdlfv6
Container Name: scripts
Managed Identity Client name: id-gpjqep6fdlfv6
Resource Group: rg-managed-instance

, , Storage Account, Container NameManaged Identity Client nameve Resource Group değerleri Script URIdaha sonra kullanılır.

Yönetilen Örnek planı dağıtma

Yönetilen Örnek planı oluşturmak ve buna bir uygulama dağıtmak için şu adımları izleyin:

Azure portalı

1. Azure portalınaoturum açın.
2. + Kaynak oluştur’u seçin.
3. Yönetilen örneği arama
4. Sonuçlarda Web Uygulaması (Yönetilen Örnek için) (önizleme) seçeneğini belirleyin.
5. Oluşturma işlemini başlatmak için Oluştur'u seçin.
6. Temel sekmesinde aşağıdaki ayrıntıları sağlayın.

Proje ayrıntıları

Setting	Değer
Subscription	Azure aboneliğiniz
Kaynak Grubu	rg-managed-instance

Uygulama ayrıntıları

Setting	Değer
İsim	contoso-mi-app
Çalışma zamanı yığını	ASPNET V4.8
Bölge	Size yakın bir bölge

Fiyatlandırma planları

Setting	Değer
Windows Planı	Varsayılan planı kullanın veya yeni oluşturun (örneğin, 'contoso-mi-plan')
Fiyatlandırma planları*	Bir fiyatlandırma planı seçin. Fiyatlandırma planlarında Pv4 veya Pmv4 görünmüyorsa bölge kullanılabilirliğini onaylayın veya daha fazla kota isteyin.

Gelişmiş sekmesinde aşağıdaki ayrıntıları sağlayın.

Yapılandırma (yükleme) betiği

Setting	Değer
Depolama Hesabı	Varsayılan planı kullanın veya yeni oluşturun (örneğin, 'contoso-mi-plan')
Container	Komut dosyaları
Zip dosyası	scripts.zip
Değer	.zip URL'sinin doğru olduğunu doğrulayın
Kimlik	Daha önce oluşturulmuş yönetilen kimliği seçin

1. Gözden Geçir + oluştur’u ve sonra da Oluştur’u seçin.

Bulut Kabuğu

1. Aşağıdaki komut, bir yapılandırma (yükleme) betiği ile Yönetilen Örnek planını oluşturur.

az deployment group create \
  --resource-group "<resource-group-name>" \
  --template-file infra/app-service-plan-managed-instance.json \
  --parameters \
    location="<location>" \
    appServicePlanName="<plan-name>" \
    userAssignedIdentityResourceId="<identity-id>" \
    installScriptSourceUri="<script-URI>" \
    skuName=P1V4 \
    skuCapacity=1

Kaynaklar sağlanırken dağıtım birkaç dakika sürer.

1. Aşağıdaki komut Yönetilen Örnek planında bir web uygulaması oluşturur.

az webapp create \
  --name "<app-name>" \
  --resource-group "<resource-group-name>" \
  --plan "<plan-name>" \
  --runtime "ASPNET:V4.8"

1. Aşağıdaki komut web uygulamasına bir Yönetilen Kimlik atar.

az webapp identity assign \
  --name "<app-name>" \
  --resource-group "<resource-group-name>" \
  --identities "<identity-id>"

Yönetilen Örneğe örnek uygulama dağıtma

Bu adımda Cloud Shell'i kullanarak AZD şablonuna eklenmiş olan örnek bir uygulamayı Yönetilen Örneğe dağıtacaksınız.

• Aşağıdaki komut web uygulamasını Yönetilen Örnek planınıza dağıtır. <app-name> ve <resource-group> öğelerini değerlerinizle güncelleştirin.

az webapp deploy \
  --resource-group "<resource-group-name>" \
  --name "<app-name>" \
  --src-path app.zip \
  --type zip

Uygulamaya göz atın

Oluşturulan uygulamaya göz atmak için Genel Bakış sayfasında varsayılan etki alanını seçin.

.NET uygulaması yönetilen örnek planında çalışıyor. Uygulama C:\Windows\Fonts dizinindeki yazı tiplerini kullanır.

Yönetilen Örnek planını yönetme

Web uygulamanızı yönetmek için Azure portalına gidin ve App Services arayıp seçin.

Uygulama Hizmetleri sayfasında, web uygulamanızın adını seçin.

Genel Bakış sayfasında App Service planınızın adını seçin. Geçerli App Service planı'nın altında plan adını seçin.

Ayarlar'ın altındaki sol menüde Yapılandırma'yı seçerek yapılandırma ayrıntılarını görüntüleyin.

Kaynakları temizle

Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. Gelecekte bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız, kaynak grubunu silerek onları silebilirsiniz.

Azure portalı

1. Azure portalındaki web uygulamanızın Genel Bakış sayfasından, Kaynak grubu altında yer alan myResourceGroup bağlantısını seçin.
2. Kaynak grubu sayfasında, listelenen kaynakların silmek istediğiniz kaynaklar olduğundan emin olun.
3. "Kaynak grubunu sil'i seçin, metin kutusuna myResourceGroup'u yazın ve ardından Sil'i seçin."
4. Sil'i seçerek yeniden onaylayın.

Bulut Kabuğu

az group delete

İlgili içerik

• Yönetilen Örneği Yapılandırma
• App Service’e genel bakış
• App Service'te güvenlik
• App Service Ortamı karşılaştırması