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ırması 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ırması deposu, üretim için de başka bir depo ayarlayabilirsiniz. Verileri iki kez girmeniz gerekmeyecek şekilde bunların arasına uygulama ayarlarını kopyalayabilirsiniz.

Bu makalede, Uygulama Yapılandırması ile verileri içeri ve dışarı aktarmaya yönelik bir kılavuz sağlanır. GitHub deponuzla sürekli eşitleme ayarlamak isterseniz GitHub Actions ve Azure Pipelines görevlerine göz atın.

Azure portal veya Azure CLI kullanarak verileri içeri veya dışarı aktarabilirsiniz.

Veri içeri aktarma

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

Bu kılavuzda Uygulama Yapılandırması verileri içeri aktarma işlemi gösterilmektedir:

• Json, Yaml veya Özellikler'deki bir yapılandırma dosyasından
• Uygulama Yapılandırması mağazasından
• Azure App Service

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.

Not

Bir dosyadan özellik bayraklarının içeri aktarılması desteklenmez. Yapılandırma dosyası özellik bayrakları içeriyorsa, bunlar otomatik olarak normal anahtar değerleri olarak içeri aktarılır.

Portal

Azure portal şu adımları izleyin:

1. Uygulama Yapılandırması deponuza göz atın ve İşlemlermenüsünden İçeri/dışarı aktar'ı seçin.

   

2. İçeri Aktar sekmesinde Kaynak hizmet'in altında Yapılandırma dosyası'nı seçin.

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

   Parametre	Açıklama	Örnek
   Dil için	.NET, Java (Spring) ve Diğer arasında içeri aktardığınız dosyanın dilini seçin.	.NET
   Dosya türü	Yaml, Properties ve Json arasında içeri aktardığınız dosya türünü seçin.	Json

4. Klasör simgesini seçin ve içeri aktarılacağınız dosyaya gidin.

   Not

   Ekranda dosyanın başarıyla getirildiğini belirten bir ileti görüntülenir.

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

   Parametre	Açıklama	Örnek
   Ayırıcı	Ayırıcı, içeri aktarılan yapılandırma dosyanızda ayrıştırılan karakterdir ve yapılandırma deponuza eklenecek anahtar-değerleri birbirinden ayırır. Aşağıdaki seçeneklerden birini belirleyin: ., ,, :, ;, /, , -_, —.	;
   Ön ek	İsteğe bağlı. 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. Girilen ön ek, bu dosyadan içeri aktardığınız her anahtar-değerin "key" özelliğinin önüne eklenir.	Testapp:
   Etiketle	İsteğe bağlı. Var olan bir etiketi seçin veya içeri aktarılan anahtar değerlerinize atanacak yeni bir etiket girin.	Prod
   İçerik türü	İsteğe bağlı. JSON dosyasını mı yoksa Key Vault başvurularını mı içeri aktardığınızı belirtin. Key Vault başvuruları hakkında daha fazla bilgi için ASP.NET Core uygulamasında Key Vault başvuruları kullanma bölümüne gidin.	JSON (application/json)

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

Bir JSON dosyasından anahtar-değerleri içeri aktardıysanız, onlara "prod" etiketini ve "TestApp" ön ekini atamış olursunuz. ":" 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.

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 Shell kullanabilirsiniz.

1. import komutunu 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ırması deposunun adını girin.	my-app-config-store
   --source	Bir dosyadan uygulama yapılandırma verilerini içeri aktardığınızı belirtmek için girin file .	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	İsteğe bağlı. 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	İsteğe bağlı. 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	İsteğe bağlı. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin.	prod
   --content-type	İsteğe bağlı. application/json İçeri aktarılan içeriğin bir Key Vault başvurusundan veya JSON dosyasından oluştuğunun belirtilip belirtildiğini girinappconfig/kvset.	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ı, gelecek değişikliklerin listesini görüntüler. öğesini seçerek yiçeri aktarmayı onaylayın.

   

Bir JSON dosyasından anahtar-değerleri içeri aktardıysanız, onlara "prod" etiketini ve "TestApp:" ön ekini atamıştını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ırması deposundan verileri içeri aktarma

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

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

Portal

Azure portal şu adımları izleyin:

1. Uygulama Yapılandırması deponuza gidin ve İşlemlermenüsünden İçeri/dışarı aktar'ı seçin.

   

2. İçeri Aktar sekmesinde, Kaynak hizmet'in altında Uygulama Yapılandırması'ı seçin.

3. Kaynak seç'i seçin, formu aşağıdaki parametrelerle doldurun ve Uygula'yı seçin:

   Parametre	Açıklama	Örnek
   Abonelik	Geçerli aboneliğiniz varsayılan olarak seçilidir.	aboneliğim
   Kaynak grubu	İçeri aktaracak yapılandırmaya sahip Uygulama Yapılandırması depoyu içeren 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ırması depoyu seçin.	my-other-app-config-store

   Not

   "Erişim anahtarları başarıyla getirildi" iletisi, Uygulama Yapılandırması deposuyla bağlantının başarılı olduğunu gösterir."

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

   Parametre	Açıklama	Örnek
   Etiketten	Karşılık gelen etiketleri içeren değerleri içeri aktarmak için en az bir etiket seçin. Tümünü seç anahtar-değerlerini herhangi bir etiketle içeri aktarır ve (Etiket yok) içeri aktarmayı etiketsiz anahtar-değerlerle kısıtlar.	Prod
   Belirli bir zamanda	İsteğe bağlı. Anahtar değerlerini belirli bir zaman noktasından içeri aktarmak için doldurun. Bu, seçilen yapılandırma deposundaki anahtar değerlerinin zamanıdır. Biçim: "YYYY-AA-GGThh:mm:ssZ". Bu alan, anahtar-değerlerin boş bırakıldığında geçerli noktasını varsayılan olarak kullanır.	28.07.2022 12:00:00
   Varsayılan anahtar-değer etiketlerini geçersiz kılma	İsteğe bağlı. Varsayılan olarak, içeri aktarılan öğeler geçerli etiketlerini kullanır. Kutuyu işaretleyin ve bu varsayılanları özel bir etiketle geçersiz kılmak için bir etiket girin.	Yeni
   Varsayılan anahtar-değer içerik türünü geçersiz kıl	İsteğe bağlı. Varsayılan olarak, içeri aktarılan öğeler geçerli içerik türlerini kullanır. kutuyu işaretleyin ve İçeri aktarılan içeriğin Key Vault başvurusundan veya JSON dosyasından oluştuğunı belirtmek için İçerik türü altında başvuru veya JSON (uygulama/json) Key Vault seçin. İçerik türü yalnızca içeri aktarılan anahtar-değerler 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' şeklindedir ve bu parametre tarafından güncelleştirilmez.	JSON (application/json)

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

28 Ocak 2021 tarihinde saat 12:00'de bir Uygulama Yapılandırması mağazasından "üretim" etiketine sahip anahtar-değerleri ve özellik bayraklarını içeri aktarmış ve onlara "new" etiketini atamıştınız. İçeri aktardığınız tüm anahtar-değerlerin içerik türü "JSON" olarak 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 Shell kullanabilirsiniz.

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

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

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

   Parametre	Açıklama	Örnek
   --label	İsteğe bağlı. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin.	new
   --content-type	İsteğe bağlı. İçeri aktarılan içeriğin bir Key Vault başvurusundan veya JSON dosyasından oluştuğunun belirtildiğini belirtmek için veya application/json girinappconfig/kvset. İçerik türü yalnızca içeri aktarılan anahtar-değerler için geçersiz kılınabilir. Özellik bayrakları için varsayılan içerik türü varsayılan olarak "application/vnd.microsoft.appconfig.ff+json;charset=utf-8' şeklindedir 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ı "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. öğesini seçerek yiçeri aktarmayı onaylayın.

   

Bir Uygulama Yapılandırması deposundan "prod" etiketine sahip anahtar değerlerini içeri aktarmış ve onlara "new" etiketini atamıştı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'dan verileri içeri aktarma

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

Not

App Service şu anda özellik bayraklarını desteklememektedir. App Service'a 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ğer içerebilir.

Portal

Azure portalından:

1. Uygulama Yapılandırması deponuza gidin ve İşlemlermenüsünden İçeri/dışarı aktar'ı seçin.

   

2. İçeri Aktar sekmesinde, Kaynak hizmet'in altında Uygulama Hizmetleri'ni seçin.

3. Kaynak seç'i seçin, formu aşağıdaki parametrelerle doldurun ve Uygula'yı seçin:

   Parametre	Açıklama	Örnek
   Abonelik	Geçerli aboneliğiniz varsayılan olarak seçilidir.	aboneliğim
   Kaynak grubu	İçeri aktaracak yapılandırmaya sahip App Service içeren bir kaynak grubu seçin.	my-resource-group
   Kaynak	İçeri aktarmak istediğiniz yapılandırmayı içeren App Service seçin.	my-app-service

   Not

   Kaynak App Service kaynağından başarıyla getirilen anahtar-değer sayısını gösteren bir ileti görüntülenir.

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

   Parametre	Açıklama	Örnek
   Ön ek	İsteğe bağlı. Anahtar ön eki, anahtar-değerlerin "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:
   Etiketle	İsteğe bağlı. Var olan bir etiketi seçin veya içeri aktarılan anahtar-değerlerinize atanacak yeni bir etiket girin.	Prod
   İçerik türü	İsteğe bağlı. İçeri aktardığınız dosyanın Key Vault başvurusu mu yoksa JSON dosyası mı olduğunu belirtin. Key Vault başvuruları hakkında daha fazla bilgi için bkz. ASP.NET Core uygulamasında Key Vault başvuruları kullanma.	JSON (application/json)

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

Bir App Service tüm uygulama ayarlarını anahtar-değer olarak içeri aktarıp bunlara "prod" etiketini ve "TestApp" ön ekini atadiniz. İçeri aktardığınız tüm anahtar-değerlerin içerik türü "JSON" olarak 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 Shell kullanabilirsiniz.

1. import komutunu 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ırması deposunun adını girin.	my-app-config-store
   --source	uygulama yapılandırma verilerini Azure App Service'dan içeri aktardığınızı belirtmek için girinappservice.	appservice
   --appservice-account	App Service ARM kimliğini girin veya Uygulama Yapılandırması ile aynı abonelikte ve kaynak grubundaysa App Service 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	İsteğe bağlı. 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	İsteğe bağlı. İçeri aktarılan anahtar-değerlerinize atanacak bir etiket girin. Bir etiket belirtmezseniz, null etiket anahtar-değerlerinize atanır.	prod
   --content-type	İsteğe bağlı. İç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

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

   Örnek: App Service tüm uygulama ayarlarını "prod" etiketiyle anahtar-değer olarak Uygulama Yapılandırması 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. öğesini seçerek yiçeri aktarmayı onaylayın.

   

App Service tüm uygulama ayarlarını anahtar-değer olarak içeri aktarmış, 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.

Verileri dışarı aktarma

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

Bu kılavuzda Uygulama Yapılandırması verileri dışarı aktarma işlemi gösterilmektedir:

• Json, Yaml veya Properties'de bir yapılandırma dosyasına
• Uygulama Yapılandırması mağazasına
• Azure App Service kaynağına

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 aşağıdaki adımları izleyin.

Not

Özellik bayraklarının bir Uygulama Yapılandırması deposundan yapılandırma dosyasına aktarılması şu anda yalnızca CLI'da desteklenmektedir.

Portal

Azure portal şu adımları izleyin:

1. Uygulama Yapılandırması mağazanıza göz atın ve İçeri/dışarı aktar'ı seçin.

   

2. Dışarı Aktar sekmesinde, Hedef hizmet'in altında Yapılandırma dosyası'nı seçin.

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

   Parametre	Açıklama	Örnek
   Ön ek	İsteğe bağlı. Bu ön ek, her bir anahtar-değerin "key" özelliğinden kırpılır. 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:
   Etiketten	Dışarı aktarma işleminizi belirli bir etiketle anahtar-değerlerle kısıtlamak için var olan bir etiketi seçin. Bir etiket seçmezseniz, varsayılan olarak yalnızca "Etiket Yok" etiketine sahip anahtar-değerler dışarı aktarılır. Aşağıdaki nota bakın.	Prod
   Belirli bir zamanda	İsteğe bağlı. Anahtar değerlerini belirli bir zaman noktasından içeri aktarmak için doldurun. Bu, seçilen yapılandırma deposundaki anahtar-değerlerin zaman noktasıdır. Biçim: "YYYY-AA-GGThh:mm:ssZ". Bu alan, boş bırakıldığında anahtar-değerlerin zamanındaki geçerli noktaya varsayılan olarak ayarlanır.	28.07.2022 12:00:00
   Dosya türü	Yaml, Özellikler veya Json arasında dışarı aktardığınız dosya türünü seçin.	JSON
   Ayırıcı	Ayırıcı, anahtar değerlerini Json/Yaml olarak düzleştirmeye yönelik sınırlayıcıdır. Yapılandırmanın hiyerarşik yapısını destekler ve özellik dosyalarına ve özellik bayraklarına uygulanmaz. Şu seçeneklerden birini belirleyin: ., ,, :, ;, /, -, _, — veya (Ayırıcı yok).	;

   Önemli

   Kimden etiketini seçmezseniz, yalnızca etiket içermeyen anahtar-değerler dışarı aktarılır. Etiketli bir anahtar-değeri dışarı aktarmak için, bu değerin etiketini seçmeniz gerekir. Anahtar değerlerini belirtilen tüm etiketlerle dışarı aktarmak istemeniz durumunda portalda dışarı aktarma başına yalnızca bir etiket seçebileceğinizi unutmayın. Lütfen CLI kullanın.

4. Dışarı aktarma işlemini tamamlamak için Dışarı Aktar'ı seçin.

28.07.2021 12:00:00'dan itibaren bir yapılandırma dosyasından "prod" etiketine sahip anahtar-değerleri dışarı aktarmış ve "TestApp" ön ekini kırpmışsınızdır. Değerler dosyada ";" ile ayrılı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 Shell kullanabilirsiniz.

1. Dışarı aktarma komutunu 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ırması deposunun adını girin.	my-app-config-store
   --destination	Verileri bir dosyaya aktardığınızı belirtmek için girin file .	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 veya propertiesjson girinyaml.	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, bunları ile ,ayırarak birkaç etiket girebilir veya tüm etiketleri hesapta almak 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ğeri 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	İsteğe bağlı. 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	İsteğe bağlı. 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 dışarı 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ı, dosyaya dışarı aktarılan anahtar-değerlerin listesini görüntüler. öğesini seçerek ydışarı aktarmayı onaylayın.

   

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

Daha fazla isteğe bağlı parametre ve örnek için az appconfig kv export sayfasına gidin.

Verileri bir Uygulama Yapılandırması deposuna aktarma

Anahtar-değerleri ve özellik bayraklarını bir Azure Uygulama Yapılandırması deposuna aktarmak için aşağıdaki adımları izleyin.

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

Portal

Azure portal şu adımları izleyin:

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

   

2. Dışarı Aktar sekmesinde Hedef hizmet'in altında Uygulama Yapılandırması'ı seçin.

3. Kaynak seç'i seçin, formu aşağıdaki parametrelerle doldurun ve Uygula'yı seçin:

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

4. Sayfada artık seçili Hedef hizmet ve kaynak kimliği görüntülenir. Kaynak seç eylemi, başka bir kaynak Uygulama Yapılandırması deposuna geçmenizi sağlar.

   Not

   Ekranda, anahtar-değerlerin başarıyla getirildiğini belirten bir ileti görüntülenir.

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

   Parametre	Açıklama	Örnek
   Etiketten	Değerleri ilgili etiketlerle dışarı aktarmak için en az bir etiket seçin. Tümünü seç , anahtar-değerleri herhangi bir etiketle dışarı aktarır ve (Etiket yok) dışarı aktarmayı etiketsiz anahtar-değerlerle kısıtlar.	Prod
   Belirli bir zamanda	İsteğe bağlı. Anahtar değerlerini belirli bir zaman noktasından içeri aktarmak için doldurun. Bu, seçilen yapılandırma deposundaki anahtar-değerlerin zaman noktasıdır. Biçim: "YYYY-AA-GGThh:mm:ssZ". Bu alan, boş bırakıldığında anahtar-değerlerin zamanındaki geçerli noktaya varsayılan olarak ayarlanır.	28.07.2022 12:00:00
   Varsayılan anahtar-değer etiketlerini geçersiz kıl	İsteğe bağlı. Varsayılan olarak, içeri aktarılan öğeler geçerli etiketlerini kullanır. Kutuyu işaretleyin ve bu varsayılanları özel bir etiketle geçersiz kılmak için bir etiket girin.	Yeni

6. Dışarı aktarma işlemine devam etmek için Uygula'yı seçin.

Bir Uygulama Yapılandırması deposundaki "prod" etiketine sahip anahtar-değerleri ve özellik bayraklarını 07/28/2022 12:00:00'dan itibaren durumlarında dışarı aktarmış ve onlara "new" etiketini atamıştınız.

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 Shell kullanabilirsiniz.

1. Dışarı aktarma komutunu 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ırması deposunun adını girin.	my-app-config-store
   --destination	Verileri bir Uygulama Yapılandırması deposuna aktardığınızı belirtmek için girinappconfig.	appconfig
   --dest-name	Verileri dışarı aktarmak istediğiniz Uygulama Yapılandırması 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, bunları ile ,ayırarak birkaç etiket girebilir veya tüm etiketleri hesaba eklemek için kullanabilirsiniz * .	prod

   Önemli

   Dışarı aktarmak istediğiniz anahtar-değerlerin etiketleri varsa, komutunu --label 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	İsteğe bağlı. Bu etiketi dışarı aktarılan anahtar-değerlere atamak için bir hedef etiket girin.	new

   Örnek: Anahtar-değerleri ve özellik bayraklarını "prod" etiketiyle başka bir Uygulama Yapılandırması 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ı, dosyalara dışarı aktarılan anahtar-değerlerin listesini görüntüler. öğesini seçerek dışarı aktarmayı yonaylayın.

   

Bir Uygulama Yapılandırması deposundan "prod" etiketine sahip anahtar-değerleri ve özellik bayraklarını dışarı aktarıp onlara "new" etiketini atadıysanı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 dışarı aktarma

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

Not

Özellik bayraklarının App Service dışarı aktarılması şu anda desteklenmemektedir.

Portal

Azure portal şu adımları izleyin:

1. Uygulama Yapılandırması deponuza gidin ve İşlemlermenüsünden İçeri/dışarı aktar'ı seçin.

   

2. Dışarı Aktar sekmesinde, Hedef hizmet'in altında Uygulama Hizmetleri'ni seçin.

3. Kaynak seç'i seçin, formu aşağıdaki parametrelerle doldurun ve Uygula'yı seçin:

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

4. Sayfa artık seçili Hedef hizmet ve kaynak kimliğini görüntüler. Kaynak seç eylemi, başka bir hedef App Service kaynağa geçmenizi sağlar.

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

   Parametre	Açıklama	Örnek
   Ön ek	İsteğe bağlı. Bu ön ek, dışarı aktarılan her anahtar-değerin "anahtar" özelliğinden kırpılır. 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:
   Başvuru olarak dışarı aktarma	İsteğe bağlı. Anahtar-değerleri Uygulama Yapılandırması başvuru olarak App Service dışarı aktarmak için denetleyin. Daha fazla bilgi edinin
   Belirli bir zamanda	İsteğe bağlı. Anahtar değerlerini belirli bir zaman noktasından dışarı aktarmak için doldurun. Bu, seçilen yapılandırma deposundaki anahtar değerlerinin zamanıdır. Biçim: "YYYY-AA-GGThh:mm:ssZ". Bu alan, anahtar-değerlerin boş bırakıldığında geçerli noktasını varsayılan olarak kullanır.	28.07.2022 12:00:00
   Etiketten	İsteğe bağlı. Dışarı aktarma işleminizi belirli bir etiketle anahtar-değerlerle kısıtlamak için var olan bir etiketi seçin. Bir etiket seçmezseniz, yalnızca "Etiket yok" etiketine sahip anahtar-değerler dışarı aktarılır.	Prod

6. Dışarı aktarma işlemine devam etmek için Uygula'yı seçin.

bir App Service kaynağından "üretim" etiketine sahip anahtar-değerleri, 28.07.2021 12.00:00'dan itibaren durumunda dışarı aktarmış ve "TestApp" ön ekini kırpmışsınızdır. Anahtar-değerler JSON biçiminde bir içerik türüyle dışarı aktarı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 Shell kullanabilirsiniz.

1. Dışarı aktarma komutunu 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ırması deposunun adını girin.	my-app-config-store
   --destination	Verileri App Service'a aktardığınızı belirtmek için girinappservice.	appservice
   --appservice-account	App Service ARM kimliğini girin veya Uygulama Yapılandırması ile aynı abonelikte ve kaynak grubundaysa App Service adını kullanın.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service veya my-app-service
   --label	İsteğe bağlı. 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

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

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

   Parametre	Açıklama	Örnek
   --prefix	İsteğe bağlı. 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ı, bir App Service kaynağına aktarılan anahtar-değerlerin listesini görüntüler. öğesini seçerek dışarı aktarmayı yonaylayın.

   

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

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

   Parametre	Açıklama
   --export-as-reference -r	İsteğe bağlı. Anahtar-değerlerin Uygulama Yapılandırması başvuru olarak App Service dışarı aktarılıp aktarılmayacağını belirtin. Daha fazla bilgi edinin.

   Örnek: Bir App Service uygulamaya uygulama yapılandırması başvuruları olarak "prod" etiketine sahip 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ı, bir App Service kaynağına uygulama yapılandırması başvuruları olarak dışarı aktarılan anahtar-değerlerin listesini görüntüler. öğesini seçerek dışarı aktarmayı yonaylayın.

   

   Bir Azure App Service kaynağına uygulama yapılandırması başvuruları olarak "prod" etiketine sahip tüm anahtar değerlerini dışarı aktarmıştı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 export sayfasına gidin.

Hata iletileri

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

• Seçili dosya 1 ile 2097152 bayt arasında olmalıdır.: Dosyanız çok büyük. Daha küçük bir dosya seçin.
• Deponuz için genel erişim devre dışı bırakıldı veya mağazanın özel uç nokta yapılandırmalarında bulunmayan özel bir uç noktadan erişiyor olabilirsiniz. Anahtar değerlerini bir Uygulama Yapılandırması deposundan içeri aktarmak için bu depoya erişiminiz olmalıdır. Gerekirse, kaynak depo için genel erişimi etkinleştirin veya onaylanan özel uç noktadan erişin. Genel erişimi etkinleştirdiyseniz önbelleğin yenilenmesi için 5 dakika kadar bekleyin.

Sonraki adımlar

CI/CD işlem hattıyla tümleştirme