Mulai cepat: Membuat aplikasi Python dengan Azure App Configuration

Artikel
11/21/2023

Dalam mulai cepat ini, Anda akan menggunakan penyedia Python untuk Azure App Configuration untuk mempusatkan penyimpanan dan manajemen pengaturan aplikasi menggunakan pustaka klien penyedia Azure App Configuration Python.

Penyedia Python App Configuration adalah pustaka yang berjalan di atas Azure SDK untuk Python, membantu pengembang Python dengan mudah menggunakan layanan App Configuration. Ini memungkinkan pengaturan konfigurasi digunakan seperti kamus.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun gratis.
Penyimpanan App Configuration. Buat toko.
Python 3.8 atau yang lebih baru - untuk informasi tentang menyiapkan Python di Windows, lihat dokumentasi Python di Windows

Menambahkan nilai kunci

Tambahkan nilai kunci berikut ke penyimpanan App Configuration. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Tombol	Nilai	Label	Jenis konten
message	Halo	Biarkan kosong	Biarkan kosong
test.message	Tes Halo	Biarkan kosong	Biarkan kosong
my_json	{"key":"value"}	Biarkan kosong	application/json

Aplikasi konsol

Di bagian ini, Anda akan membuat aplikasi konsol dan memuat data dari penyimpanan App Configuration Anda.

Koneksi ke App Configuration

Buat direktori baru untuk proyek bernama app-configuration-quickstart.
```
mkdir app-configuration-quickstart
```
Beralih ke direktori app-configuration-quickstart yang baru dibuat.
```
cd app-configuration-quickstart
```
Instal penyedia Azure App Configuration dengan menggunakan pip install perintah .
```
pip install azure-appconfiguration-provider
```

Buat file baru yang bernama app-configuration-quickstart.py di direktori app-configuration-quickstart dan tambahkan kode berikut:

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))

Jalankan aplikasi

Atur variabel lingkungan bernama AZURE_APPCONFIG_CONNECTION_STRING, dan atur ke string koneksi penyimpanan App Configuration Anda. Pada baris perintah, jalankan perintah berikut ini:
Untuk menjalankan aplikasi secara lokal menggunakan perintah Windows, jalankan perintah berikut dan ganti <app-configuration-store-connection-string> dengan string koneksi penyimpanan konfigurasi aplikasi Anda:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
Jika Anda menggunakan Windows PowerShell, jalankan perintah berikut dan ganti <app-configuration-store-connection-string> dengan string koneksi penyimpanan konfigurasi aplikasi Anda:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<app-configuration-store-connection-string>"
```
Jika Anda menggunakan macOS, jalankan perintah berikut dan ganti <app-configuration-store-connection-string> dengan string koneksi penyimpanan konfigurasi aplikasi Anda:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Jika Anda menggunakan Linux, jalankan perintah berikut dan ganti <app-configuration-store-connection-string> dengan string koneksi penyimpanan konfigurasi aplikasi Anda:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Cetak nilai variabel lingkungan untuk memvalidasi bahwa variabel diatur dengan benar dengan perintah di bawah ini.
Dengan menggunakan prompt perintah Windows, mulai ulang perintah untuk memungkinkan perubahan diterapkan dan jalankan perintah berikut:
```
echo %AZURE_APPCONFIG_CONNECTION_STRING%
```
Jika Anda menggunakan PowerShell Windows, jalankan perintah berikut:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING
```
Jika Anda menggunakan macOS, jalankan perintah berikut:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Jika Anda menggunakan Linux, jalankan perintah berikut:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Setelah variabel lingkungan diatur dengan benar, jalankan perintah berikut untuk menjalankan aplikasi secara lokal:
```
python app-configuration-quickstart.py
```
Anda akan menemukan output berikut:
```
Hello
value
Hello test
message found: True
test.message found: False
```

Aplikasi web

Penyedia App Configuration memuat data ke dalam Mapping objek, dapat diakses sebagai kamus, yang dapat digunakan dalam kombinasi dengan konfigurasi yang ada dari berbagai kerangka kerja Python. Bagian ini menunjukkan cara menggunakan penyedia App Configuration dalam kerangka kerja web populer seperti Flask dan Django.

Labu
Django

Anda dapat menggunakan Azure App Configuration di aplikasi web Flask yang ada dengan memperbarui konfigurasi bawaannya. Anda dapat melakukan ini dengan meneruskan objek penyedia App Configuration Anda ke update fungsi instans aplikasi Flask Anda di app.py:

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

# 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")

Anda dapat menggunakan Azure App Configuration di aplikasi web Django yang ada dengan menambahkan baris kode berikut ke dalam file Anda settings.py

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

Untuk mengakses pengaturan konfigurasi individual dalam tampilan Django, Anda dapat mereferensikannya dari objek penyedia yang dibuat di pengaturan Django. Misalnya, dalam views.py:

# Import Django settings
from django.conf import settings

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

Sampel kode lengkap tentang cara menggunakan Azure App Configuration di aplikasi web Python dapat ditemukan di repositori GitHub Azure App Configuration .

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

Masuk ke portal Azure, lalu pilih Grup sumber daya.
Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
Pilih Hapus grup sumber daya.
Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat penyimpanan App Configuration baru dan mempelajari cara mengakses nilai kunci dari aplikasi Python.

Untuk sampel kode tambahan, kunjungi:

Sampel Django Flask Penyedia Python Azure App Configuration

Bagikan melalui