Az Azure-kódtárak (SDK) használata Pythonhoz

Cikk
10/23/2023

A Pythonhoz készült nyílt forráskódú Azure-kódtárak leegyszerűsítik az Azure-erőforrások Python-alkalmazáskódból való kiépítését, kezelését és használatát.

Azokat a részleteket, amelyeket igazán tudni szeretne

Az Azure-kódtárak segítségével kommunikálhat az Azure-szolgáltatásokkal a helyileg vagy a felhőben futtatott Python-kódból . (Attól függ, hogy egy adott szolgáltatás hatókörén belül futtatható-e Python-kód, attól függ, hogy maga a szolgáltatás jelenleg támogatja-e a Pythont.)
A kódtárak támogatják a Python 3.8-at vagy újabb verziót. A Python támogatott verzióiról további információt az Azure SDKs Python verziótámogatási szabályzatában talál. Ha PyPy-t használ, győződjön meg arról, hogy a használt verzió legalább a korábban említett Python-verziót támogatja.
Az Azure SDK for Python több mint 180 egyéni Python-kódtárból áll, amelyek meghatározott Azure-szolgáltatásokhoz kapcsolódnak. Az SDK-ban nincsenek más eszközök.
Ha helyileg futtat kódokat, az Azure-ral való hitelesítés a Pythonhoz készült Azure SDK használatával a Python-alkalmazások Azure-szolgáltatásokban való hitelesítéséről szóló cikkben ismertetett környezeti változókra támaszkodik.
A kódtárcsomagok pipkel való telepítéséhez használja pip install <library_name> a csomagindex kódtárneveit. A kódtárcsomagok Conda-környezetekben való telepítéséhez használja conda install <package_name> a Microsoft-csatorna neveit a anaconda.org. További információ: Azure-kódtárcsomagok telepítése.
Különböző felügyeleti és ügyfélkódtárak (más néven "felügyeleti sík" és "adatsík" kódtárak). Minden készlet különböző célokat szolgál, és különböző kódtípusok használják. További információkért tekintse meg a cikk későbbi szakaszait:
- Azure-erőforrások létrehozása és kezelése felügyeleti kódtárakkal
- Azure-erőforrások Csatlakozás és használata ügyfélkódtárakkal
A kódtárak dokumentációja megtalálható az Azure for Python-referenciában, amelyet az Azure Service vagy a Python API böngésző szervez csomagnév alapján.
A kódtárak kipróbálásához először javasoljuk a helyi fejlesztői környezet beállítását. Ezután a következő különálló példák bármelyikét kipróbálhatja (bármilyen sorrendben): Például: Erőforráscsoport létrehozása, Példa: Azure Storage létrehozása és használata, Példa: Webalkalmazás létrehozása és üzembe helyezése, Példa: MySQL-adatbázis létrehozása és lekérdezése, valamint példa: Virtuális gép létrehozása.
Bemutató videókért tekintse meg az Azure SDK for Python (PyCon 2021) és az Azure SDK-k használata Azure-erőforrásokkal való interakcióját (PyCon 2020).

Nem alapvető, de mégis érdekes részletek

Mivel az Azure CLI a felügyeleti kódtárak használatával van megírva a Pythonban, az Azure CLI-parancsokkal bármilyen műveletet elvégezhet Egy Python-szkriptből is. A CLI-parancsok számos hasznos funkciót biztosítanak, például több feladat együttes végrehajtását, az aszinkron műveletek automatikus kezelését, a kimenetek (például kapcsolati sztring) formázását stb. Így a parancssori felület (vagy annak megfelelője, az Azure PowerShell) használata az automatizált létrehozási és felügyeleti szkriptekhez kényelmesebb lehet, mint az egyenértékű Python-kód megírása, hacsak nem szeretne sokkal pontosabban szabályozni a folyamatot.
A PythonHoz készült Azure-kódtárak az alapul szolgáló Azure REST API-ra épülnek, így ezeket az API-kat ismerős Python-paradigmákon keresztül használhatja. A REST API-t azonban igény szerint közvetlenül a Python-kódból is használhatja.
Az Azure-kódtárak https://github.com/Azure/azure-sdk-for-pythonforráskódját itt találja. Nyílt forráskódú projektként szívesen vesszük a közreműködést!
Bár a kódtárakat olyan értelmezőkkel használhatja, mint az IronPython és a Jython, amelyeken nem tesztelünk, elszigetelt problémákba és inkompatibilitásba ütközhet.
A kódtár API referenciadokumentációjának forrás-adattára a következő helyen https://github.com/MicrosoftDocs/azure-docs-sdk-python/található: .
2019-től kezdve frissítettük az Azure Python-kódtárakat olyan gyakori felhőbeli minták megosztására, mint a hitelesítési protokollok, a naplózás, a nyomkövetés, az átviteli protokollok, a pufferelt válaszok és az újrapróbálkozások. A frissített kódtárak megfelelnek az Azure SDK aktuális irányelveinek.
- 2023. március 31-én megszüntettük az Azure SDK-kódtárak támogatását, amelyek nem felelnek meg a jelenlegi Azure SDK-irányelveknek. Bár a régebbi kódtárak 2023. március 31-e után is használhatók, a Microsoft már nem kap hivatalos támogatást és frissítéseket. További információ: Az Azure SDK-kódtárak frissítése című közlemény.
- Az Azure SDK-k biztonsági és teljesítményfrissítéseinek hiányának elkerülése érdekében 2023. március 31-ig frissítsen a legújabb Azure SDK-kódtárakra .
- Annak ellenőrzéséhez, hogy mely Python-kódtárakra van hatással, tekintse meg az Azure SDK elavult Python-kiadásait.
A kódtárakra vonatkozó irányelvekkel kapcsolatos részletekért tekintse meg a Python-irányelvek: Bevezetés című témakört.

Azure-erőforrások létrehozása és kezelése felügyeleti kódtárakkal

Az SDK felügyeleti (vagy "felügyeleti sík") kódtárai, amelyek nevével azure-mgmt-kezdődnek, segítenek létrehozni, konfigurálni és más módon kezelni az Azure-erőforrásokat Python-szkriptekből. Minden Azure-szolgáltatáshoz megfelelő felügyeleti kódtárak tartoznak. További információ: Azure vezérlősík és adatsík.

A felügyeleti kódtárakkal konfigurációs és üzembehelyezési szkripteket írhat, hogy ugyanazokat a feladatokat hajtsa végre, mint az Azure Portalon vagy az Azure CLI-ben. (Ahogy korábban említettük, az Azure CLI Pythonban van megírva, és a felügyeleti kódtárak használatával implementálja a különböző parancsokat.)

Az alábbi példák az elsődleges felügyeleti kódtárak némelyikének használatát szemléltetik:

Az egyes felügyeleti tárak kezelésével kapcsolatos részletekért tekintse meg az SDK GitHub-adattár könyvtárának projektmappájában található README.md vagy README.rst fájlt. További kódrészleteket a referenciadokumentációban és az Azure-mintákban is találhat.

Migrálás régebbi felügyeleti kódtárakból

Ha a felügyeleti kódtárak régebbi verzióiból telepít át kódot, tekintse meg az alábbi részleteket:

Ha az osztályt használja, olvassa el a ServicePrincipalCredentials Hitelesítés token hitelesítő adatokkal című témakört.
Az aszinkron API-k neve módosult a könyvtárhasználati mintákban leírtak szerint – aszinkron műveletek. Az újabb kódtárak aszinkron API-jainak nevei a következővel begin_kezdődnek: . A legtöbb esetben az API-aláírás ugyanaz marad.

Azure-erőforrások Csatlakozás és használata ügyfélkódtárakkal

Az SDK ügyféloldali (vagy adatsíkos) kódtárai segítségével Python-alkalmazáskódot írhat a már kiépített szolgáltatásokkal való interakcióhoz. Az ügyfélkódtárak csak az ügyfél API-t támogató szolgáltatásokhoz léteznek.

A példa: Az Azure Storage használata című cikk alapvető illusztrációt nyújt az ügyfélkódtár használatáról.

A különböző Azure-szolgáltatások példákat is kínálnak ezekre a kódtárakra. További hivatkozásokért tekintse meg az alábbi indexoldalakat:

Az egyes ügyféltárak használatával kapcsolatos részletekért tekintse meg az SDK GitHub-adattárában, a tár projektmappájában található README.md vagy README.rst fájlt. További kódrészleteket a referenciadokumentációban és az Azure-mintákban is találhat.

Segítség kérése és csatlakozás az SDK-csapathoz

A Pythonhoz készült Azure-kódtárak megtekintése
Kérdések közzététele a közösségnek a Stack Overflow-on
Az SDK-val kapcsolatos problémák megnyitása a GitHubon
Említés @AzureSDK a Twitteren
Rövid felmérés befejezése a Pythonhoz készült Azure SDK-ról

Következő lépés

Határozottan javasoljuk, hogy a helyi fejlesztési környezet egyszeri beállítását végezze el, hogy könnyen használhassa a Pythonhoz készült Azure-kódtárakat.

A helyi fejlesztői környezet beállítása >>>