Hızlı Başlangıç: Azure Uygulaması Yapılandırması ile Python uygulaması oluşturma

Bu hızlı başlangıçta, Azure Uygulaması Yapılandırma Python sağlayıcısı istemci kitaplığını kullanarak uygulama ayarlarının depolamasını ve yönetimini merkezileştirmek için Azure Uygulaması Yapılandırması için Python sağlayıcısını kullanacaksınız.

Python Uygulama Yapılandırması sağlayıcısı, Python geliştiricilerinin Uygulama Yapılandırması hizmetini kolayca kullanmalarına yardımcı olan, Python için Azure SDK'nın üzerinde çalışan bir kitaplıktır. Yapılandırma ayarlarının sözlük gibi kullanılmasını sağlar.

Önkoşullar

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

Anahtar-değer ekleme

Uygulama Yapılandırması deposuna aşağıdaki anahtar değerlerini ekleyin. 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	Etiket	İçerik türü
ileti	Merhaba	Boş bırakın	Boş bırakın
test.mesajı	Merhaba testi	Boş bırakın	Boş bırakın
my_json	{"key":"value"}	Boş bırakın	application/json

Konsol uygulamaları

Bu bölümde bir konsol uygulaması oluşturacak ve Uygulama Yapılandırması deponuzdan veri yükleyeceksiniz.

Uygulama Yapılandırması bağlan

Proje için app-configuration-quickstart adlı yeni bir dizin oluşturun.
```
mkdir app-configuration-quickstart
```
Yeni oluşturulan app-configuration-quickstart dizinine geçin.
```
cd app-configuration-quickstart
```
komutunu kullanarak Azure Uygulaması Yapılandırma sağlayıcısını pip install yükleyin.
```
pip install azure-appconfiguration-provider
```

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

Microsoft Entra Id (önerilen)
Bağlantı dizesi

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.appconfiguration.provider import (
    load,
    SettingSelector
)
from azure.identity import DefaultAzureCredential
import os

endpoint = os.environ.get("AZURE_APPCONFIG_ENDPOINT")

# Connect to Azure App Configuration using Microsoft Entra ID.
config = load(endpoint=endpoint, credential=credential)
credential = DefaultAzureCredential()

# Find the key "message" and print its value.
print(config["message"])
# Find the key "my_json" and print the value for "key" from the dictionary.
print(config["my_json"]["key"])

# Connect to Azure App Configuration using Entra ID and trimmed key prefixes.
trimmed = {"test."}
config = load(endpoint=endpoint, credential=credential, trim_prefixes=trimmed)
# From the keys with trimmed prefixes, find a key with "message" and print its value.
print(config["message"])

# Connect to Azure App Configuration using SettingSelector.
selects = {SettingSelector(key_filter="message*", label_filter="\0")}
config = load(endpoint=endpoint, credential=credential, selects=selects)

# Print True or False to indicate if "message" is found in Azure App Configuration.
print("message found: " + str("message" in config))
print("test.message found: " + str("test.message" in config))

from azure.appconfiguration.provider import (
    load,
    SettingSelector
)
import os

connection_string = os.environ.get("AZURE_APPCONFIG_CONNECTION_STRING")

# Connect to Azure App Configuration using a connection string.
config = load(connection_string=connection_string)

# Find the key "message" and print its value.
print(config["message"])
# Find the key "my_json" and print the value for "key" from the dictionary.
print(config["my_json"]["key"])

# Connect to Azure App Configuration using a connection string and trimmed key prefixes.
trimmed = {"test."}
config = load(connection_string=connection_string, trim_prefixes=trimmed)
# From the keys with trimmed prefixes, find a key with "message" and print its value.
print(config["message"])

# Connect to Azure App Configuration using SettingSelector.
selects = {SettingSelector(key_filter="message*", label_filter="\0")}
config = load(connection_string=connection_string, selects=selects)

# Print True or False to indicate if "message" is found in Azure App Configuration.
print("message found: " + str("message" in config))
print("test.message found: " + str("test.message" in config))

Uygulamayı çalıştırma

Ortam değişkeni ayarlayın.
- Microsoft Entra Id (önerilen)
- Bağlantı dizesi
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>'
```
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>'
```
Ortam değişkeni düzgün şekilde ayarlandıktan sonra, uygulamayı yerel olarak çalıştırmak için aşağıdaki komutu çalıştırın:
```
python app-configuration-quickstart.py
```
Aşağıdaki çıkışı görmeniz gerekir:
```
Hello
value
Hello test
message found: True
test.message found: False
```

Web uygulamaları

Uygulama Yapılandırması sağlayıcısı, verileri sözlük olarak erişilebilen ve çeşitli Python çerçevelerinin mevcut yapılandırmasıyla birlikte kullanılabilen bir Mapping nesneye yükler. Bu bölümde flask ve Django gibi popüler web çerçevelerinde Uygulama Yapılandırması sağlayıcısının nasıl kullanılacağı gösterilmektedir.

Şişe
Django

Yerleşik yapılandırmasını güncelleştirerek mevcut Flask web uygulamalarınızda Azure Uygulaması Yapılandırması'nı kullanabilirsiniz. Bunu yapmak için Uygulama Yapılandırması sağlayıcı nesnenizi içindeki updateFlask uygulama örneğinizin işlevine app.py geçirebilirsiniz:

azure_app_config = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

# NOTE: This will override all existing configuration settings with the same key name.
app.config.update(azure_app_config)

# Access a configuration setting directly from within Flask configuration
message = app.config.get("message")

Dosyanıza aşağıdaki kod satırlarını ekleyerek mevcut Django web uygulamalarınızda Azure Uygulaması Yapılandırması'nı kullanabilirsiniz settings.py

AZURE_APPCONFIGURATION = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

Django görünümlerinde tek tek yapılandırma ayarlarına erişmek için bunlara Django ayarlarında oluşturulan sağlayıcı nesnesinden başvurabilirsiniz. Örneğin, içinde views.py:

# Import Django settings
from django.conf import settings

# Access a configuration setting from Django settings instance.
MESSAGE = settings.AZURE_APPCONFIGURATION.get("message")

Python web uygulamalarında Azure Uygulaması Yapılandırması'nın nasıl kullanılacağına ilişkin tam kod örnekleri Azure Uygulaması Configuration GitHub deposunda bulunabilir.

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.

Azure portalında oturum açın ve Kaynak grupları'nı seçin.
Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
Genel bir bakış görmek için sonuç listesinde kaynak grubu adını seçin.
Kaynak grubunu sil'i seçin.
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ırması deposu oluşturdunuz ve Python uygulamasından anahtar-değerlere erişmeyi öğrendiniz.

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

Django Örnek Flask Örneği Azure Uygulaması Yapılandırma Python sağlayıcısı

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2024-12-18