Python için Azure SDK ile Python uygulaması oluşturma

Bu belgede, Azure Uygulaması Yapılandırması'ndaki verilerinize erişmek için Python için Azure SDK'nın nasıl kullanılacağına ilişkin örnekler gösterilir.

İpucu

Uygulama Yapılandırması, Python SDK'sının üzerinde oluşturulmuş ve daha zengin özelliklerle kullanımı daha kolay olacak şekilde tasarlanmış bir Python sağlayıcı kitaplığı sunar. Yapılandırma ayarlarının sözlük gibi kullanılmasını sağlar ve birden çok etiketten yapılandırma oluşturma, anahtar adı kırpma ve Key Vault başvurularının otomatik çözünürlüğü gibi diğer özellikleri sunar. Daha fazla bilgi edinmek için Python hızlı başlangıcına gidin.

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Python 3.8 veya üzeri - Windows'ta Python'ı ayarlama hakkında bilgi için Windows üzerinde Python belgelerine bakın
• Mağaza oluşturma öğreticisinde gösterildiği gibi bir Uygulama Yapılandırma deposu.

Anahtar-değer oluşturma

Uygulama Yapılandırması deposuna aşağıdaki anahtar değerini ekleyin ve Etiket ve İçerik Türü değerlerini varsayılan değerleriyle bırakın. Azure portalını veya CLI'yı kullanarak bir depoya anahtar-değer ekleme hakkında daha fazla bilgi için Anahtar-değer oluşturma bölümüne gidin.

Anahtar	Değer
TestApp:Ayarlar:İleti	Azure Uygulaması Yapılandırmasından Veriler

Python uygulamasını ayarlama

1. Proje için app-configuration-example adlı yeni bir dizin oluşturun.

   mkdir app-configuration-example
   

2. Yeni oluşturulan app-configuration-example dizinine geçin.

   cd app-configuration-example
   

3. komutunu kullanarak Azure Uygulaması Yapılandırması istemci kitaplığını pip install yükleyin.

   pip install azure-appconfiguration
   

4. app-configuration-example dizininde app-configuration-example.py adlı yeni bir dosya oluşturun ve aşağıdaki kodu ekleyin:

   import os
   from azure.appconfiguration import AzureAppConfigurationClient, ConfigurationSetting
   
   try:
       print("Azure App Configuration - Python example")
       # Example code goes here
   except Exception as ex:
       print('Exception:')
       print(ex)
   

Not

Bu örnekteki kod parçacıkları Python için Uygulama Yapılandırması istemci kitaplığını kullanmaya başlamanıza yardımcı olacaktır. Uygulamanız için özel durumları gereksinimlerinize göre işlemeyi de göz önünde bulundurmanız gerekir. Özel durum işleme hakkında daha fazla bilgi edinmek için lütfen Python SDK belgelerimize bakın.

Kod örnekleri

Bu bölümdeki örnek kod parçacıkları, Python için Uygulama Yapılandırması istemci kitaplığıyla ortak işlemlerin nasıl gerçekleştirileceğini gösterir. Bu kod parçacıklarını try daha önce oluşturduğunuz app-configuration-example.py dosyasındaki bloğa ekleyin.

Not

Uygulama Yapılandırması istemci kitaplığı, anahtar-değer nesnesine olarak ConfigurationSettingbaşvurur. Bu nedenle, bu makalede, Uygulama Yapılandırması deposundaki anahtar-değerler yapılandırma ayarları olarak adlandırılır.

Aşağıdakilerin nasıl yapılacağını öğrenin:

• Uygulama Yapılandırması deposuna bağlanma
• Yapılandırma ayarı alma
• Yapılandırma ayarı ekleme
• Yapılandırma ayarlarının listesini alma
• Yapılandırma ayarını kilitleme
• Yapılandırma ayarının kilidini açma
• Yapılandırma ayarını güncelleştirme
• Yapılandırma ayarını silme

Uygulama Yapılandırması deposuna bağlanma

Aşağıdaki kod parçacığı bir AzureAppConfigurationClient örneği oluşturur. Microsoft Entra Id (önerilen) veya bir bağlantı dizesi kullanarak Uygulama Yapılandırması mağazanıza bağlanabilirsiniz.

Microsoft Entra Id (önerilen)

Uygulama Yapılandırması deponuzda kimlik doğrulaması yapmak için öğesini kullanırsınızDefaultAzureCredential. Kimlik bilgilerinizi Uygulama Yapılandırması Veri Okuyucusu rolü atamak için yönergeleri izleyin. Uygulamanızı çalıştırmadan önce iznin yayılması için yeterli süreye izin verdiğinden emin olun.

from azure.identity import DefaultAzureCredential

credential = DefaultAzureCredential()

endpoint = os.getenv('AZURE_APPCONFIG_ENDPOINT')
app_config_client = AzureAppConfigurationClient(base_url=endpoint, credential=credential)

Bağlantı dizesi

connection_string = os.getenv('AZURE_APPCONFIG_CONNECTION_STRING')
app_config_client = AzureAppConfigurationClient.from_connection_string(connection_string)

Yapılandırma ayarı alma

Aşağıdaki kod parçacığı ada göre key bir yapılandırma ayarı alır.

retrieved_config_setting = app_config_client.get_configuration_setting(key='TestApp:Settings:Message')
print("\nRetrieved configuration setting:")
print("Key: " + retrieved_config_setting.key + ", Value: " + retrieved_config_setting.value)

Yapılandırma ayarı ekleme

Aşağıdaki kod parçacığı ve ConfigurationSetting alanlarıyla key bir value nesne oluşturur ve yöntemini çağırıradd_configuration_setting. Deponuzda zaten var olan bir yapılandırma ayarı eklemeye çalışırsanız bu yöntem bir özel durum oluşturur. Bu özel durumdan kaçınmak istiyorsanız, bunun yerine set_configuration_setting yöntemi kullanılabilir.

config_setting = ConfigurationSetting(
    key='TestApp:Settings:NewSetting',
    value='New setting value'
)
added_config_setting = app_config_client.add_configuration_setting(config_setting)
print("\nAdded configuration setting:")
print("Key: " + added_config_setting.key + ", Value: " + added_config_setting.value)

Yapılandırma ayarlarının listesini alma

Aşağıdaki kod parçacığı yapılandırma ayarlarının listesini alır. key_filter ve label_filter bağımsız değişkenleri sırasıyla ve key temelinde label anahtar-değerleri filtrelemek için sağlanabilir. Filtreleme hakkında daha fazla bilgi için bkz. Yapılandırma ayarlarını sorgulama.

filtered_settings_list = app_config_client.list_configuration_settings(key_filter="TestApp*")
print("\nRetrieved list of configuration settings:")
for item in filtered_settings_list:
    print("Key: " + item.key + ", Value: " + item.value)

Yapılandırma ayarını kilitleme

Uygulama Yapılandırması anahtar değerinin kilit durumu, nesnenin read_onlyConfigurationSetting özniteliğiyle belirtilir. ise read_onlyTrue, ayar kilitlidir. yöntemi, set_read_only yapılandırma ayarını kilitlemek için bağımsız değişkenle read_only=True çağrılabilir.

locked_config_setting = app_config_client.set_read_only(added_config_setting, read_only=True)
print("\nRead-only status for " + locked_config_setting.key + ": " + str(locked_config_setting.read_only))

Yapılandırma ayarının kilidini açma

read_only özniteliği ConfigurationSetting ise Falseayarın kilidi açılır. yöntemi, set_read_only yapılandırma ayarının kilidini açmak için bağımsız değişkenle read_only=False çağrılabilir.

unlocked_config_setting = app_config_client.set_read_only(locked_config_setting, read_only=False)
print("\nRead-only status for " + unlocked_config_setting.key + ": " + str(unlocked_config_setting.read_only))

Yapılandırma ayarını güncelleştirme

yöntemi set_configuration_setting mevcut bir ayarı güncelleştirmek veya yeni bir ayar oluşturmak için kullanılabilir. Aşağıdaki kod parçacığı, mevcut yapılandırma ayarının değerini değiştirir.

added_config_setting.value = "Value has been updated!"
updated_config_setting = app_config_client.set_configuration_setting(added_config_setting)
print("\nUpdated configuration setting:")
print("Key: " + updated_config_setting.key + ", Value: " + updated_config_setting.value)

Yapılandırma ayarını silme

Aşağıdaki kod parçacığı bir yapılandırma ayarını ada göre key siler.

deleted_config_setting = app_config_client.delete_configuration_setting(key="TestApp:Settings:NewSetting")
print("\nDeleted configuration setting:")
print("Key: " + deleted_config_setting.key + ", Value: " + deleted_config_setting.value)

Uygulamayı çalıştırma

Bu örnekte, Azure portalı aracılığıyla oluşturulan bir yapılandırma ayarını almak, yeni bir ayar eklemek, var olan ayarların listesini almak, bir ayarı kilitleyip kilidini açmak, bir ayarı güncelleştirmek ve son olarak bir ayarı silmek için Azure Uygulaması Yapılandırma istemci kitaplığını kullanan bir Python uygulaması oluşturdunuz.

Bu noktada, app-configuration-example.py dosyanızda aşağıdaki kod bulunmalıdır:

Microsoft Entra Id (önerilen)

import os
from azure.identity import DefaultAzureCredential
from azure.appconfiguration import AzureAppConfigurationClient, ConfigurationSetting

try:
    print("Azure App Configuration - Python example")
    # Example code goes here

    credential = DefaultAzureCredential()
    endpoint = os.getenv('AZURE_APPCONFIG_ENDPOINT')
    app_config_client = AzureAppConfigurationClient(base_url=endpoint, credential=credential)

    retrieved_config_setting = app_config_client.get_configuration_setting(key='TestApp:Settings:Message')
    print("\nRetrieved configuration setting:")
    print("Key: " + retrieved_config_setting.key + ", Value: " + retrieved_config_setting.value)

    config_setting = ConfigurationSetting(
        key='TestApp:Settings:NewSetting',
        value='New setting value'
    )
    added_config_setting = app_config_client.add_configuration_setting(config_setting)
    print("\nAdded configuration setting:")
    print("Key: " + added_config_setting.key + ", Value: " + added_config_setting.value)

    filtered_settings_list = app_config_client.list_configuration_settings(key_filter="TestApp*")
    print("\nRetrieved list of configuration settings:")
    for item in filtered_settings_list:
        print("Key: " + item.key + ", Value: " + item.value)

    locked_config_setting = app_config_client.set_read_only(added_config_setting, read_only=True)
    print("\nRead-only status for " + locked_config_setting.key + ": " + str(locked_config_setting.read_only))

    unlocked_config_setting = app_config_client.set_read_only(locked_config_setting, read_only=False)
    print("\nRead-only status for " + unlocked_config_setting.key + ": " + str(unlocked_config_setting.read_only))

    added_config_setting.value = "Value has been updated!"
    updated_config_setting = app_config_client.set_configuration_setting(added_config_setting)
    print("\nUpdated configuration setting:")
    print("Key: " + updated_config_setting.key + ", Value: " + updated_config_setting.value)

    deleted_config_setting = app_config_client.delete_configuration_setting(key="TestApp:Settings:NewSetting")
    print("\nDeleted configuration setting:")
    print("Key: " + deleted_config_setting.key + ", Value: " + deleted_config_setting.value)

except Exception as ex:
    print('Exception:')
    print(ex)

Bağlantı dizesi

import os
from azure.appconfiguration import AzureAppConfigurationClient, ConfigurationSetting

try:
    print("Azure App Configuration - Python example")
    # Example code goes here

    connection_string = os.getenv('AZURE_APPCONFIG_CONNECTION_STRING')
    app_config_client = AzureAppConfigurationClient.from_connection_string(connection_string)

    retrieved_config_setting = app_config_client.get_configuration_setting(key='TestApp:Settings:Message')
    print("\nRetrieved configuration setting:")
    print("Key: " + retrieved_config_setting.key + ", Value: " + retrieved_config_setting.value)

    config_setting = ConfigurationSetting(
        key='TestApp:Settings:NewSetting',
        value='New setting value'
    )
    added_config_setting = app_config_client.add_configuration_setting(config_setting)
    print("\nAdded configuration setting:")
    print("Key: " + added_config_setting.key + ", Value: " + added_config_setting.value)

    filtered_settings_list = app_config_client.list_configuration_settings(key_filter="TestApp*")
    print("\nRetrieved list of configuration settings:")
    for item in filtered_settings_list:
        print("Key: " + item.key + ", Value: " + item.value)

    locked_config_setting = app_config_client.set_read_only(added_config_setting, read_only=True)
    print("\nRead-only status for " + locked_config_setting.key + ": " + str(locked_config_setting.read_only))

    unlocked_config_setting = app_config_client.set_read_only(locked_config_setting, read_only=False)
    print("\nRead-only status for " + unlocked_config_setting.key + ": " + str(unlocked_config_setting.read_only))

    added_config_setting.value = "Value has been updated!"
    updated_config_setting = app_config_client.set_configuration_setting(added_config_setting)
    print("\nUpdated configuration setting:")
    print("Key: " + updated_config_setting.key + ", Value: " + updated_config_setting.value)

    deleted_config_setting = app_config_client.delete_configuration_setting(key="TestApp:Settings:NewSetting")
    print("\nDeleted configuration setting:")
    print("Key: " + deleted_config_setting.key + ", Value: " + deleted_config_setting.value)

except Exception as ex:
    print('Exception:')
    print(ex)

1. Ortam değişkeni yapılandırma

   Microsoft Entra Id (önerilen)

   AZURE_APPCONFIG_ENDPOINT adlı ortam değişkenini Azure portalındaki mağazanıza genel bakış bölümünde bulunan Uygulama Yapılandırması deponuzun uç noktasına ayarlayın.

   Windows komut istemini kullanıyorsanız, aşağıdaki komutu çalıştırın ve değişikliğin etkili olması için komut istemini yeniden başlatın:

   setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
   

   PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:

   $Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
   

   macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:

   export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
   

   Bağlantı dizesi

   AZURE_APPCONFIG_CONNECTION_STRING adlı ortam değişkenini Azure portalındaki mağazanızın Erişim anahtarları altında bulunan Uygulama Yapılandırması deponuzun salt okunur bağlantı dizesi ayarlayın.

   Windows komut istemini kullanıyorsanız, aşağıdaki komutu çalıştırın ve değişikliğin etkili olması için komut istemini yeniden başlatın:

   setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
   

   PowerShell kullanıyorsanız aşağıdaki komutu çalıştırın:

   $Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
   

   macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:

   export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
   

2. Ortam değişkeni düzgün şekilde ayarlandıktan sonra konsol pencerenizde app-configuration-example.py dosyasını içeren dizine gidin ve uygulamayı çalıştırmak için aşağıdaki Python komutunu çalıştırın:

   python app-configuration-example.py
   

   Aşağıdaki çıkışı görmeniz gerekir:

   Azure App Configuration - Python example
   
   Retrieved configuration setting:
   Key: TestApp:Settings:Message, Value: Data from Azure App Configuration
   
   Added configuration setting:
   Key: TestApp:Settings:NewSetting, Value: New setting value
   
   Retrieved list of configuration settings:
   Key: TestApp:Settings:Message, Value: Data from Azure App Configuration
   Key: TestApp:Settings:NewSetting, Value: New setting value
   
   Read-only status for TestApp:Settings:NewSetting: True
   
   Read-only status for TestApp:Settings:NewSetting: False
   
   Updated configuration setting:
   Key: TestApp:Settings:NewSetting, Value: Value has been updated!
   
   Deleted configuration setting:
   Key: TestApp:Settings:NewSetting, Value: Value has been updated!
   

Kaynakları temizleme

Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız ücretlerden kaçınmak için burada oluşturduğunuz kaynak grubunu silin.

Önemli

Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Bu makalenin kaynaklarını, saklamak istediğiniz diğer kaynakları içeren bir kaynak grubu içinde oluşturduysanız, kaynak grubunu silmek yerine her kaynağı ilgili bölmeden tek tek silin.

1. Azure portalında oturum açın ve Kaynak grupları'nı seçin.
2. Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
3. Genel bir bakış görmek için sonuç listesinde kaynak grubu adını seçin.
4. Kaynak grubunu sil'i seçin.
5. Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil'i seçin.

Birkaç dakika sonra kaynak grubu ve tüm kaynakları silinir.

Sonraki adımlar

Bu kılavuzda, Azure Uygulaması Yapılandırması'ndaki verilerinize erişmek için Python için Azure SDK'nın nasıl kullanılacağı gösterildi.

Ek kod örnekleri için şu adresi ziyaret edin:

Azure Uygulaması Yapılandırma istemci kitaplığı örnekleri

Python uygulamalarıyla Azure Uygulaması Yapılandırması'nı kullanmayı öğrenmek için şuraya gidin:

Azure Uygulaması Yapılandırması ile Python uygulaması oluşturma