Aracılığıyla paylaş

Sanal ağa eklenmiş olmayan bir API Management örneğini stv2 işlem platformuna geçirme

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Standart | Premium

Bu makalede, örnek bir dış veya iç sanal ağa eklenmediğinde (dağıtılmadığında) işlem platformunda stv1stv2 barındırılan bir API Management örneğini platforma geçirme adımları sağlanır. Bu senaryo için Azure portalını veya Stv2 REST API'sine geçir'i kullanarak örneğinizi geçirin. Bunu yapmanız gerekip gerekmediğini öğrenin.

Platformda barındırılan bir VNnet eklenmiş API Management'ı geçirmeniz gerekiyorsa bkz. Sanal ağ eklenmiş API Management örneğini stv2 platformuna geçirme.stv1

Önemli

Platformda barındırılan stv1 API Management örnekleri desteği 31 Ağustos 2024'e kadar kullanımdan kaldırılacaktır. Platformda barındırılan stv1 örnekleriniz varsa, hizmet kesintilerini önlemek için stv2 bu tarihten önce bunları platforma geçirin. Daha fazla bilgi edinin.

Dikkat

  • API Management örneğinizi yeni altyapıya geçirmek uzun süre çalışan bir işlemdir.
  • Geçiş işleminize bağlı olarak, geçiş sırasında geçici kapalı kalma süreniz olabilir ve geçiş sonrasında API Management örneğine ulaşmak için ağ bağımlılıklarınızı güncelleştirmeniz gerekebilir. Geçişinizi uygun şekilde planlayın.
  • 'a stv2 geçiş geri alınamaz.

Geçiş sırasında ne olur?

api management platform geçişi stv1stv2 , temel alınan işlemi tek başına güncelleştirmeyi içerir ve depolama katmanında kalıcı olan hizmet/API yapılandırması üzerinde hiçbir etkisi yoktur. Sanal ağda dağıtılmayan bir örnek için:

  • Örneğin VIP adresinin değişip değişmeyeceğini veya özgün VIP adresinin korunup korunmayacağını seçebilirsiniz.
  • Yükseltme işlemi, eski işleme paralel olarak yeni bir işlem oluşturmayı içerir.
  • Portaldaki API Management durumu Güncelleştirme olacaktır.
  • VIP adresini korumayı seçerseniz geçiş, VIP'yi eski işlemden API'lerin yanıt vermediği yeni işlem işlemine taşımaya yönelik ek bir adım içerir.
  • Azure, yönetim uç noktası DNS'sini yönetir ve başarılı geçişte yeni işlem için güncelleştirilir.
  • Varsayılan ağ geçidi ve portal DNS'i yeni işlemle hemen ilgilidir.
  • API Management örneğinizin yeni bir VIP adresi almasını seçerseniz, yeni VIP adresini kullanmak için ağ bağımlılıklarını güncelleştirmeniz gerekir.

Önkoşullar

  • Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Örneği stv2 platformuna geçirme

API Management'ın sanal IP adresinin değişip değişmeyeceğini veya özgün VIP adresinin korunup korunmayacağını seçebilirsiniz.

  • Yeni sanal IP adresi - Bu modu seçerseniz, GEÇIŞ sırasında API istekleri yanıt vermeye devam eder. Altyapı yapılandırması (özel etki alanları, konumlar ve CA sertifikaları gibi) 30 dakika boyunca kilitlenir. Geçiş sonrasında, yeni VIP adresini kullanmak için DNS, güvenlik duvarı kuralları ve sanal ağlar dahil olmak üzere tüm ağ bağımlılıklarını güncelleştirmeniz gerekir.

  • IP adresini koru - VIP adresini korursanız, IP adresi yeni altyapıya geçirilirken API istekleri yaklaşık 15 dakika boyunca yanıt vermez. Altyapı yapılandırması (özel etki alanları, konumlar ve CA sertifikaları gibi) 45 dakika boyunca kilitlenir. Geçiş sonrasında başka yapılandırma gerekmez.

  1. Azure portalında API Management örneğine gidin.

  2. Soldaki menüde, Ayarlar altında Platform geçişi'ni seçin.

  3. Platform geçişi sayfasında iki geçiş seçeneğinden birini seçin:

    • Yeni sanal IP adresi. API Management örneğinizin VIP adresi otomatik olarak değişir. Hizmetinizde kapalı kalma süresi olmaz, ancak geçiş sonrasında YENI VIP adresini kullanmak için DNS, güvenlik duvarı kuralları ve sanal ağlar dahil olmak üzere tüm ağ bağımlılıklarını güncelleştirmeniz gerekir.

    • IP adresini koru - API Management örneğinizin VIP adresi değişmez. Örneğinizde 15 dakikaya kadar kapalı kalma süresi olacaktır.

      Portalda API Management platformu geçişinin ekran görüntüsü.

  4. Geçiş işlemi için kılavuzu gözden geçirin ve ortamınızı hazırlayın.

  5. Hazırlık adımlarını tamamladıktan sonra Geçiş işleminin etkisini okudum ve anladım'ı seçin. Geçir'i seçin.

Geçişi doğrulama

Geçişin başarılı olduğunu doğrulamak için durum Çevrimiçi olarak değiştiğinde API Management örneğinizin platform sürümünü denetleyin. Geçiş başarılı olduktan sonra değeri veya stv2.1şeklindedirstv2.

Geçiş başarısız olursa otomatik olarak geri dön

Geçiş işlemi sırasında bir hata oluşursa örnek otomatik olarak platforma stv1 geri döner. Geçiş başarıyla tamamlanırsa (örneğin platform sürümü veya stv2.1 olarak ve durumu Çevrimiçi olarak stv2gösterilir), platforma stv1 geri dönemezsiniz.

Geçiş başarısız olursa yardım için Azure desteği başvurun.

El ile geri alma özelliğine ihtiyacınız varsa, özgün API Management örneğinizle yan yana yeni stv2 bir örnek dağıtmanız önerilir.

Ağ bağımlılıklarını güncelleştirme

Yeni bir VIP adresine başarılı bir şekilde geçiş yaptıktan sonra, DNS, güvenlik duvarı kuralları ve sanal ağlar gibi tüm ağ bağımlılıklarını yeni VIP adresini kullanacak şekilde güncelleştirin.

Yardım ve destek 

Hizmetlerinizde en az kesintiyle platforma stv2 geçmenize yardımcı olmak için buradayız.

Sorularınız varsa Microsoft Soru-Cevap'taki topluluk uzmanlarından hızlı yanıtlar alın. Destek planınız varsa ve teknik yardım almak istiyorsanız destek isteği oluşturun.

  1. Özet için sorununuzun açıklamasını yazın; örneğin, "stv1 kullanımdan kaldırma".
  2. Sorun türü'nin altında Teknik'i seçin.
  3. Abonelik bölümünde aboneliğinizi seçin.
  4. Hizmet'in altında Hizmetlerim'i ve ardından API Management Hizmeti'ne tıklayın.
  5. Kaynak'ın altında, destek isteği oluşturmakta olduğunuz Azure kaynağını seçin.
  6. Sorun türü için Yönetici istrasyon ve Yönetim'i seçin.
  7. Sorun alt türü için Yükselt, Ölçek veya SKU Değişiklikleri'ne tıklayın.

Sık sorulan sorular

  • Geçiş yolu seçmek için hangi bilgilere ihtiyacımız var?

    • API Management örneğinin ağ modu nedir?
    • Özel etki alanları yapılandırıldı mı?
    • Güvenlik duvarı söz konusu mu?
    • İlgili IP'lerde yukarı/aşağı akış tarafından alınan bilinen bağımlılıklar var mı?
    • Çok bölgeli bir dağıtım mı?
    • Mevcut örneği değiştirebilir miyiz yoksa paralel kurulum gerekli mi?
    • Kapalı kalma süresi olabilir mi?
    • Geçiş, iş dışı saatlerde yapılabilir mi?

  • Geçiş için önkoşullar nelerdir?

    Sanal ağa eklenmemiş örnekler için önkoşul gerekmez. Genel IP adresinizi koruyarak geçirirseniz, bu işlem API Management örneğinizin yaklaşık 15 dakika boyunca yanıt vermemeye başlamasına neden olur. API Management'ı yeni bir IP'de kullanılabilir hale getiren Yeni sanal IP adresi seçeneğini belirlerseniz kapalı kalma süresi olmayabilir. A kaydı kullanılarak özel bir etki alanıyla yapılandırılan ve/veya genel sanal IP adresinde ağ bağımlılıklarına sahip olan örnekler, yeni bir sanal IP adresi istendiğinde kapalı kalma süresine sahip olur.

  • Geçiş kapalı kalma süresine neden olacak mı?

    Sanal ağa eklenmemiş örnekler için, yalnızca özgün IP adresini korumayı seçerseniz yaklaşık 15 dakikalık bir kapalı kalma süresi vardır. Ancak, yeni bir IP adresiyle geçiş yaparsanız ve yeni IP'de ağ bağımlılıklarınız yoksa kapalı kalma süresi yoktur. Ağ bağımlılıkları CNAME içermeyen özel etki alanı adını, IP izin verme listesini, güvenlik duvarı kurallarını ve sanal ağları içerir.

  • Veri veya yapılandırma kayıpları geçiş sırasında gerçekleşebilir mi?

    stv1 geçiş işlemi stv2 yalnızca işlem platformunun güncelleştirilmesini içerir ve iç depolama katmanı değiştirilmez. Bu nedenle, geçiş işlemi sırasında tüm yapılandırmalar güvenlidir. Bu, sistem tarafından atanan yönetilen kimliği içerir ve bu kimlik etkinleştirilirse korunur.

  • Geçişin tamamlandığını ve başarılı olduğunu nasıl onaylayabilirim?

    Genel bakış sayfasındaki durum Veya olan platform sürümüyle stv2stv2.1birlikte Çevrimiçi olarak okunduğunda geçişin tamamlanmış ve başarılı olduğu kabul edilir. Ayrıca, ağ dikey penceresindeki ağ durumunun gerekli tüm bağlantılar için yeşil görüntülendiğini doğrulayın.

  • Geçişi portalı kullanarak yapabilir miyim?

    Evet, Azure portalındaki Platform geçişi dikey penceresi, sanal ağa eklenmemiş örnekler için geçişte yol gösterir.

  • Örneğin IP adresini koruyabilir miyim?

    Evet, IP adresi korunabilir, ancak yaklaşık 15 dakikalık bir kapalı kalma süresi olacaktır.

  • Mevcut örneği değiştirmeden bir geçiş yolu var mı?

    Evet, yan yana geçiş yapmanız gerekir. Bu, geçerli örneğiniz ile paralel olarak yeni bir API Management örneği oluşturacağınız ve yapılandırmayı yeni örneğe kopyaladığınız anlamına gelir.

  • Geçiş başarısız olursa ne olur?

    API Management örneğiniz, geçişi başlattıktan sonra platform sürümünü veya stv2.1 durumunu Çevrimiçi olarak stv2göstermiyorsa, büyük olasılıkla başarısız olmuştur. Hizmetiniz otomatik olarak eski örneğe geri alınır ve hiçbir değişiklik yapılmaz. Sorun yaşıyorsanız (örneğin, durum 2 saatten fazla güncelleştiriliyorsa), Azure desteği ile iletişime geçin.

  • Geçiş sırasında hangi işlevler kullanılamaz?

    Sanal ağa eklenmemiş örnekler için:

    • Özgün IP adresini korumayı tercih ettiyseniz: IP adresi yeni altyapıya geçirilirken API istekleri yaklaşık 15 dakika boyunca yanıt vermiyordur. Altyapı yapılandırması (özel etki alanları, konumlar ve CA sertifikaları gibi) 45 dakika boyunca kilitlenir.
    • Yeni bir IP adresine geçmeyi tercih ettiyseniz: API istekleri geçiş sırasında yanıt vermeye devam eder. Altyapı yapılandırması (özel etki alanları, konumlar ve CA sertifikaları gibi) 30 dakika boyunca kilitlenir. Geçiş sonrasında, yeni VIP adresini kullanmak için DNS, güvenlik duvarı kuralları ve sanal ağlar dahil olmak üzere tüm ağ bağımlılıklarını güncelleştirmeniz gerekir.

  • Geçiş ne kadar sürer?

    Geçişin tamamı için beklenen süre yaklaşık 45 dakikadır. Geçişin zaten gerçekleştirilip gerçekleştirilmediğini denetleme göstergesi, Örneğinizin Durumunun Güncelleştiriliyor değil Çevrimiçi olup olmadığını denetlemektir. 2 saatten uzun süre güncelleştiriliyor yazıyorsa Azure desteği ile iletişime geçin.

  • Gerekirse geçişi geri alabilir miyim?

    Geçiş işlemi sırasında bir hata oluşursa örnek otomatik olarak platforma stv1 geri döner. Ancak hizmet başarıyla geçirildikten sonra platforma stv1 geri dönemezsiniz.

  • Özel etki alanlarında/özel DNS bölgelerinde herhangi bir değişiklik gerekli mi?

    Sanal ağ eklememiş örnekler için, IP korunursa hiçbir değişiklik gerekmez. Yeni bir IP tercih edilirse, IP'ye başvuran özel etki alanları güncelleştirilmelidir.

  • Stv1 örneğim birden çok Azure bölgesine (çok bölgeli) dağıtıldı. stv2'ye yükseltme Nasıl yaparım??

    Sanal ağa eklenmeyen bir API Management için portalı veya Azure CLI'yı kullanarak geçiş adımlarını izleyin. Tüm bölgeler öğesine stv2geçirilecektir.

  • Şirket içinde barındırılan ağ geçitleri için neleri dikkate almalıyız?

    Şirket içinde barındırılan ağ geçitlerinizde herhangi bir işlem yapmanız gerekmez. Yalnızca Azure'da çalışan ve platformun kullanımdan kaldırılmasından etkilenen stv1 API Management örneklerini geçirmeniz yeterlidir. API Management örneğinin Yapılandırma uç noktası için yeni bir IP olabileceğini ve IP'ye sabitlenen ağ kısıtlamalarının güncelleştirilmesi gerektiğini unutmayın.

  • Geliştirici portalı geçiş işlemini nasıl etkiler?

    Geliştirici portalı üzerinde herhangi bir etkisi yoktur. Özel etki alanları kullanılıyorsa, DNS kaydı geçiş sonrasında geçerli IP ile güncelleştirilmelidir. Ancak, varsayılan etki alanları kullanımdaysa, başarılı geçişte otomatik olarak güncelleştirilir. Geçiş sırasında geliştirici portalı için kapalı kalma süresi yoktur.

  • Stv2'ye geçiş yaptıktan sonra maliyet üzerinde herhangi bir etki var mı?

    Faturalama modeli için stv2 aynı kalır ve geçiş sırasında ve sonrasında daha fazla maliyet oluşmaz.

  • stv1'in stv2 geçişi için hangi RBAC izinleri gereklidir?

    Geçiş işleminin kullanıcı/işlem için API Management örneğine yazma erişimi gerekir.

Video

İlgili içerik