API Management örnekleriniz için hizmet güncelleştirme ayarlarını yapılandırma

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

Bu makalede, API Management örneğinizde hizmet güncelleştirme ayarlarını (önizleme) yapılandırma gösterilmektedir. Azure aşamalı dağıtım yaklaşımını kullanarak hizmet güncelleştirmelerini API Management örneklerine düzenli aralıklarla otomatik olarak uygular. Bu güncelleştirmeler arasında yeni özellikler, güvenlik geliştirmeleri ve güvenilirlik geliştirmeleri bulunur.

Azure her API Management örneğini ne zaman güncelleştirdiğini tam olarak denetleyemezsiniz, ancak belirli hizmet katmanlarında, güncelleştirmeleri genellikle güncelleştirme dağıtımı sırasında olduğundan daha erken veya daha erken alması için örneğiniz için bir update grubu seçebilirsiniz. Ayrıca, gün içinde örneğinizin güncelleştirmeleri almasını istediğiniz bir bakım penceresi de yapılandırabilirsiniz.

Grubu güncelleştirme

Güncelleştirme grubu ( yayın kanalı olarak da adlandırılır), üretim dağıtımı sırasında API Management hizmet güncelleştirmelerini alan ve tamamlanması birkaç günden birkaç haftaya kadar sürebilen bir dizi örnektir.

Grubu güncelleştirme	Description
AI Gateway Erken (GenAI yayın kanalı)	Diğer güncelleştirme gruplarına ulaşmadan önce en son yapay zeka ağ geçidi özelliklerine ve güncelleştirmelerine erken erişim elde eder. En kararlı ana hat hizmet güncelleştirmelerini yapay zekaya özgü en yeni özelliklerle birleştirir. Diğer hizmet güncelleştirmelerini Geç güncelleştirme grubunun bir parçası olarak alır ve yapay zekayla ilgili özelliklerin daha hızlı dağıtılmasını sağlar.
Erken	Yeni özelliklere test ve erken erişim için güncelleştirmeleri dağıtımın erken aşamalarında alır. Bu seçenek üretim dağıtımları için önerilmez.
Varsayılan	Güncelleştirmeleri normal sürüm dağıtımının bir parçası olarak alır. Bu seçenek, üretim dağıtımları dahil olmak üzere çoğu hizmet için önerilir. Geliştirici katmanında kullanılamaz.
Geç	Güncelleştirmeleri önceki gruplardan daha sonra( genellikle ilk piyasaya çıktıktan haftalar sonra) alır. Bu seçenek yalnızca görev açısından kritik dağıtımlar için önerilir. Geliştirici katmanında kullanılamaz.

Uyarı

• Azure, safe dağıtım uygulamaları (SDP) çerçevesi kullanarak tüm güncelleştirmeleri dağıtır. Bir dağıtımın başlarında yayımlanan güncelleştirmeler daha az kararlı olabilir ve daha sonra kararlı sürümlerle değiştirilebilir. Tüm örnekler sonunda en kararlı sürümlere güncellenir.
• Tüm güncelleştirme grupları önizlemedeki özellikleri içerebilir. Önizleme özellikleri, Azure portalında ve belgelerinde açıkça belirtilmiştir.
• Özellikler bu dizideki güncelleştirme gruplarına yayılır: AI Gateway Erken (yalnızca yapay zeka özellikleri) → Erken → Varsayılan → Geç.

Örneğin, Erken güncelleştirme grubuna bir test örneği eklemek isteyebilirsiniz. Bu örnek, Varsayılan veya Geç güncelleştirme grubuna eklediğiniz üretim örneklerinizden önce güncelleştirmeleri alır. Test örneğini, üretim örneklerinize ulaşmadan önce güncelleştirmelerin neden olduğu sorunları izleyebilirsiniz. API Management ile kanarya dağıtımları hakkında daha fazla bilgi edinin

Bakım süresi

Bakım penceresi, örneğinizin güncelleştirmeleri almasını istediğiniz günde 8 saatlik bir dönemdir. Varsayılan olarak, bakım penceresi örneğin saat diliminde 22:00 ile 06:00 arasındadır.

Güncelleştirme sırasında hizmet kesintileri nadir görülür, ancak düşük hizmet kullanım sürelerini seçerek riski azaltmak isteyebilirsiniz. Örneğin, üretim örnekleri için hafta içi akşamları ve hafta sonu sabahları bir bakım penceresi ayarlayın.

Hizmet güncelleştirme ayarlarını yapılandırma

1. Azure portalında oturum açın ve API Management örneğinize gidin.
2. Sol menüde Dağıtım + altyapı>Hizmeti güncelleştirme ayarları'nı seçin.
3. Güncelleştir grubu'nun altında geçerli ayarı gözden geçirin ve düzenlemek için Düzenle'yi seçin.
4. Bakım penceresi altında geçerli ayarları gözden geçirin ve düzenlemek için Düzenle'yi seçin. Her gün için varsayılan pencereyi, farklı bir standart pencereyi veya güne göre özel bir pencere seçebilirsiniz.

Örneklerinizin güncelleştirmeleri ne zaman aldığını öğrenme

Beklenen veya devam eden hizmet güncelleştirmeleri hakkında şu şekilde bilgi edinebilirsiniz.

• API Management güncelleştirmeleri API Management GitHub deposunda duyurulur. Güncelleştirme dağıtımlarının ne zaman başlayacağını öğrenmek için bu depodan bildirim almak için abone olun.

• API Management örneğinizde gerçekleşen hizmet güncelleştirmelerini izlemek için Azure Activity günlüğünü kullanın. Bir güncelleme başladığında "Zamanlanmış bakım" olayı tetiklenir.

  

  Bildirimleri otomatik olarak almak için Etkinlik günlüğünde bir uyarı ayarlayın .

• Varsayılan olarak, güncelleştirmeler şu aşamalarda bölgelere dağıtılır: Önce Azure EUAP bölgeleri, ardından Orta Batı ABD ve son olarak birkaç sonraki aşamada kalan diğer bölgeler. Sonraki dağıtım aşamalarında güncelleştirilen bölgelerin sırası hizmetten hizmete farklılık gösterir. Üretim dağıtımının her aşaması arasında en az 24 saat bekleyebilirsiniz.

• Bir bölgede, Premium katmanındaki API Management örnekleri güncelleştirmeleri diğer hizmet katmanlarından birkaç saat sonra alır.

Tavsiye

API Management örneğiniz birden çok konuma (bölgeye) dağıtılırsa, güncelleştirmelerin zamanlaması örneğin Birincil konumuna göre belirlenir.

Kanarya dağıtım stratejileri

Belirli bir güncelleştirme grubuna atanan (bu seçenek varsa) veya belirli bir Azure bölgesinde konumlanmış bir API Management örneğini, güncellemeleri üretim örneklerinden daha önce alan bir kanarya dağıtımı olarak kullanabilirsiniz.

• Erken güncelleştirme grubuna örnek ekleme - Bir üretim dağıtımının erken aşamalarında güncelleştirmeleri doğrulamak için Erken güncelleştirme grubundaki bir API Management örneğini kullanın. Bu örnek etkili bir şekilde kanarya dağıtımınızdır.

• Kanarya bölgesine dağıtım yapın - Azure EUAP bölgesine erişiminiz varsa, güncellemeleri üretim hattına çıktıklarında doğrulamak için orada bir örnek kullanın. Azure bölge erişim isteği işlemi hakkında bilgi edinin.

  Uyarı

  EUAP bölgelerindeki kapasite kısıtlamaları nedeniyle API Management örneklerini gerektiği gibi ölçeklendiremeyebilirsiniz.

• Pilot bölgede dağıtma - Üretim ortamınızın benzetimini yapmak için Orta Batı ABD'deki bir örneği kullanın veya kritik olmayan API trafiği için üretimde kullanın. Bu bölge EUAP bölgelerinden sonra güncelleştirmeleri alırken, bir dağıtımın hizmet yapılandırmanıza özgü regresyonları belirleme olasılığı daha yüksektir.

• Bir bölgede yinelenen örnekleri dağıtma - Üretim iş yükünüz belirli bir bölgedeki premium katman örneğiyse, benzer şekilde yapılandırılmış bir örneği daha önce güncelleştirmeleri alan daha düşük bir katmana dağıtmayı göz önünde bulundurun. Örneğin, güncelleştirmeleri doğrulamak için Geliştirici katmanında bir üretim öncesi örneği yapılandırın.

İlgili içerik

• API Management örneğinizi nasıl izleyeceğinizi öğrenin.
• API Management örneğinizi gözlemlemek için diğer seçenekler hakkında bilgi edinin.