Anlık Görüntüler
Anlık görüntü, Uygulama Yapılandırması deposunun anahtar değerlerinin adlandırılmış, sabit bir alt kümesidir. Anlık görüntüyü oluşturan anahtar-değerler, anahtar ve etiket filtreleri kullanımı aracılığıyla oluşturma sırasında seçilir. Anlık görüntü oluşturulduktan sonra içindeki anahtar-değerlerin değişmeden kalacağı garanti edilir.
Bu videoda anlık görüntülerin size yardımcı olmasının üç nedeni vurgulanan kısa bir genel bakış sunulmaktadır.
Anlık görüntülerle güvenli bir şekilde dağıtma
Anlık görüntüler, yapılandırma değişikliklerini güvenli bir şekilde dağıtmak için tasarlanmıştır. Hatalı yapılandırma değişikliklerini çalışan bir ortama dağıtmak hizmet kesintisi ve veri kaybı gibi sorunlara neden olabilir. Bu tür sorunlardan kaçınmak için üretim ortamlarına geçmeden önce yapılandırma değişikliklerini izleyebilmek önemlidir. Böyle bir sorun oluşursa, hizmeti geri yüklemek için tüm hatalı yapılandırma değişikliklerini geri alabilmek önemlidir. Bu senaryoları yönetmek için anlık görüntüler oluşturulur.
Yapılandırma değişiklikleri denetimli ve tutarlı bir şekilde dağıtılmalıdır. Geliştiriciler, denetimli dağıtım gerçekleştirmek için anlık görüntüleri kullanabilir. Denetimli bir dağıtımı başlatmak için uygulamada gereken tek değişiklik, uygulamanın başvurduğu anlık görüntünün adını güncelleştirmektir. Uygulama üretim aşamasına geçtikçe, başvurulan anlık görüntüdeki yapılandırmanın değişmeden kalması garanti edilir. Anlık görüntüdeki herhangi bir değişikliğe karşı bu garanti, üretime giden beklenmeyen ayarlara karşı koruma sağlar. Anlık görüntülerin değişmezliği ve başvuru kolaylığı, doğru yapılandırma değişiklikleri kümesinin güvenli bir şekilde dağıtılmasını sağlamayı kolaylaştırır.
Anlık görüntüleri kullanma senaryoları
Denetimli dağıtım: Anlık görüntüler, sabit doğası nedeniyle denetimli dağıtımı desteklemek için uygundur. Geliştiriciler yapılandırma için anlık görüntüler kullandığında, sürüm dağıtımın farklı aşamalarında ilerlerken yapılandırmanın değişmeden kaldığından emin olabilirler.
Bilinen Son İyi (LKG) yapılandırma: Anlık görüntüler, Yapılandırma için güvenli dağıtım uygulamalarını desteklemek için kullanılabilir. Anlık görüntülerle geliştiriciler, dağıtım sırasında herhangi bir sorun olduğunda geri almak için bilinen Son İyi (LKG) yapılandırmasının kullanılabilir olmasını sağlayabilir.
Yapılandırma sürümü oluşturma: Anlık görüntüler, sürüm sürümleriyle eşitlenecek yapılandırma ayarlarının sürüm geçmişini oluşturmak için kullanılabilir. Her anlık görüntüde yakalanan Ayarlar, sürümler arasındaki değişiklikleri tanımlamak için karşılaştırılabilir.
Denetim: Anlık görüntüler denetim ve uyumluluk amacıyla kullanılabilir. Geliştiriciler, yayınlar için anlık görüntüleri kullanarak sürümler arasındaki yapılandırma değişikliklerinin kaydını tutabilirsiniz.
Test ve Hazırlama ortamları: Tutarlı test ve hazırlama ortamları oluşturmak için anlık görüntüler kullanılabilir. Geliştiriciler, hata ayıklamaya ve teste yardımcı olabilecek aynı anlık görüntüyü kullanarak farklı ortamlarda aynı yapılandırmanın kullanılmasını sağlayabilir.
Basitleştirilmiş İstemci Yapılandırması bileşimi: genellikle, Uygulama Yapılandırması istemcileri Uygulama Yapılandırması örneğindeki anahtar değerlerinin bir alt kümesine ihtiyaç duyar. Gerekli anahtar-değer kümesini almak için kodda yazılmış sorgu mantığına sahip olmaları gerekir. Anlık görüntüler oluşturma sırasında filtre sağlamayı desteklediğinden, istemciler artık ihtiyaç duydukları anahtar-değer kümesine ada göre başvurabildiğinden istemci oluşturma işlemini basitleştirmeye yardımcı olur.
Anlık görüntü işlemleri
Anlık görüntüler sabit varlıklar olduğundan, anlık görüntüler yalnızca oluşturulabilir ve arşivlenebilir. Silme, temizleme veya düzenleme mümkün değildir.
Anlık görüntü oluşturma: Uygulama Yapılandırması örnekten gerekli anahtar değerlerini yakalamak için anahtar ve etiket filtreleri tanımlanarak anlık görüntüler oluşturulabilir. Filtrelenen anahtar-değerleri oluşturma sırasında sağlanan adla anlık görüntü olarak depolanır.
Arşiv anlık görüntüsü: Bir anlık görüntüyü arşivleme, bunu arşivlenmiş duruma getirir. Bir anlık görüntü arşivlenmiş olsa da, hala tamamen işlevseldir. Anlık görüntü arşivlendiğinde, anlık görüntünün oluşturulması sırasında yapılandırılan saklama süresine göre bir süre sonu ayarlanır. Anlık görüntü, süre sonu tarihine kadar arşivlenmiş durumda kalırsa, süre sonu geçtiğinde otomatik olarak sistemden kaybolur. Arşivleme, artık kullanılmayan anlık görüntülerin kullanıma alınması için kullanılır.
Anlık görüntüyü kurtarma: Anlık görüntünün kurtarılması, anlık görüntüyü yeniden etkin bir duruma getirir. Bu noktada, anlık görüntü artık yapılandırılan saklama süresine bağlı olarak sona erme süresine tabi değildir. Kurtarma yalnızca arşivlemeden sonraki saklama süresinde mümkündür.
Not
Bekletme süresi yalnızca anlık görüntü oluşturulurken ayarlanabilir. Saklama süresi için varsayılan değer, Standart mağazalar için 30 gün ve Ücretsiz mağazalar için 7 gündür.
Anlık görüntü işlemleri için gereksinimler
Aşağıdaki bölümlerde, Microsoft Entra ID ve HMAC kimlik doğrulaması ile anlık görüntüyle ilgili işlemleri gerçekleştirmek için gereken izinler ayrıntılı olarak verilmiştir.
Anlık görüntü oluşturma
Microsoft Entra kimlik doğrulamasını kullanarak depolarda anlık görüntü oluşturmak için aşağıdaki izinler gereklidir. Uygulama Yapılandırması Veri Sahibi rolü bu izinlere zaten sahiptir.
Microsoft.AppConfiguration/configurationStores/keyvalues/readMicrosoft.AppConfiguration/configurationStores/snapshots/write
HMAC kimlik doğrulamasını kullanarak anlık görüntü oluşturmak için okuma-yazma erişim anahtarı kullanılmalıdır.
Anlık görüntüyü arşivle ve kurtar
Microsoft Entra kimlik doğrulamasını kullanarak bir anlık görüntüyü arşivleyip/veya kurtarmak için aşağıdaki izin gereklidir. Uygulama Yapılandırması Veri Sahibi rolü bu izne zaten sahip.
Microsoft.AppConfiguration/configurationStores/snapshots/archive/action
HMAC kimlik doğrulamasını kullanarak anlık görüntüyü arşivleyip/veya kurtarmak için okuma-yazma erişim anahtarı kullanılmalıdır.
Anlık görüntüleri okuma ve listeleme
Tüm anlık görüntüleri listelemek veya tek bir anlık görüntüdeki tüm anahtar değerlerini ada göre almak için, Microsoft Entra kimlik doğrulamasını kullanan mağazalar için aşağıdaki izin gereklidir. Yerleşik Veri Sahibi ve Veri Okuyucusu rolleri bu izne zaten sahiptir.
Microsoft.AppConfiguration/configurationStores/snapshots/read
HMAC kimlik doğrulaması kullanan depolar için hem "anlık görüntü okuma" işlemi (anlık görüntüden anahtar değerlerini okumak için) hem de "anlık görüntüleri listeleme" işlemi okuma-yazma erişim anahtarları veya salt okunur erişim anahtarları kullanılarak gerçekleştirilebilir.
Faturalamayla ilgili dikkat edilmesi gerekenler ve sınırlar
Uygulama Yapılandırması, Ücretsiz ve Standart olarak iki katmana sahiptir. Her katmandaki anlık görüntü kotaları için aşağıdaki ayrıntıları denetleyin.
Ücretsiz katman: Bu katmanın anlık görüntü depolama kotası 10 MB'tır. Tüm etkin ve arşivlenmiş anlık görüntülerin toplam depolama boyutu 10 MB'tan az olduğu sürece mümkün olduğunca çok anlık görüntü oluşturulabilir.
Standart katman: Bu katmanın anlık görüntü depolama kotası 1 GB'tır. Tüm etkin ve arşivlenmiş anlık görüntülerin toplam depolama boyutu 1 GB'tan az olduğu sürece mümkün olduğunca çok anlık görüntü oluşturulabilir.
Anlık görüntü için boyut üst sınırı 1 MB'tır.