Mulai cepat: Membuat aplikasi Python dengan Azure App Configuration

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, seperti yang ditunjukkan dalam tutorial untuk membuat penyimpanan.
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	Etiket	Jenis konten
pesan	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.

Menyambungkan 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:

ID Microsoft Entra (disarankan)
String koneksi

Anda menggunakan DefaultAzureCredential untuk mengautentikasi ke penyimpanan App Configuration Anda. Ikuti instruksi untuk menetapkan kredensial Anda peran Pembaca Data App Configuration. Pastikan untuk mengizinkan waktu yang memadai agar izin disebarluaskan sebelum menjalankan aplikasi Anda.

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

Jalankan aplikasi

Atur variabel lingkungan.
- ID Microsoft Entra (disarankan)
- String koneksi
Atur variabel lingkungan bernama AZURE_APPCONFIG_ENDPOINT ke titik akhir penyimpanan App Configuration Anda yang ditemukan di bawah Gambaran Umum penyimpanan Anda di portal Azure.

Jika Anda menggunakan perintah Windows, jalankan perintah berikut dan hidupkan ulang perintah untuk memungkinkan perubahan berlaku:
```
setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
```
Jika Anda menggunakan PowerShell, jalankan perintah berikut:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
```
Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Atur variabel lingkungan bernama AZURE_APPCONFIG_CONNECTION_STRING ke string koneksi baca-saja penyimpanan App Configuration Anda yang ditemukan di bawah Kunci akses penyimpanan Anda di portal Azure.

Jika Anda menggunakan perintah Windows, jalankan perintah berikut dan hidupkan ulang perintah untuk memungkinkan perubahan berlaku:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
Jika Anda menggunakan PowerShell, jalankan perintah berikut:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
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(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")

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(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

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

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2024-12-18