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

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 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 Python 3.8-at vagy újabb verzióit. További információ a Python támogatott verzióiról: Azure SDKs Python-verziótámogatási szabályzat. Ha PyPyhaszná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ódot, az Azure-ral való hitelesítés a környezeti változókra támaszkodik, Python-alkalmazások Azure-szolgáltatásokban való hitelesítése a Pythonhoz készült Azure SDKhasználatával.

• A könyvtárcsomagok pippel való telepítéséhez használja a pip install <library_name>-t a csomagindexből. A könyvtárcsomagok telepítéséhez conda környezetekben használja az anaconda.org oldalon találhatóMicrosoft csatorna neveit conda install <package_name>. További információkért lásd: Azure könyvtárcsomagok telepítése.

• Különböző felügyeleti és ügyféloldali kó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 csatlakoztatása és használata ügyfélkódtárakkal

• A könyvtárak dokumentációja a Azure for Python referencia, amely az Azure szolgáltatás szerint van rendszerezve, illetve a Python API böngésző, amely csomagnév alapján van rendszerezve, található.

• A kódtárak kipróbálásához először azt javasoljuk, állítsa be a helyi fejlesztői környezetet. Ezután a következő különálló példák bármelyikét kipróbálhatja (bármilyen sorrendben): Példa: 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, és Példa: Virtuális gép létrehozása.

• Bemutató videókért lásd: Az Azure SDK for Python (PyCon 2021) bemutatása és Azure SDK-k használata az Azure-erőforrások (PyCon 2020) használatához.

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

• Mivel a Azure CLI a felügyeleti kódtárak használatával python nyelven íródott, az Azure CLI-parancsokkal elvégezhető műveletek python-szkriptekből is elvégezhetők. A parancssori felület parancsai 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 kimenet (például kapcsolati sztringek) formázását stb. Így a parancssori felület (vagy annak megfelelője, Azure PowerShell) használata az automatikus 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 a mögöttes Azure REST API-alapulnak, í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.

• Megtalálhatja az Azure könyvtárak forráskódját a https://github.com/Azure/azure-sdk-for-python-on. 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 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önyvtárak a aktuális Azure SDK irányelveketkövetik.

  • 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, már nem kapják meg a Microsoft hivatalos támogatását és frissítéseit. További információért tekintse meg a Az Azure SDK-kódtárak frissítéseértesítést.

  • Az Azure SDK-k hiányzó biztonsági és teljesítményfrissítéseinek elkerülése érdekében 2023. március 31-ig frissítsen a legújabb Azure SDK-kódtárakra.

  • Az érintett Python-könyvtárak ellenőrzéséhez tekintse meg a Azure SDK elavult kiadásait Python.

• A kódtárakra vonatkozó irányelvekkel kapcsolatos részletekért lásd a Python-irányelvek: Bevezetés.

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árak, amelyek nevei 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óért lásd: 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 hajthassa végre, amelyeket az Azure Portal vagy az Azure CLI-keresztül is elvégezhet. (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:

• Erőforráscsoport létrehozása
• Előfizetés erőforráscsoportjainak listázása
• Azure Storage-fiók és blobtároló létrehozása
• Webalkalmazás létrehozása és üzembe helyezése az App Service
• Azure MySQL-adatbázis létrehozása és lekérdezése
• Virtuális gép létrehozása

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

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 a ServicePrincipalCredentials osztályt használja, olvassa el a Hitelesítés jogkivonat-hitelesítő adatokkalcímű témakört.
• Az aszinkron API-k neve megváltozott az kódtár használati mintáiban leírtak szerint – aszinkron műveletek. Az aszinkron API-k neve az újabb kódtárakban begin_kezdődik. A legtöbb esetben az API-aláírás ugyanaz marad.

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

Az SDK ügyféloldali (vagy "adatsík") kódtárak 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 cikk, Példa: Az Azure Storagehasználata, az ügyfélkódtár használatának alapszintű illusztrációját tartalmazza.

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:

• alkalmazás üzemeltetése
• Kognitív szolgáltatások
• adatmegoldások
• Identitás és biztonsági
• Gépi tanulási
• Üzenetkezelés és IoT-
• Egyéb szolgáltatások

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

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

• Tekintse meg a Pythonhoz készült Azure-kódtárakat
• Tegyél fel kérdéseket a közösségnek a Stack Overflow
• Az SDK-val kapcsolatos nyitott hibajegyek a GitHubon
• Említsd meg @AzureSDK a Twitteren
• Végezzen el egy rövid felmérést 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.