Hızlı başlangıç: Azure Uygulama yapılandırmasıyla bir Python uygulaması oluşturma

Bu hızlı başlangıçta, Python Için Azure uygulama yapılandırma istemci kitaplığı'nı kullanarak uygulama ayarlarının depolanmasını ve yönetimini merkezileştirmek üzere Azure Uygulama yapılandırması 'nı kullanacaksınız.

Önkoşullar

• Azure aboneliği- ücretsiz olarak bir tane oluşturun
• python 2,7, veya 3,6 veya üzeri-Windows python 'u ayarlama hakkında daha fazla bilgi için, Windows belgelerindeki python 'a bakın

Uygulama yapılandırma deposu oluşturma

1. Yeni bir uygulama yapılandırma deposu oluşturmak için Azure Portaloturum açın. Giriş sayfasının sol üst köşesinde kaynak oluştur' u seçin. Market 'te Ara kutusuna uygulama yapılandırması ' nı girin ve ENTER' u seçin.

   

2. Arama sonuçlarından uygulama yapılandırması ' nı seçin ve ardından Oluştur' u seçin.

   

3. Uygulama yapılandırması oluştur bölmesinde, aşağıdaki ayarları girin:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Aboneliğiniz	Uygulama yapılandırmasını test etmek için kullanmak istediğiniz Azure aboneliğini seçin. Hesabınızda yalnızca bir abonelik varsa, bu otomatik olarak seçilir ve abonelik listesi gösterilmez.
   Kaynak grubu	AppConfigTestResources	Uygulama yapılandırma deposu kaynağınız için bir kaynak grubu seçin veya oluşturun. Bu grup, kaynak grubunu silerek aynı anda silmek isteyebileceğiniz birden çok kaynağı düzenlemek için yararlıdır. Daha fazla bilgi için Azure kaynaklarınızı yönetmek için kaynak gruplarını kullanma konusunu inceleyin.
   Kaynak adı	Genel olarak benzersiz bir ad	Uygulama yapılandırma deposu kaynağı için kullanılacak benzersiz bir kaynak adı girin. Ad, 5 ila 50 karakter arasında bir dize olmalı ve yalnızca rakam, harf ve - karakter içermelidir. Ad, karakteriyle başlayamaz veya bitemez - .
   Konum	Central US	Uygulama yapılandırma deponuzın barındırıldığı coğrafi konumu belirtmek için konum ' i kullanın. En iyi performansı elde etmek için, kaynağı uygulamanızın diğer bileşenleriyle aynı bölgede oluşturun.
   Fiyatlandırma katmanı	Ücretsiz	İstediğiniz fiyatlandırma katmanını seçin. Daha fazla bilgi için bkz. uygulama yapılandırma fiyatlandırma sayfası.

4. Ayarlarınızı doğrulamak için gözden geçir + oluştur ' u seçin.

5. Oluştur’u seçin. Dağıtım birkaç dakika sürebilir.

6. Dağıtım bittikten sonra uygulama yapılandırma kaynağına gidin. Ayarlar > Erişim anahtarları öğesini seçin. Birincil salt okunurdur anahtar bağlantı dizesini bir yere unutmayın. Uygulamanızı oluşturduğunuz uygulama yapılandırma deposuyla iletişim kuracak şekilde yapılandırmak için bu bağlantı dizesini daha sonra kullanacaksınız.

7. Aşağıdaki anahtar-değer çiftlerini eklemek için yapılandırma Gezgini anahtar değeri oluştur ' u seçin:

| Anahtar | Değer |
|---|---|
| TestApp: Ayarlar: ileti | Azure Uygulama yapılandırmasından veriler |

**Etiket** ve **içerik türü** şimdilik boş bırakın.

8. Uygula’yı seçin.

Python uygulamasını ayarlama

1. Bu öğreticide uygulama-yapılandırma-hızlı başlangıç adlı proje için yeni bir dizin oluşturacaksınız.

   mkdir app-configuration-quickstart
   

2. Yeni oluşturulan App-Configuration-QuickStart dizinine geçin.

   cd app-configuration-quickstart
   

3. Komutunu kullanarak Azure uygulama yapılandırma istemci kitaplığını yükler pip install .

   pip install azure-appconfiguration
   

4. App-Configuration-QuickStart dizininde App-Configuration-QuickStart.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 Quickstart")
       # Quickstart code goes here
   except Exception as ex:
       print('Exception:')
       print(ex)
   

Uygulama yapılandırma Bağlantı dizenizi yapılandırma

1. AZURE_APP_CONFIG_CONNECTION_STRING adlı bir ortam değişkeni ayarlayın ve bunu uygulama yapılandırma deponuzu için erişim anahtarı olarak ayarlayın. Komut satırında aşağıdaki komutu çalıştırın:

   setx AZURE_APP_CONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
   

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

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

   MacOS veya Linux kullanıyorsanız şu komutu çalıştırın:

   export AZURE_APP_CONFIG_CONNECTION_STRING='connection-string-of-your-app-configuration-store'
   

2. Değişikliğin etkili olması için komut istemi ' ni yeniden başlatın. Düzgün ayarlandığını doğrulamak için ortam değişkeninin değerini yazdırın.

Kod örnekleri

Bu bölümdeki örnek kod parçacıkları, Python için uygulama yapılandırması istemci kitaplığı ile genel işlemleri nasıl gerçekleştirekullanacağınızı göstermektedir. Bu kod parçacıklarını try daha önce oluşturduğunuz App-Configuration-QuickStart.py dosyasındaki bloğa ekleyin.

• uygulama yapılandırma deposuna Bağlan
• Yapılandırma ayarı al
• Yapılandırma ayarı Ekle
• Yapılandırma ayarlarının bir listesini alın
• Yapılandırma ayarını kilitle
• Yapılandırma ayarının kilidini aç
• Yapılandırma ayarını güncelleştirme
• Yapılandırma ayarını Sil

uygulama yapılandırma deposuna Bağlan

Aşağıdaki kod parçacığı, ortam değişkeninizde depolanan bağlantı dizesini kullanarak bir AzureAppConfigurationClient örneği oluşturur.

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

Yapılandırma ayarı al

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

    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ı Ekle

Aşağıdaki kod parçacığı, ConfigurationSetting ve alanları içeren bir nesne oluşturur key value ve yöntemini çağırır add_configuration_setting . Bu yöntem, deponuzda zaten var olan bir yapılandırma ayarı eklemeye çalışırsanız 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 bir listesini alın

Aşağıdaki kod parçacığı, yapılandırma ayarlarının bir listesini alır. key_filterVe label_filter bağımsız değişkenleri, anahtar değerlerini ve sırasıyla filtrelemek için belirtilebilir key label . 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ı kilitle

Uygulama yapılandırmasındaki bir anahtar-değer kilit durumu read_only nesnenin özniteliği tarafından gösterilir ConfigurationSetting . read_onlyİse True , ayar kilitlenir. set_read_onlyYöntemi, read_only=True yapılandırma ayarını kilitlemek için bağımsız değişkenle ç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ç

read_onlyÖğesinin özniteliği bir ConfigurationSetting ise False , ayarın kilidi açılır. set_read_onlyYöntemi, read_only=False yapılandırma ayarının kilidini açmak için bağımsız değişkenle ç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

set_configuration_settingYöntemi, var olan bir ayarı güncelleştirmek veya yeni bir ayar oluşturmak için kullanılabilir. Aşağıdaki kod parçacığı, varolan bir 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ı Sil

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

    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 hızlı başlangıçta, Azure portal aracılığıyla oluşturulan bir yapılandırma ayarı almak, yeni bir ayar eklemek, mevcut ayarların bir listesini almak, bir ayarı kilitlemek ve açmak, bir ayarı güncelleştirmek ve son olarak bir ayarı silmek için Azure uygulama yapılandırma istemci kitaplığını kullanan bir Python uygulaması oluşturdunuz.

Bu noktada, App-Configuration-QuickStart.py dosyanız aşağıdaki koda sahip olmalıdır:

import os
from azure.appconfiguration import AzureAppConfigurationClient, ConfigurationSetting

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

    connection_string = os.getenv('AZURE_APP_CONFIG_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)

Konsol pencerenizde, App-Configuration-QuickStart.py dosyasını içeren dizine gidin ve uygulamayı çalıştırmak için aşağıdaki Python komutunu yürütün:

python app-configuration-quickstart.py

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

Azure App Configuration - Python Quickstart

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, ücretlendirmemek için burada oluşturduğunuz kaynak grubunu silin.

1. Azure Portaloturum açın ve kaynak grupları' nı seçin.
2. Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
3. Sonuç listesinde, bir genel bakışı görmek için 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 hızlı başlangıçta yeni bir uygulama yapılandırma deposu oluşturdunuz ve bir Python uygulamasından anahtar değerlerine nasıl erişekullanacağınızı öğrendiniz.

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