App Service Ortamı v1 ve v2'yi App Service Ortamı v3'e geçirmek için yerinde geçiş özelliğini kullanın

Yerinde geçiş deneyimi için Azure portalını kullanmanızı öneririz. Geçiş için Azure CLI kullanmaya karar verirseniz, Azure REST API çağrıları yaptığınız için burada sırasıyla ve yazıldığı gibi açıklanan adımları izleyin. Bu API çağrılarını yapmak için Azure CLI'yi kullanmanızı öneririz. Diğer yöntemler hakkında daha fazla bilgi için bkz . Azure REST API başvurusu.

Bu kılavuz için Azure CLI'yı yükleyin veya Azure Cloud Shell'i kullanın ve bash kabuğu kullanın.

1. App Service Ortamı kimliğinizi alın

App Service Ortamı kimliğinizi almak ve ortam değişkeni olarak depolamak için aşağıdaki komutları çalıştırın. Ad ve kaynak gruplarının yer tutucularını geçirmek istediğiniz App Service Ortamı değerlerinizle değiştirin. ASE_RGve VNET_RG sanal ağınız ile App Service Ortamı aynı kaynak grubundaysa aynıdır.

ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-ASE-Resource-Group>
VNET_RG=<Your-VNet-Resource-Group>
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)

2. Geçişin desteklendiğini doğrulayın

Aşağıdaki komut, App Service Ortamı geçiş için desteklenip desteklenmediğini denetler. Hata alırsanız veya App Service Ortamı iyi durumda değilse veya askıya alınmış durumdaysa, şu anda geçiş yapamazsınız. Alabileceğiniz olası hata iletilerinin açıklamaları için sorun giderme bölümüne bakın. Ortamınız yerinde geçiş özelliğini kullanarak geçiş için desteklenmiyorsa veya yerinde geçiş özelliğini kullanmadan App Service Ortamı v3'e geçiş yapmak istiyorsanız, el ile geçiş seçeneklerine bakın. Bu komut, App Service Ortamı geçiş için desteklenen derleme sürümünde olduğunu da doğrular. App Service Ortamı desteklenen derleme sürümünde değilse, ortamınızın boyutuna bağlı olarak 8-12 saat veya daha uzun sürebilecek yükseltmeyi kendiniz başlatmanız gerekir. Geçiş öncesi yükseltme hakkında daha fazla bilgi için bkz. App Service Ortamı yerinde geçiş özelliği kullanılarak geçişin desteklendiğini doğrulama.

az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=validation"

Hata yoksa geçişiniz desteklenir ve sonraki adıma devam edebilirsiniz.

App Service Ortamı desteklenen derleme sürümüne yükseltmek için bir yükseltme başlatmanız gerekiyorsa aşağıdaki komutu çalıştırın. Bu komutu yalnızca doğrulama adımında başarısız olmanız ve App Service Ortamı yükseltmeniz istenirse çalıştırın.

az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"

3. Yeni App Service Ortamı v3 kaynağınız için IP adresleri oluşturma

Yeni IP adresleri oluşturmak için aşağıdaki komutu çalıştırın. Bu adımın tamamlanması yaklaşık 15 dakika sürer. Bu süre boyunca mevcut App Service Ortamı ölçeklendirmeyin veya değişiklik yapmayın.

az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=premigration"

Bu adımın durumunu denetlemek için aşağıdaki komutu çalıştırın:

az rest --method get --uri "${ASE_ID}?api-version=2021-02-01" --query properties.status

Adım devam ediyorsa durumunu Migratingalırsınız. durumunu Readyaldıktan sonra, yeni IP'lerinizi görüntülemek için aşağıdaki komutu çalıştırın. Yeni IP'leri hemen görmüyorsanız, birkaç dakika bekleyin ve yeniden deneyin.

az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"

4. Bağımlı kaynakları yeni IP'lerle güncelleştirme

Yeni IP'leri kullanarak, yeni ortamınızın geçiş tamamlandıktan sonra tasarlandığı gibi çalıştığından emin olmak için kaynaklarınızdan veya ağ bileşenlerinizden herhangi birini güncelleştirin. Gerekli güncelleştirmeleri yapmak sizin sorumluluğunuzdadır.

Bu adım, App Service Ortamı v3'e geçerken gelen ve giden ağ bağımlılığı değişikliklerini gözden geçirmek için de uygun bir zamandır. Bu değişiklikler azure load balancer için bağlantı noktası değişikliğini içerir ve bu değişiklik şu anda 80 numaralı bağlantı noktasını kullanır. Bu adımı tamamlayana kadar geçiş yapmayın.

5. App Service Ortamı alt ağınızı temsilci olarak atama

App Service Ortamı v3, içinde olduğu alt ağın tek bir temsilcisine Microsoft.Web/hostingEnvironmentssahip olmasını gerektirir. Önceki sürümler bu temsilciyi gerektirmedi. Geçiş öncesinde alt ağınızın düzgün bir şekilde temsilci seçildiğini onaylamanız ve temsilci seçmeyi (gerekirse) güncelleştirmeniz gerekir. Aşağıdaki komutu çalıştırarak veya Azure portalında alt ağa giderek temsilci seçmeyi güncelleştirebilirsiniz.

az network vnet subnet update --resource-group $VNET_RG --name <subnet-name> --vnet-name <vnet-name> --delegations Microsoft.Web/hostingEnvironments

6. Sanal ağda kilit olmadığını onaylayın

Sanal ağ, geçiş sırasında platform işlemlerini engeller. Sanal ağınızda kilitler varsa, geçiş öncesinde bunları kaldırmanız gerekir. Gerekirse, geçiş tamamlandıktan sonra kilitleri geri ekleyebilirsiniz.

Kilitler üç kapsamda bulunabilir: abonelik, kaynak grubu ve kaynak. Bir üst kapsama kilit uyguladığınızda, bu kapsamdaki tüm kaynaklar aynı kilidi devralır. Abonelik, kaynak grubu veya kaynak kapsamına uygulanan kilitleriniz varsa, geçiş öncesinde bunları kaldırmanız gerekir. Kilitler ve devralmayı kilitleme hakkında daha fazla bilgi için bkz . Altyapınızı korumak için kaynaklarınızı kilitleme.

Sanal ağınızda herhangi bir kilit olup olmadığını denetlemek için aşağıdaki komutu kullanın:

az lock list --resource-group $VNET_RG --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks

Aşağıdaki komutu kullanarak mevcut kilitleri silin:

az lock delete --resource-group $VNET_RG --name <lock-name> --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks

Aboneliğinizin veya kaynak grubunuzun kilitleri olup olmadığını denetlemeye yönelik ilgili komutlar için bkz . Kilitler için Azure CLI başvurusu.

7. Yapılandırmalarınızı hazırlama

Mevcut ortamınız alanlar arası yedekliliği destekleyen bir bölgedeyse yeni App Service Ortamı v3 kaynak bölgenizi yedekli hale getirebilirsiniz. özelliğini trueolarak ayarlayarak zoneRedundant alanlar arası yedekliliği yapılandırabilirsiniz.

Bölge yedekliliği isteğe bağlı bir yapılandırmadır. Bunu yalnızca yeni App Service Ortamı v3 kaynağınızın oluşturulması sırasında ayarlayabilirsiniz. Daha sonra kaldıramazsınız. Daha fazla bilgi için bkz. App Service Ortamı v3 yapılandırmalarınızı seçme. Alanlar arası yedekliliği yapılandırmak istemiyorsanız parametresini eklemeyin zoneRedundant .

Mevcut App Service Ortamı özel bir etki alanı soneki kullanıyorsa, geçiş işlemi sırasında yeni App Service Ortamı v3 kaynağınız için bir tane yapılandırmanız gerekir. Özel bir etki alanı soneki yapılandırmazsanız ve şu anda kullanıyorsanız geçiş başarısız olur. Ayrıca, yapılandırılmamış bir ortama geçiş sırasında özel bir etki alanı soneki eklemeye çalıştığınızda da geçiş başarısız olur. gereksinimler, adım adım yönergeler ve en iyi yöntemler de dahil olmak üzere App Service Ortamı v3 özel etki alanı sonekleri hakkında daha fazla bilgi için bkz. App Service Ortamı için özel etki alanı son eki.

Geçişiniz özel bir etki alanı son eki içermiyorsa ve alanlar arası yedekliliği etkinleştirmiyorsanız geçişe geçebilirsiniz.

Bu yapılandırmaları ayarlamak için senaryonuza göre aşağıdaki ayrıntıları içeren parameters.json adlı bir dosya oluşturun. Bu özellik geçişiniz için geçerli değilse özel etki alanı son ekinin özelliklerini eklemeyin. Geçiş sonrasında bu yapılandırma geri alınamaz olduğundan özelliğin zoneRedundant değerine dikkat edin. Özelliğin kind değerini mevcut App Service Ortamı sürümünüz temelinde ayarlayın. özelliği için kind kabul edilen değerler ve ASEV2şeklindedirASEV1.

Özel bir etki alanı soneki olmadan geçiş gerçekleştiriyorsanız ve bölge yedekliliğini etkinleştiriyorsanız şu kodu kullanın:

{
    "type": "Microsoft.Web/hostingEnvironments",
    "name": "sample-ase-migration",
    "kind": "ASEV2",
    "location": "westcentralus",
    "properties": {
        "zoneRedundant": true
    }
}

Özel etki alanı soneki yapılandırmanız için kullanıcı tarafından atanan yönetilen kimlik kullanıyorsanız ve alanlar arası yedekliliği etkinleştiriyorsanız şu kodu kullanın:

{
    "type": "Microsoft.Web/hostingEnvironments",
    "name": "sample-ase-migration",
    "kind": "ASEV2",
    "location": "westcentralus",
    "properties": {
        "zoneRedundant": true,
        "customDnsSuffixConfiguration": {
            "dnsSuffix": "internal.contoso.com",
            "certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
            "keyVaultReferenceIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/asev3-migration/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ase-managed-identity"
        }
    }
}

Özel etki alanı soneki yapılandırmanız için sistem tarafından atanan yönetilen kimlik kullanıyorsanız ve alanlar arası yedekliliği etkinleştirmiyorsanız şu kodu kullanın:

{
    "type": "Microsoft.Web/hostingEnvironments",
    "name": "sample-ase-migration",
    "kind": "ASEV2",
    "location": "westcentralus",
    "properties": {
        "customDnsSuffixConfiguration": {
            "dnsSuffix": "internal.contoso.com",
            "certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
            "keyVaultReferenceIdentity": "SystemAssigned"
        }
    }
}

8. App Service Ortamı v3'e geçiş ve durumu denetleme

Önceki adımların tümünü tamamladıktan sonra geçişi başlatabilirsiniz. Geçişin etkilerini anladığınızdan emin olun.

Bu adım, v2 ile v3 geçişleri için üç-altı saat ve ortam boyutuna bağlı olarak v1'in v3 geçişleri için altı saate kadar sürer. Bu süre boyunca yaklaşık bir saatlik uygulama kapalı kalma süresi vardır. Bu adım sırasında mevcut App Service Ortamı ölçeklendirme, dağıtımlar ve değişiklikler engellenir.

body Bölge yedekliliğini etkinleştiriyorsanız ve/veya özel bir etki alanı sonekini yapılandırıyorsanız parametresini aşağıdaki komutta ekleyin. Bu yapılandırmalardan hiçbiri geçişiniz için geçerli değilse parametresini komutundan kaldırabilirsiniz.

az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=fullmigration" --body @parameters.json

Geçişinizin ayrıntılı durumunu denetlemek için aşağıdaki komutları çalıştırın. Durumlarla ilgili bilgi için bkz . geçiş durumu açıklamaları.

İlk komut, geçişin işlem kimliğini alır. özelliğinin ID değerini kopyalayın.

az rest --method get --uri "${ASE_ID}/operations?api-version=2022-03-01"

Aşağıdaki komuttaki işlem kimliği için yer tutucusunu kopyaladığınız değerle değiştirin. Bu komut, geçişinizin ayrıntılı durumunu döndürür. En son durumu almak için bu komutu gerektiği sıklıkta çalıştırabilirsiniz.

az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"

durumunu Readyaldıktan sonra geçiş yapılır ve App Service Ortamı v3 kaynağınız olur. Uygulamalarınız artık yeni ortamınızda çalışıyor.

Aşağıdaki komutu çalıştırarak veya Azure portalına giderek yeni ortamınızın ayrıntılarını alın.

az appservice ase show --name $ASE_NAME --resource-group $ASE_RG

1. Geçişin desteklendiğini doğrulayın

Azure portalında, geçiş yaptığınız App Service Ortamı için Geçiş sayfasına gidin. App Service Ortamı genel bakış sayfasının üst kısmındaki başlığı seçerek veya soldaki menüden Geçiş öğesini seçerek Geçiş sayfasına ulaşabilirsiniz.

Geçiş sayfasında platform, geçişin App Service Ortamı için desteklenip desteklenmediğini doğrular. Doğrula'yı seçin ve doğrulamaya devam etmek istediğinizi onaylayın. Doğrulama işlemi birkaç saniye sürer.

Ortamınız geçiş için desteklenmiyorsa, sayfanın üst kısmında bir başlık görünür ve nedeni olan bir hata iletisi içerir. Geçiş için uygun değilseniz görüntülenebilen hata iletilerinin açıklamaları için bkz . Sorun giderme.

App Service Ortamı şu anda geçiş için desteklenmiyorsa veya ortamınız iyi durumda değilse veya askıya alınmış durumdaysa, geçiş özelliğini kullanamazsınız. Ortamınız yerinde geçiş özelliğiyle geçiş için desteklenmiyorsa veya yerinde geçiş özelliğini kullanmadan App Service Ortamı v3'e geçiş yapmak istiyorsanız, el ile geçiş seçeneklerine bakın.

App Service Ortamı desteklenen derleme sürümüne yükseltmek için bir yükseltme başlatmanız gerekiyorsa, ortamınızın boyutuna bağlı olarak 8-12 saat veya daha uzun sürebilecek yükseltmeyi başlatmanız istenir. Yükseltmeyi başlatmak için Yükselt'i seçin. Yükseltme tamamlandığında doğrulamayı geçersiniz ve geçiş işleminizi başlatmak için geçiş özelliğini kullanabilirsiniz.

geçiş App Service Ortamı için destekleniyorsa işlemin sonraki adımına geçin. Geçiş sayfası, geçişi tamamlamak için bir dizi adımda size yol gösterir.

2. Yeni App Service Ortamı v3 kaynağınız için IP adresleri oluşturma

Yeni IP adresleri al'ın altında etkilerini anladığınızdan emin olun ve Başlat düğmesini seçin. Bu adımın tamamlanması yaklaşık 15 dakika sürer. Bu süre boyunca mevcut App Service Ortamı ölçeklendiremez veya değişiklik yapamazsınız.

3. Bağımlı kaynakları yeni IP'lerle güncelleştirme

Önceki adım tamamlandığında, yeni App Service Ortamı v3 kaynağınızın IP adresleri görüntülenir. Yeni IP'leri kullanarak tüm kaynakları ve ağ bileşenlerini güncelleştirerek yeni ortamınızın geçiş tamamlandıktan sonra tasarlandığı gibi çalışabilmesini sağlayın. Gerekli güncelleştirmeleri yapmak sizin sorumluluğunuzdadır.

Bu adım, App Service Ortamı v3'e geçişte gelen ve giden ağ bağımlılığı değişikliklerini gözden geçirmek için de uygun bir zamandır. Bu değişiklikler azure load balancer için bağlantı noktası değişikliğini içerir ve bu değişiklik şu anda 80 numaralı bağlantı noktasını kullanır. Bu güncelleştirmeleri yaptığınız onaylanana kadar sonraki adıma geçmeyin.

4. App Service Ortamı alt ağınızı temsilci olarak atama

App Service Ortamı v3, içinde olduğu alt ağın tek bir temsilcisine Microsoft.Web/hostingEnvironmentssahip olmasını gerektirir. Önceki sürümler bu temsilciyi gerektirmedi. Geçiş öncesinde alt ağınızın düzgün bir şekilde temsilci seçildiğini onaylamanız ve temsilci seçmeyi (gerekirse) güncelleştirmeniz gerekir. Portal, gerektiğinde onaylayıp güncelleştirebilmeniz için alt ağınıza bir bağlantı görüntüler.

5. Örnek boyutu değişikliklerini kabul edin

App Service planlarınız Yalıtılmış'dan karşılık gelen Yalıtılmış v2 katmanına dönüştürülür. Örneğin, I2 I2v2'ye dönüştürülür. Yalıtılmış v2 katmanında ilgili örnek boyutu başına daha fazla bellek ve CPU olduğundan, geçiş sonrasında uygulamalarınız fazla sağlanmış olabilir. Geçiş tamamlandıktan sonra ortamınızı gerektiği gibi ölçeklendirme fırsatına sahipsiniz. Daha fazla bilgi için fiyatlandırma ayrıntılarını gözden geçirin.

6. Sanal ağda kilit olmadığını onaylayın

Sanal ağ, geçiş sırasında platform işlemlerini engeller. Sanal ağınızda kilitler varsa, geçiş öncesinde bunları kaldırmanız gerekir. Gerekirse, geçiş tamamlandıktan sonra kilitleri geri ekleyebilirsiniz.

Kilitler üç kapsamda bulunabilir: abonelik, kaynak grubu ve kaynak. Bir üst kapsama kilit uyguladığınızda, bu kapsamdaki tüm kaynaklar aynı kilidi devralır. Abonelik, kaynak grubu veya kaynak kapsamına uygulanan kilitleriniz varsa, geçiş öncesinde bunları kaldırmanız gerekir. Kilitler ve devralmayı kilitleme hakkında daha fazla bilgi için bkz . Altyapınızı korumak için kaynaklarınızı kilitleme.

Aboneliğinizde veya kaynak grubunuzda kilit olup olmadığını denetleme hakkında ayrıntılı bilgi için bkz . Kilitleri yapılandırma.

7. Yapılandırmalarınızı seçin

Mevcut ortamınız alanlar arası yedekliliği destekleyen bir bölgedeyse yeni App Service Ortamı v3 kaynak bölgenizi yedekli hale getirebilirsiniz. Bölge yedekliliği isteğe bağlı bir yapılandırmadır. Bunu yalnızca yeni App Service Ortamı v3 kaynağınızın oluşturulması sırasında ayarlayabilirsiniz. Daha sonra kaldıramazsınız. Daha fazla bilgi için bkz. App Service Ortamı v3 yapılandırmalarınızı seçme.

Alanlar arası yedekliliği yapılandırmak istiyorsanız Etkin onay kutusunu seçin.

Ortamınız alanlar arası yedekliliği desteklemeyen bir bölgedeyse, onay kutusu kullanılamaz. Alanlar arası yedekli App Service Ortamı v3 kaynağına ihtiyacınız varsa, el ile geçiş seçeneklerinden birini kullanın ve kaynağı alanlar arası yedekliliği destekleyen bölgelerden birinde oluşturun.

Mevcut App Service Ortamı özel bir etki alanı soneki kullanıyorsa, yeni App Service Ortamı v3 kaynağınız için bir tane yapılandırmanız gerekir. Bu durum sizin için geçerliyse, özel bir etki alanı soneki için yapılandırma seçenekleri görüntülenir. Gerekli bilgileri sağlamadan geçiş yapamazsınız.

Özel bir etki alanı soneki kullanmak istiyorsanız ancak şu anda yapılandırılmış bir etki alanınız yoksa, geçiş tamamlandıktan sonra bir tane yapılandırabilirsiniz. gereksinimler, adım adım yönergeler ve en iyi yöntemler de dahil olmak üzere App Service Ortamı v3 özel etki alanı sonekleri hakkında daha fazla bilgi için bkz. App Service Ortamı için özel etki alanı son eki.

Özel etki alanı son ekinizin ayrıntılarını ekledikten sonra Geçir düğmesi kullanılabilir.

8. App Service Ortamı v3'e geçiş

Önceki adımların tümünü tamamladıktan sonra geçişi başlatabilirsiniz. Bu süre boyunca gerçekleşenler de dahil olmak üzere geçişin etkilerini anladığınızdan emin olun.

Bu adım, v2 ile v3 geçişleri için üç-altı saat ve ortam boyutuna bağlı olarak v1'in v3 geçişleri için altı saate kadar sürer. Mevcut App Service Ortamı ölçeklendirme ve değişiklikler bu adım sırasında engellenir.

Şu anda ayrıntılı geçiş durumları yalnızca Azure CLI kullanırken kullanılabilir. Daha fazla bilgi için App Service Ortamı v3'e geçiş için Azure CLI bölümüne bakın. Geçişi yapmak için portalı kullansanız bile CLI ile geçişin durumunu de kontrol edebilirsiniz.

Geçiş tamamlandığında bir App Service Ortamı v3 kaynağınız olur ve tüm uygulamalarınız yeni ortamınızda çalışır. App Service Ortamı yapılandırma sayfasını denetleyerek ortamın sürümünü onaylayabilirsiniz.

Geçişiniz özel bir etki alanı son eki içeriyorsa, etki alanı App Service Ortamı v1/v2 için portalın Genel Bakış sayfasının Temel Parçalar bölümünde görünür, ancak artık App Service Ortamı v3'te görünmez. Bunun yerine, App Service Ortamı v3 için Özel etki alanı soneki sayfasına giderek özel etki alanı sonekinizin doğru yapılandırıldığını onaylayın. Ayrıca, artık ihtiyacınız yoksa yapılandırmayı kaldırabilir veya daha önce yapılandırmadıysanız bir yapılandırma yapabilirsiniz.