Yapılandırma verilerini içeri veya dışarı aktarma

Azure Uygulama Yapılandırması, veri içeri ve dışarı aktarma işlemlerini destekler. Yapılandırma verileriyle toplu olarak çalışmak ve Uygulama Yapılandırma deponuzla kod projeniz arasında veri alışverişi yapmak için bu işlemleri kullanın. Örneğin, test için bir Uygulama Yapılandırma deposu ve üretim için başka bir uygulama yapılandırma deposu ayarlayabilirsiniz. Verileri iki kez girmeniz gerekmeyecek şekilde bunların arasına uygulama ayarlarını kopyalayabilirsiniz.

Bu makalede, Azure portalı veya Azure CLIkullanarak verileri içeri ve dışarı aktarmaya yönelik bir kılavuz sağlanır. Yapılandırmayı Kod olarak benimsediyseniz ve GitHub veya Azure DevOps'ta yapılandırmalarınızı yönetdiyseniz GitHub Actions kullanarak devam eden yapılandırma dosyası içeri aktarmayı ayarlayabilir veya Azure Pipeline İçeri Aktarma Görevikullanabilirsiniz.

Verileri içeri aktarma

İçeri aktarma, yapılandırma verilerini mevcut bir kaynaktan Uygulama Yapılandırma deposuna getirir. Verileri bir Uygulama Yapılandırma deposuna geçirmek veya birden çok kaynaktan veri toplamak için içeri aktarma işlevini kullanın.

Bu kılavuz, Uygulama Yapılandırması verilerinin nasıl içeri aktarılacağını gösterir:

• bir yapılandırma dosyasından JSON, YAML veya Özellikler formatında
• Bir Uygulama Yapılandırma mağazasından
• Azure App Service 'dan
• Azure Kubernetes Hizmeti Yapılandırma Haritalarından

Yapılandırma dosyasından verileri içeri aktarma

Anahtar değerlerini bir dosyadan içeri aktarmak için aşağıdaki adımları izleyin.

Portal

Azure portalında şu adımları izleyin:

1. Uygulama Yapılandırma deponuza gidin ve İşlemler menüsünden İçeri/dışarı aktarma seçin.

   

2. İçeri Aktar radyo düğmesi varsayılan olarak seçilidir. Kaynak türü altında, Yapılandırma Dosyası öğesini seçin.

3. Formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Dosya türü	İçeri aktarma için dosya türünü seçin: YAML, Özellikler veya JSON.	JSON

4. Gözat düğmesine tıklayın ve içeri aktaracak dosyayı seçin.

5. Formun sonraki bölümünü doldurun:

   Parametre	Açıklama	Örnek
   Dosya içeriği profili	Bir içerik profili seçin: Varsayılan veya KVSet. Varsayılan dosya içeriği profili, mevcut programlama çerçeveleri veya sistemleri tarafından yaygın olarak benimsenen, JSON, YAML veya Özellikler dosya biçimlerini destekleyen geleneksel yapılandırma dosyası şemasını ifade eder. KVSet dosya içerik profili, bir Uygulama Yapılandırması anahtar değerinin anahtar, değer, etiket, içerik türü ve etiketler gibi tüm özelliklerini içeren bir dosya şemasına başvurur.	Varsayılan
   İçeri Aktarma modu	İçeri aktarma modu, aynı anahtar-değer çiftlerinin göz ardı edilip edilmeyeceğini belirlemek için kullanılır. Eşleşmeyi yoksay seçeneğiyle, depodaki yapılandırma dosyasındakilerle aynı olan tüm anahtar değerleri yoksayılır. Tümü seçeneğiyle, yapılandırma dosyasındaki tüm anahtar değerleri güncelleştirilir.	Eşleştirmeyi yoksay
   Özellik bayrağını dışla	İşaretlenirse özellik bayrakları içeri aktarılmaz.	İşaretlenmemiş
   Sıkı	Kutu işaretliyse, dosya içeriği profili Varsayılan olarak ayarlandığında, depodaki belirtilen ön ek ve etikete sahip olan ve yapılandırma dosyasına dahil olmayan tüm anahtar değerleri silinir. Dosya içeriği profili KVSet olarak ayarlandığında, depodaki yapılandırma dosyasına dahil olmayan tüm anahtar-değerler silinir. Kutu işaretlenmemişse, depodaki hiçbir anahtar-değer silinmez.	İşaretlenmemiş
   Ayırıcı	Ayırıcı, JSON veya YAML dosyalarını anahtar-değere düzleştirme için kullanılan sınırlayıcıdır. Özellik dosyaları ve feature flags için yoksayılır. Desteklenen değerler arasında boş ayırıcı, nokta (.), virgül (,), noktalı virgül (;), kısa çizgi (-), alt çizgi (_), çift alt çizgi (__), eğik çizgi (/) ve iki nokta üst üste (:) bulunur.	:
   Derinlik	Opsiyonel. JSON veya YAML dosyalarını anahtar-değer çiftlerine düzleştirme derinliği. Varsayılan olarak, bir ayırıcı seçilirse dosyalar en derin düzeye düzleştirilmiştir. Bu ayar özellik dosyaları veya özellik bayrakları için geçerli değildir.
   Ön ek ekleme	Opsiyonel. Belirtilirse, içeri aktarılan tüm anahtar-değerlerin anahtar adlarına bir ön ek eklenir.	test uygulamasını :
   Etiket ekle	Opsiyonel. Belirtilirse, sağlanan etiket içeri aktarılan tüm anahtar değerlerine atanır.	ürün
   İçerik türü ekleme	Opsiyonel. Belirtilirse, sağlanan içerik türü içeri aktarılan tüm anahtar-değerlere eklenir.	JSON (application/json)
   Etiket ekleme	Opsiyonel. Belirtilirse, sağlanan etiketler içeri aktarılan tüm anahtar değerlerine eklenir.	{tag: tag1}

6. İçeri aktarma işlemine devam etmek için Uygula'yı seçin.

Bir JSON dosyasından anahtar değerlerini başarıyla içeri aktarmışsınız. Anahtar adları : ayırıcısı kullanılarak düzleştirilmiş ve TestApp:ön eki eklenmiştir. Tüm içe aktarılan anahtar-değerler, prodolarak adlandırılır, application/jsoniçerik türüne sahip olur ve tag: tag1ile etiketlenir.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. İçeri aktarma komutu az appconfig kv import girin ve aşağıdaki parametreleri ekleyin:

   Parametre	Açıklama	Örnek
   --name	Verileri içeri aktarmak istediğiniz Uygulama Yapılandırma deposunun adını girin.	my-app-config-store
   --source	Bir dosyadan uygulama yapılandırma verilerini içeri aktardığınızı belirtmek için file girin.	file
   --path	İçeri aktarmak istediğiniz verileri içeren dosyanın yerel yolunu girin.	C:/Users/john/Downloads/data.json
   --format	İçeri aktardığınız dosyanın biçimini belirtmek için yaml, properties veya json girin.	json

2. İsteğe bağlı olarak aşağıdaki parametreleri de ekleyin:

   Parametre	Açıklama	Örnek
   --separator	Opsiyonel. Ayırıcı, anahtar değerlerini JSON/YAML olarak düzleştirmeye yönelik sınırlayıcıdır. Hiyerarşik yapıyı dışarı aktarmak için gereklidir ve özellik dosyaları ve özellik bayrakları için yoksayılır. Aşağıdaki seçeneklerden birini belirleyin: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opsiyonel. Anahtar ön eki, anahtarın başlangıç bölümüdür. Ön ekler, bir yapılandırma deposundaki anahtar-değer gruplarını yönetmek için kullanılabilir. Bu ön ek, içeri aktarılan her anahtar-değerin "key" özelliğinin önüne eklenir.	TestApp:
   --label	Opsiyonel. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin.	prod
   --content-type	Opsiyonel. İçeri aktarılan içeriğin bir Key Vault başvurusundan veya JSON dosyasından oluştuğunı belirtmek için appconfig/kvset veya application/json girin.	application/json

   Örnek: Bir JSON dosyasından tüm anahtar-değerleri ve özellik bayraklarını içeri aktarın, "prod" etiketini uygulayın ve "TestApp" ön ekini ekleyin. "application/json" içerik türünü ekleyin.

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. Komut satırında, gelecek değişikliklerin listesi görüntülenir. yseçerek içeri aktarmayı onaylayın.

   

Anahtar değerlerini bir JSON dosyasından içeri aktarıp "prod" etiketini ve "TestApp:" ön ekini atadıysanız. ";" ayırıcısı kullanılır ve içeri aktardığınız tüm anahtar-değerlerin içerik türü "JSON" olarak ayarlanmıştır.

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv import bölümüne gidin.

Uygulama Yapılandırma deposundan verileri içeri aktarma

Değerleri bir Uygulama Yapılandırması deposundan başka bir Uygulama Yapılandırma deposuna aktarabilir veya değerlerini çoğaltmak ve yeni etiket veya içerik türü gibi farklı parametreler uygulamak için bir Uygulama Yapılandırma deposundan aynı Uygulama Yapılandırma deposuna değerleri içeri aktarabilirsiniz.

Azure Uygulama Yapılandırma deposundan anahtar-değerleri ve özellik bayraklarını içeri aktarmak için aşağıdaki adımları izleyin.

Portal

Azure portalında şu adımları izleyin:

1. Uygulama Yapılandırma deponuza gidin ve İşlemler menüsünden İçeri/dışarı aktarma seçin.

   

2. İçeri Aktar radyo düğmesi varsayılan olarak seçilidir. Kaynak türüaltında Uygulama Yapılandırmasıöğesini seçin.

3. Verileri içeri aktarmak için bir Uygulama Yapılandırma deposu seçin ve formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Abonelik	Geçerli aboneliğiniz varsayılan olarak seçilidir.	my-subscription
   Kaynak grubu	İçeri aktaracak yapılandırmaya sahip Uygulama Yapılandırma deposunun bulunduğu bir kaynak grubu seçin. Geçerli kaynak grubunuz varsayılan olarak seçilidir.	my-resource-group
   Kaynak	İçeri aktarmak istediğiniz yapılandırmayı içeren Uygulama Yapılandırma depounu seçin.	my-other-app-config-store

4. Formun sonraki bölümünü doldurun:

   Parametre	Açıklama	Örnek
   Seçim modu	Varsayılan seçenek olan normal anahtar değerlerinden mi yoksa anlık görüntüden mi içeri aktarılacağını seçin.	Varsayılan
   Anahtar filtresi	İçeri aktarma için anahtar adına göre anahtar değerlerini filtrelemek için kullanılır. Anahtar belirtilmezse, tüm anahtarlar uygun olur.	test ile başlar
   Belirli bir zamanda	Opsiyonel. Seçilen yapılandırma deposunda belirli bir zaman noktasındaki anahtar değerlerini içeri aktarmak için bu alanı doldurun. Boş bırakılırsa, varsayılan olarak anahtar-değerlerin geçerli zaman noktasına ayarlanır.	28.07.2022 12:00:00
   Etiketten	Bu etiketlerle ilişkili anahtar değerlerini içeri aktarmak için bir veya daha fazla etiket seçin. Hiçbir etiket seçilmezse, tüm etiketler uygun olur.	ürün
   Özellik bayrağını dışla	İşaretlenirse özellik bayrakları içeri aktarılmaz.	İşaretlenmemiş
   Ön ek ekleme	Opsiyonel. Belirtilirse, içeri aktarılan tüm anahtar-değerlerin anahtar adlarına bir ön ek eklenir.	test uygulamasını :
   Etiketleri geçersiz kıl	Opsiyonel. Varsayılan olarak, kaynak anahtar-değerlerin özgün etiketleri korunur. Bunları geçersiz kılmak için kutuyu işaretleyin ve içeri aktarılan anahtar-değerler için yeni bir etiket girin.	yeni
   İçerik türlerini geçersiz kılma	Opsiyonel. Varsayılan olarak, kaynak anahtar-değerlerin özgün içerik türleri korunur. Bunları geçersiz kılmak için kutuyu işaretleyin ve içeri aktarılan anahtar-değerler için yeni bir içerik türü girin. Özellik bayraklarının içerik türünün geçersiz kılınamayacağını unutmayın.	JSON (application/json)

5. İçeri aktarma işlemine devam etmek için Uygula'yı seçin.

28 Ocak 2021 tarihinde saat 12:00'de, test ile başlayan anahtar adları ve prodetiketi ile bir Uygulama Yapılandırma deposundan anahtar değerlerini içeri aktardınız. Anahtar adlarına TestApp:ön eki eklendi. İçeri aktarılan tüm anahtar-değerlere etiket new ve içerik türü application/jsonatanmıştır.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. Import komutunu az appconfig kv import olarak girin ve ardından aşağıdaki parametreleri girin:

   Parametre	Açıklama	Örnek
   --name	Verileri içeri aktarmak istediğiniz Uygulama Yapılandırma deposunun adını girin	my-app-config-store
   --source	Bir Uygulama Yapılandırma deposundan veri içeri aktardığınızı belirtmek için appconfig girin.	appconfig
   --src-name	Verileri içeri aktarmak istediğiniz Uygulama Yapılandırma deposunun adını girin.	my-source-app-config
   --src-label	İçeri aktarma işleminizi belirli bir etiket taşıyan anahtar-değerlerle kısıtlayın. Bu parametreyi kullanmazsanız, yalnızca null etiketli anahtar-değerler içeri aktarılır. Yıldız işaretini filtre olarak destekler: tüm etiketler için * girin; Ön ek olarak abc içeren tüm etiketler için abc*.	prod

2. İsteğe bağlı olarak aşağıdaki parametreleri ekleyin:

   Parametre	Açıklama	Örnek
   --label	Opsiyonel. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin.	new
   --content-type	Opsiyonel. İçeri aktarılan içeriğin bir Key Vault başvurusundan veya JSON dosyasından oluştuğunı belirtmek için appconfig/kvset veya application/json girin. İçerik türü yalnızca içeri aktarılan anahtar değerleri için geçersiz kılınabilir. Özellik bayrakları için varsayılan içerik türü "application/vnd.microsoft.appconfig.ff+json; charset=utf-8' varsayılan olarak ve bu parametre tarafından güncelleştirilmez.	application/json

   Örnek: Anahtar-değerlerini ve özellik bayraklarını başka bir Uygulama Yapılandırmasından "prod" etiketiyle içeri aktarın ve onlara "new" etiketini atayın. "application/json" içerik türünü ekleyin.

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. Komut satırında, gelecek değişikliklerin listesi görüntülenir. yseçerek içeri aktarmayı onaylayın.

   

Bir Uygulama Yapılandırma deposundan "prod" etiketiyle anahtar değerlerini içeri aktardınız ve onlara "new" etiketini atadınız. İçeri aktardığınız tüm anahtar-değerlerin içerik türü "JSON" olarak ayarlanmıştır.

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv import bölümüne gidin.

Azure App Service'ten verileri içeri aktarma

Anahtar değerlerini Azure App Service'ten içeri aktarmak için aşağıdaki adımları izleyin.

Uyarı

App Service şu anda özellik bayraklarını desteklememektedir. App Service'e aktarılan tüm özellik bayrakları otomatik olarak anahtar-değerlere dönüştürülür. App Service kaynaklarınız yalnızca anahtar değerleri içerebilir.

Portal

Azure portalından:

1. Uygulama Yapılandırma deponuza gidin ve İşlemler menüsünden İçeri/dışarı aktarma seçin.

   

2. İçeri Aktar radyo düğmesi varsayılan olarak seçilidir. Kaynak türüaltında Uygulama Hizmetleriseçin.

3. Verileri içeri aktarmak için bir Uygulama Yapılandırma deposu seçin ve formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Abonelik	Geçerli aboneliğiniz varsayılan olarak seçilidir.	my-subscription
   Kaynak grubu	Yapılandırmasını içeri aktaracağınız App Service'i içeren bir kaynak grubu seçin.	my-resource-group
   Kaynak	İçeri aktarmak istediğiniz yapılandırmayı içeren App Service'i seçin.	my-app-service

4. Formun sonraki bölümünü doldurun:

   Parametre	Açıklama	Örnek
   Ayarları referans olacak şekilde güncelleştir	İşaretlenirse, App Service'te bulunan uygulama ayarları, içeri aktarılan anahtar-değerler için Uygulama Yapılandırma referanslarına güncellenir. Bu, uygulama ayarlarınızı ileride Uygulama Yapılandırması'nda yönetmenize olanak tanır. App Service'iniz geçerli değeri Uygulama Yapılandırması'ndan otomatik olarak çeker. Daha fazla bilgi edinmek için bkz. App Service ve Azure İşlevleri için Uygulama Yapılandırması referanslarını kullanma.	Kontrol
   Ön ek ekleme	Opsiyonel. Belirtilirse, içeri aktarılan tüm anahtar-değerlerin anahtar adlarına bir ön ek eklenir.	test uygulamasını :
   Etiket ekle	Opsiyonel. Belirtilirse, sağlanan etiket içeri aktarılan tüm anahtar değerlerine atanır.	ürün
   İçerik türü ekleme	Opsiyonel. Belirtilirse, sağlanan içerik türü içeri aktarılan tüm anahtar-değerlere eklenir.	JSON (application/json)

5. İçeri aktarma işlemine devam etmek için Uygula'yı seçin.

App Service'ten tüm uygulama ayarlarını anahtar-değer olarak içeri aktardınız ve bunlara prod etiketini ve TestApp:ön ekini atadınız. İçeri aktardığınız tüm anahtar-değerlerin içerik türü application/jsonolarak ayarlanmıştır.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. İçeri aktarma komutu az appconfig kv import girin ve aşağıdaki parametreleri ekleyin:

   Parametre	Açıklama	Örnek
   --name	Verileri içeri aktarmak istediğiniz Uygulama Yapılandırma deposunun adını girin.	my-app-config-store
   --source	Azure App Service'ten uygulama yapılandırma verilerini içeri aktardığınızı belirtmek için appservice girin.	appservice
   --appservice-account	App Service'in ARM kimliğini girin veya Uygulama Yapılandırması ile aynı abonelikte ve kaynak grubundaysa App Service'in adını kullanın.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service veya my-app-service

2. İsteğe bağlı olarak aşağıdaki parametreleri de ekleyin:

   Parametre	Açıklama	Örnek
   --prefix	Opsiyonel. Anahtar ön eki, anahtar-değerin "key" özelliğinin başlangıç bölümüdür. Ön ekler, bir yapılandırma deposundaki anahtar-değer gruplarını yönetmek için kullanılabilir. Bu ön ek, içeri aktarılan her anahtar-değerin "key" özelliğinin önüne eklenir.	TestApp:
   --label	Opsiyonel. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin. Bir etiket belirtmezseniz, null etiket anahtar değerlerinize atanır.	prod
   --content-type	Opsiyonel. İçeri aktarılan içeriğin bir Key Vault başvurusundan veya JSON dosyasından oluştuğunı belirtmek için appconfig/kvset veya application/json girin.	application/json

   --appservice-accountdeğerini almak için az webapp show --resource-group <resource-group> --name <resource-name>komutunu kullanın.

   Örnek: App Service'inizdeki tüm uygulama ayarlarını "prod" etiketiyle anahtar değerleri olarak Uygulama Yapılandırma deponuza aktarın ve bir "TestApp:" ön eki ekleyin.

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. Komut satırında, gelecek değişikliklerin listesi görüntülenir. yseçerek içeri aktarmayı onaylayın.

   

App Service'inizdeki tüm uygulama ayarlarını anahtar-değer olarak içeri aktardıysanız, bunlara "prod" etiketini atamış ve bir "TestApp:" ön eki eklemişsinizdir. İçeri aktardığınız tüm anahtar-değerlerin içerik türü "JSON" olarak ayarlanmıştır.

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv import bölümüne gidin.

Azure Kubernetes Service ConfigMaps'ten verileri içeri aktarma

Azure Kubernetes Service ConfigMaps'ten anahtar değerlerini içeri aktarmak için aşağıdaki adımları izleyin. Bu özellik için portal desteği geliştirme aşamasındadır. AKS'den içeri aktarmak için lütfen Azure CLI kullanın.

Portal

Bu özellik için Azure portalı desteği geliştirme aşamasındadır.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. İçeri aktarma komutu az appconfig kv import girin ve aşağıdaki parametreleri ekleyin:

   Parametre	Açıklama	Örnek
   --name	Verileri içeri aktarmak istediğiniz Uygulama Yapılandırma deposunun adını girin.	my-app-config-store
   --source	Uygulama yapılandırma verilerini Azure Kubernetes Service'ten içeri aktardığınızı belirtmek için girin aks .	aks
   --aks-cluster	Uygulama Yapılandırması ile aynı abonelikte ve kaynak grubundaysa Azure Kubernetes Service'in ARM kimliğini girin veya Azure Kubernetes Service adını kullanın.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster veya my-aks-cluster
   --configmap-namespace	İçeri aktarmak istediğiniz ConfigMap'in ad alanını girin.	default
   --configmap-name	İçeri aktarmak istediğiniz ConfigMap'in adını girin.	my-configmap

2. İsteğe bağlı olarak aşağıdaki parametreleri de ekleyin:

   Parametre	Açıklama	Örnek
   --prefix	Opsiyonel. Anahtar ön eki, anahtar-değerin "key" özelliğinin başlangıç bölümüdür. Ön ekler, bir yapılandırma deposundaki anahtar-değer gruplarını yönetmek için kullanılabilir. Bu ön ek, içeri aktarılan her anahtar-değerin "key" özelliğinin önüne eklenir.	TestApp:
   --label	Opsiyonel. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin. Bir etiket belirtmezseniz, null etiket anahtar değerlerinize atanır.	test
   --content-type	Opsiyonel. İçeri aktarılan içeriğin bir Key Vault başvurusundan veya JSON dosyasından oluştuğunı belirtmek için appconfig/kvset veya application/json girin.	application/json
   --format	Opsiyonel. İçeri aktardığınız ConfigMap biçimini belirtmek için yaml, properties veya json girin.	json
   --separator	Opsiyonel. Ayırıcı, anahtar-değerleri düzleştirmeye yönelik sınırlayıcıdır. Hiyerarşik yapıyı dışarı aktarmak için gereklidir ve özellik dosyaları ve özellik bayrakları için yoksayılır. Aşağıdaki seçeneklerden birini belirleyin: ., ,, :, ;, /, -, _, —.	;

   --aks-clusterdeğerini almak için az aks show --resource-group <resource-group> --name <aks-cluster-name>komutunu kullanın.

   Örnek: AKS Configmap'inizdeki tüm ayarları "test" etiketiyle anahtar-değer olarak Uygulama Yapılandırma deponuza aktarın ve bir "TestApp:" ön eki ekleyin.

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

3. Komut satırında, gelecek değişikliklerin listesi görüntülenir. yseçerek içeri aktarmayı onaylayın.

   

AKS ConfigMap'inizdeki tüm ayarları anahtar-değer olarak içeri aktardıysanız, bunlara "test" etiketini atadıktan sonra bir "TestApp:" ön eki eklediniz.

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv import bölümüne gidin.

Verileri dışarı aktarma

Dışarı aktarma, Uygulama Yapılandırması'nda depolanan yapılandırma verilerini başka bir hedefe yazar. Örneğin, bir Uygulama Yapılandırma deposundaki verileri dağıtım sırasında uygulama kodunuz içine ekleyebileceğiniz bir dosyaya kaydetmek için dışarı aktarma işlevini kullanın.

Bu kılavuzda Uygulama Yapılandırması verilerinin nasıl dışarı aktarılası gösterilmektedir:

• JSON, YAML veya Özellikler bir yapılandırma dosyasına
• Uygulama Yapılandırma deposuna
• Azure App Service kaynağı

Verileri yapılandırma dosyasına aktarma

Yapılandırma verilerini bir Uygulama Yapılandırma deposundan JSON, YAML veya Özellikler dosyasına aktarmak için bu adımları izleyin.

Portal

Azure portalışu adımları izleyin:

1. Uygulama Yapılandırma deponuza gidin ve İçeri/dışarı aktarmaöğesini seçin.

   

2. Dışarı Aktar radyo düğmesini seçin ve hedef türü altında Yapılandırma dosyasıöğesini seçin.

3. Formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Dosya türü	Dışarı aktarmak için dosya türünü seçin: YAML, Özellikler veya JSON.	JSON
   Dosya içeriği profili	Bir içerik profili seçin: Varsayılan veya KVSet. Varsayılan dosya içeriği profili, mevcut programlama çerçeveleri veya sistemleri tarafından yaygın olarak benimsenen, JSON, YAML veya Özellikler dosya biçimlerini destekleyen geleneksel yapılandırma dosyası şemasını ifade eder. KVSet dosya içerik profili, bir Uygulama Yapılandırması anahtar değerinin anahtar, değer, etiket, içerik türü ve etiketler gibi tüm özelliklerini içeren bir dosya şemasına başvurur.	Varsayılan
   Seçim modu	Normal anahtar-değerlerinden, ki bu varsayılan seçenektir, veya bir anlık görüntüden dışarı aktarmayı seçin.	Varsayılan
   Anahtar filtresi	İhracat için anahtar adına göre anahtar-değer çiftlerini filtrelemek üzere kullanılır. Anahtar belirtilmezse, tüm anahtarlar uygun olur.	TestApp ile başlar:
   Belirli bir zamanda	Opsiyonel. Anahtar-değerleri seçilen yapılandırma deposunda belirli bir noktadan dışarı aktarmak için bu alanı doldurun. Boş bırakılırsa, varsayılan olarak anahtar-değerlerin geçerli zaman noktasına ayarlanır.	28.07.2022 12:00:00
   Etiketten	Bu etiketlerle ilişkili anahtar değerlerini dışarı aktarmak için etiketi seçin. Hiçbir etiket seçilmezse, tüm etiketler uygun olur. Default dosya içerik profiliyle dışarı aktarırken yalnızca bir etiket seçebileceğinizi unutmayın. Anahtar-değerleri birden fazla etiketle dışarı aktarmak için KVSet dosya içerik profilini kullanın.	ürün
   Ön eki kaldırma	Opsiyonel. Belirtilirse ön ek, onu içeren tüm dışarı aktarılan anahtar-değerlerin anahtar adlarından kaldırılır.	test uygulamasını :
   Ayırıcı	Ayırıcı, anahtar adlarını segmentlere ayırmak ve JSON veya YAML dosyalarının hiyerarşik yapılandırmalarını anahtar-değerlerden yeniden yapılandırmak için kullanılan sınırlayıcıdır. Özellik dosyaları ve feature flags için yoksayılır. Desteklenen değerler ayırıcı, nokta (.), virgül (,), noktalı virgül (;), kısa çizgi (-), alt çizgi (_), çift alt çizgi (__), eğik çizgi (/) ve iki nokta (:)) içermez.	:

4. 'ü seçin ve dışa aktarmayı tamamlamak için'i dışa aktarın.

Anahtar-değerleri 28 Temmuz 2021'den itibaren saat 12:00'de bir Uygulama Yapılandırma deposundan TestApp: ile başlayan anahtar adları ve prodetiketiyle birlikte bir JSON dosyasına aktarmıştınız. TestApp: ön eki anahtar adlarından kırpıldı ve anahtar adlarını segmentlere ayırmak ve hiyerarşik JSON biçimini yeniden yapılandırmak için ayırıcı : kullanıldı.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. Dışarı aktarma komutu az appconfig kv export girin ve aşağıdaki parametreleri ekleyin:

   Parametre	Açıklama	Örnek
   --name	Dışarı aktarmak istediğiniz anahtar değerlerini içeren Uygulama Yapılandırma deposunun adını girin.	my-app-config-store
   --destination	Verileri bir dosyaya aktardığınızı belirtmek için file girin.	file
   --path	Dosyayı kaydetmek istediğiniz yolu girin.	C:/Users/john/Downloads/data.json
   --format	Dışarı aktarmak istediğiniz dosyanın biçimini belirtmek için yaml, properties veya json girin.	json
   --label	Anahtar-değerleri ve özellik bayraklarını bu etiketle dışarı aktarmak için bir etiket girin. Bir etiket belirtmezseniz, varsayılan olarak yalnızca anahtar-değerleri ve etiket içermeyen özellik bayraklarını dışarı aktarırsınız. Bir etiket girebilir, ,ile ayırarak birkaç etiket girebilir veya tüm etiketleri hesaba katmak için * kullanabilirsiniz.	prod

   Önemli

   Bir etiket seçmezseniz, yalnızca etiket içermeyen anahtar-değerler dışarı aktarılır. Etiketli bir anahtar değerini dışarı aktarmak için, bu değerin etiketini seçmeniz gerekir.

2. İsteğe bağlı olarak aşağıdaki parametreleri de ekleyin:

   Parametre	Açıklama	Örnek
   --separator	Opsiyonel. Ayırıcı, anahtar değerlerini JSON/YAML olarak düzleştirmeye yönelik sınırlayıcıdır. Hiyerarşik yapıyı dışarı aktarmak için gereklidir ve özellik dosyaları ve özellik bayrakları için yoksayılır. Aşağıdaki seçeneklerden birini belirleyin: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opsiyonel. Her anahtar değerinin "key" özelliğinden kırpılacak ön ek. Anahtar ön eki, anahtarın başlangıç bölümüdür. Ön ekler, bir yapılandırma deposundaki anahtar-değer gruplarını yönetmek için kullanılabilir. Özellik bayrakları için ön ek yoksayılır.	TestApp:

   Örnek: "prod" etiketli tüm anahtar-değerleri ve özellik bayraklarını bir JSON dosyasına aktarın.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. Komut satırında, dosyaya dışarı aktarılan anahtar-değerlerin listesi görüntülenir. yseçerek dışarı aktarmayı onaylayın.

   

Değişken özellik bayrakları Microsoft Özellik Yönetimi şemasıkullanılarak bir dosyaya aktarılırken, diğer özellik bayrakları uyumluluk için .NET Özellik Yönetimi şeması kullanılarak dışarı aktarılır. Özellik bayraklarını yalnızca Microsoft Özellik Yönetimi şemasını kullanarak dışarı aktarmak için AZURE_APPCONFIG_FM_COMPATIBLE ortam değişkenini False olarak ayarlayın.

"Prod" etiketine sahip anahtar-değerleri ve özellik bayraklarını bir yapılandırma dosyasına aktarıp "TestApp" ön ekini kırpmışsınız. Değerler dosyada ";" ile ayrılır.

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv exportgidin.

Uygulama Yapılandırma deposuna veri aktarma

Anahtar-değerleri ve özellik bayraklarını azure uygulama yapılandırma deposuna aktarmak için aşağıdaki adımları izleyin.

Değerleri bir Uygulama Yapılandırması deposundan başka bir Uygulama Yapılandırma deposuna aktarabilir veya değerlerini çoğaltmak ve yeni etiket veya içerik türü gibi farklı parametreler uygulamak için bir Uygulama Yapılandırma deposundan aynı Uygulama Yapılandırma deposuna değerleri dışarı aktarabilirsiniz.

Portal

Azure portalında şu adımları izleyin:

1. Dışarı aktarmak istediğiniz verileri içeren Uygulama Yapılandırma deponuza gidin ve İşlemler menüsünden İçeri/dışarı aktarma seçin.

   

2. dışarı aktar radyo düğmesini seçin ve hedef türü altında Uygulama Yapılandırmasıöğesini seçin.

3. Formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Seçim modu	Normal anahtar-değerlerinden, ki bu varsayılan seçenektir, veya bir anlık görüntüden dışarı aktarmayı seçin.	Varsayılan
   Anahtar filtresi	İhracat için anahtar adına göre anahtar-değer çiftlerini filtrelemek üzere kullanılır. Anahtar belirtilmezse, tüm anahtarlar uygun olur.	TestApp ile başlar:
   Belirli bir zamanda	Opsiyonel. Anahtar-değerleri seçilen yapılandırma deposunda belirli bir noktadan dışarı aktarmak için bu alanı doldurun. Boş bırakılırsa, varsayılan olarak anahtar-değerlerin geçerli zaman noktasına ayarlanır.	28.07.2022 12:00:00
   Etiketten	Bu etiketlerle ilişkili anahtar değerlerini dışarı aktarmak için bir veya daha fazla etiket seçin. Hiçbir etiket seçilmezse, tüm etiketler uygun olur.	ürün
   Özellik bayrağını dışla	İşaretlenirse, özellik bayrakları dışa aktarılmaz.	İşaretlenmemiş

4. Hedef depoyu seçin, formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Abonelik	Geçerli aboneliğiniz varsayılan olarak seçilidir.	my-subscription
   Kaynak grubu	Yapılandırmayı dışarı aktarmak istediğiniz Uygulama Yapılandırma deposunun bulunduğu bir kaynak grubu seçin. Geçerli kaynak grubunuz varsayılan olarak seçilidir.	my-resource-group
   Kaynak	Yapılandırmayı dışarı aktarmak istediğiniz Uygulama Yapılandırma depounu seçin.	my-other-app-config-store

5. Formun sonraki bölümünü doldurun:

   Parametre	Açıklama	Örnek
   Ön eki kaldırma	Opsiyonel. Belirtilirse ön ek, onu içeren tüm dışarı aktarılan anahtar-değerlerin anahtar adlarından kaldırılır.	test uygulamasını :
   Etiketleri geçersiz kıl	Opsiyonel. Varsayılan olarak, kaynak anahtar-değerlerin özgün etiketleri korunur. Bunları geçersiz kılmak için kutuyu işaretleyin ve dışarı aktarılan anahtar-değerler için yeni bir etiket girin.	yeni
   İçerik türlerini geçersiz kılma	Opsiyonel. Varsayılan olarak, kaynak anahtar-değerlerin özgün içerik türleri korunur. Bunları geçersiz kılmak için kutuyu işaretleyin ve dışarı aktarılan anahtar-değerler için yeni bir içerik türü girin. Özellik bayraklarının içerik türünün geçersiz kılınamayacağını unutmayın.	JSON (application/json)

6. İhracata devam etmek için Uygula'i seçin.

Anahtar-değerleri 28 Temmuz 2022'de saat 12:00 itibarıyla bir Uygulama Yapılandırma deposundan TestApp: ile başlayan anahtar adları ve prodetiketiyle başka bir Uygulama Yapılandırma deposuna aktarmışsınız. Dışarı aktarılan tüm anahtar-değerlerin TestApp:anahtar ön eki kaldırıldı ve ardından etiket new ve içerik türü application/jsonatandı.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. Dışarı aktarma komutu az appconfig kv export girin ve aşağıdaki parametreleri girin:

   Parametre	Açıklama	Örnek
   --name	Dışarı aktarmak istediğiniz anahtar değerlerini içeren Uygulama Yapılandırma deposunun adını girin.	my-app-config-store
   --destination	Verileri bir Uygulama Yapılandırma deposuna aktardığınızı belirtmek için appconfig girin.	appconfig
   --dest-name	Verileri dışarı aktarmak istediğiniz Uygulama Yapılandırma deposunun adını girin.	my-other-app-config-store
   --label	Anahtar-değerleri ve özellik bayraklarını bu etiketle dışarı aktarmak için bir etiket girin. Bir etiket belirtmezseniz, varsayılan olarak yalnızca anahtar-değerleri ve etiket içermeyen özellik bayraklarını dışarı aktarırsınız. Bir etiket girebilir, ,ile ayırarak birkaç etiket girebilir veya * kullanarak tüm etiketleri hesaba aktarabilirsiniz.	prod

   Önemli

   Dışarı aktarmak istediğiniz anahtar-değerlerin etiketleri varsa, --label komutunu kullanmanız ve ilgili etiketleri girmeniz gerekir. Bir etiket seçmezseniz, yalnızca etiket içermeyen anahtar-değerler dışarı aktarılır. Birkaç etiket seçmek için virgül işareti (,) kullanın veya null etiket (etiket yok) dahil olmak üzere tüm etiketleri eklemek için * kullanın.

2. İsteğe bağlı olarak aşağıdaki parametreyi de ekleyin:

   Parametre	Açıklama	Örnek
   --dest-label	Opsiyonel. Bu etiketi dışarı aktarılan anahtar değerlerine atamak için bir hedef etiket girin.	new

   Örnek: Anahtar-değerleri ve özellik bayraklarını "prod" etiketiyle başka bir Uygulama Yapılandırma deposuna dışarı aktarın ve hedef etiketi "yeni" ekleyin.

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. Komut satırında, dosyalara dışarı aktarılan anahtar-değerlerin listesi görüntülenir. yseçerek dışarı aktarmayı onaylayın.

   

Bir Uygulama Yapılandırma deposundan "prod" etiketine sahip anahtar-değerleri ve özellik bayraklarını dışa aktararak onlara "new" etiketini atadınız.

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv import bölümüne gidin.

Verileri Azure App Service'e aktarma

Anahtar değerlerini Azure App Service'e aktarmak için aşağıdaki adımları izleyin.

Uyarı

Özellik bayraklarının App Service'e dışarı aktarılması desteklenmez.

Portal

Azure portalında şu adımları izleyin:

1. Uygulama Yapılandırma deponuza gidin ve İşlemler menüsünden İçeri/dışarı aktarma seçin.

   

2. Dışarı Aktar radyo düğmesini seçin ve Hedef türüaltında, Uygulama Hizmetleriöğesini seçin.

3. Başvuru olarak dışa aktar seçeneği varsayılan olarak işaretlidir. Kutu işaretlendiğinde App Service'teki uygulama ayarları, dışarı aktarılan anahtar değerleri için Uygulama Yapılandırması başvuruları olarak eklenir. Bu, App Hizmetinin geçerli değerleri Uygulama Yapılandırması'ndan otomatik olarak çekmesiyle, ayarlarınızı Uygulama Yapılandırması'nda yönetmenize olanak tanır. Daha fazla bilgi edinmek için bkz. App Service ve Azure İşlevleri için Uygulama Yapılandırması referanslarını kullanma. Kutu işaretlenmemişse, anahtar ve değer doğrudan App Service'e aktarılır. Uygulamanızın güncelleştirmeleri aldığından emin olmak için Uygulama Yapılandırması'nda her değişiklik yaptığınızda verilerinizi yeniden dışarı aktarmayı unutmayın.

4. Formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Seçim modu	Normal anahtar-değerlerinden, ki bu varsayılan seçenektir, veya bir anlık görüntüden dışarı aktarmayı seçin.	Varsayılan
   Anahtar filtresi	İhracat için anahtar adına göre anahtar-değer çiftlerini filtrelemek üzere kullanılır. Anahtar belirtilmezse, tüm anahtarlar uygun olur.	TestApp ile başlar:
   Belirli bir zamanda	Opsiyonel. Anahtar-değerleri seçilen yapılandırma deposunda belirli bir noktadan dışarı aktarmak için bu alanı doldurun. Boş bırakılırsa, varsayılan olarak anahtar-değerlerin geçerli zaman noktasına ayarlanır.	28.07.2022 12:00:00
   Etiketten	Bu etiketle ilişkili anahtar değerlerini dışarı aktarmak için bir etiket seçin.	ürün

5. Bir hedef depo seçin ve formu aşağıdaki parametrelerle doldurun:

   Parametre	Açıklama	Örnek
   Abonelik	Geçerli aboneliğiniz varsayılan olarak seçilidir.	my-subscription
   Kaynak grubu	Yapılandırmayı dışarı aktarmak istediğiniz App Service'i içeren bir kaynak grubu seçin.	my-resource-group
   Kaynak	Yapılandırmayı dışarı aktarmak istediğiniz App Service'i seçin.	my-app-service

6. İsteğe bağlı olarak formun sonraki bölümünü doldurun:

   Parametre	Açıklama	Örnek
   Ön eki kaldırma	Opsiyonel. Belirtilirse ön ek, onu içeren tüm dışarı aktarılan anahtar-değerlerin anahtar adlarından kaldırılır.	test uygulamasını :

7. İhracata devam etmek için Uygula'i seçin.

28 Temmuz 2022 tarihinde, gece yarısı, TestApp: ile başlayan anahtar adları ve etiket prodile bir Uygulama Yapılandırma deposundan App Service kaynağının uygulama ayarlarına anahtar-değerleri aktardınız. TestApp: öneki, dışa aktarılan anahtar adlarından çıkarıldı.

Anahtar-değerleri başvuru olarak dışarı aktarmak için kutuyu işaretlediyseniz, dışarı aktarılan anahtar-değerler App Service kaynak yapılandırma ayarlarınızın "Kaynak" sütununda Uygulama Yapılandırması başvuruları olarak gösterilir.

Azure CLI

Azure CLI'dan aşağıdaki adımları izleyin. Azure CLI yerel olarak yüklü değilse, isteğe bağlı olarak Azure Cloud Shellkullanabilirsiniz.

1. Dışarı aktarma komutu az appconfig kv export girin ve aşağıdaki parametreleri girin:

   Parametre	Açıklama	Örnek
   --name	Dışarı aktarmak istediğiniz anahtar değerlerini içeren Uygulama Yapılandırma deposunun adını girin.	my-app-config-store
   --destination	App Service'e veri aktardığınızı belirtmek için appservice girin.	appservice
   --appservice-account	App Service'in ARM kimliğini girin veya Uygulama Yapılandırması ile aynı abonelikte ve kaynak grubundaysa App Service'in adını kullanın.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service veya my-app-service
   --label	Opsiyonel. Anahtar-değerleri ve özellik bayraklarını bu etiketle dışarı aktarmak için bir etiket girin. Bir etiket belirtmezseniz, varsayılan olarak yalnızca anahtar-değerleri ve etiket içermeyen özellik bayraklarını dışarı aktarırsınız.	prod

   --appservice-accountdeğerini almak için az webapp show --resource-group <resource-group> --name <resource-name>komutunu kullanın.

2. İsteğe bağlı olarak bir ön ek de ekleyin:

   Parametre	Açıklama	Örnek
   --prefix	Opsiyonel. Dışarı aktarılan anahtar-değerin "key" özelliğinden kırpılacak ön ek. Anahtar ön eki, anahtarın başlangıç bölümüdür. Ön ekler, bir yapılandırma deposundaki anahtar-değer gruplarını yönetmek için kullanılabilir.	TestApp:

   Örnek: "Prod" etiketine sahip tüm anahtar değerlerini bir App Service uygulamasına aktarın ve "TestApp" ön ekini kırpın.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   Komut satırı, App Service kaynağına dışarı aktarılan anahtar-değerlerin listesini görüntüler. yseçerek dışarı aktarmayı onaylayın.

   

   "Prod" etiketine sahip tüm anahtar değerlerini bir Azure App Service kaynağına aktarıp "TestApp:" ön ekini kırpmışsınız.

3. İsteğe bağlı olarak, Uygulama Yapılandırma Başvurusu olarak dışarı aktarılacak bir bayrak belirtin.

   Parametre	Açıklama
   --export-as-reference -r	Opsiyonel. Anahtar değerlerinin App Service'e Uygulama Yapılandırması başvuruları olarak aktarılıp aktarılmayacağını belirtin. Daha fazla bilgi edinin.

   Örnek: App Service uygulamasına uygulama yapılandırma başvuruları olarak "prod" etiketiyle tüm anahtar değerlerini dışarı aktarın.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   Komut satırı, App Service kaynağına uygulama yapılandırma başvuruları olarak dışarı aktarılan anahtar-değerlerin listesini görüntüler. yseçerek dışarı aktarmayı onaylayın.

   

   Tüm anahtar-değer çiftlerini "prod" etiketi ile uygulama yapılandırması referansları olarak bir Azure App Service kaynağına dışarı aktardınız. App Service kaynağınızda, içeri aktarılan anahtar-değerler "Kaynak" sütununda Uygulama Yapılandırması başvuruları olarak gösterilir.

   

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv exportgidin.

Hata iletileri

Uygulama Yapılandırması anahtar-değerlerini içeri veya dışarı aktarırken aşağıdaki hata iletileriyle karşılaşabilirsiniz:

• Mağazanız için Genel erişim devre dışı bırakıldı veyadeponun özel uç nokta yapılandırmalarında bulunmayan bir özel uç noktadan erişiyor olabilirsiniz. Uygulama Yapılandırma deponuzda özel uç noktalar etkinleştirildiyse, varsayılan olarak yalnızca yapılandırılan sanal ağın içinden erişebilirsiniz. Azure portalını veya CLI'yi çalıştıran makinenin özel uç noktayla aynı sanal ağa katılmış olduğundan emin olun. Uygulama Yapılandırma deponuza genel ağ erişimini yeni etkinleştirdiyseniz, önbelleğin yenilenmesine izin vermek için yeniden denemeden önce en az 5 dakika bekleyin.

Sonraki adımlar

CI/CD işlem hattıyla entegre etme