Azurite emulátor telepítése és futtatása

Az Azurite emulátor használatával a fejlesztők internetkapcsolat nélkül is gyorsan nyomon követhetik a felhőalapú alkalmazások és eszközök fejlesztését.

Ez a cikk útmutatást nyújt az Azurite telepítéséhez és futtatásához, valamint a helyi fejlesztéshez való konfigurálásához. További információ az Azurite használatáról: Az Azurite emulátor használata helyi Azure Storage-fejlesztéshez.

Az Azurite felülírja az Azure Storage Emulatort, és folyamatosan frissül, hogy támogassa az Azure Storage API-k legújabb verzióit.

Az Azurite telepítése

Az Azurite különböző módszerekkel telepíthető és futtatható, például npm, Docker és Visual Studio Code használatával. Ez a videó bemutatja, hogyan telepítheti és futtathatja az Azurite emulátort.

A videó lépéseit a következő szakaszokban is ismertetjük. Az alábbi fülek bármelyikével megtekintheti a környezetére vonatkozó konkrét utasításokat.

Visual Studio

Az Azurite automatikusan elérhető a Visual Studio 2022-ben. Az Azurite végrehajtható verziója az új Visual Studio-verziók részeként frissül. Ha a Visual Studio egy korábbi verzióját futtatja, telepítheti az Azurite-t a Node Csomagkezelő (npm), a DockerHub vagy az Azurite GitHub-adattár klónozásával.

Visual Studio Code

A Visual Studio Code-ban válassza a Bővítmények ikont, és keresse meg az Azurite-ot. Kattintson a Telepítés gombra az Azurite-bővítmény telepítéséhez.

A Visual Studio Code bővítménypiacára is navigálhat a böngészőben. A Telepítés gombra kattintva nyissa meg a Visual Studio Code-ot, és lépjen közvetlenül az Azurite bővítményoldalra.

Az azurite-bővítmény beállításainak konfigurálása

Az Azurite-beállítások Visual Studio Code-on belüli konfigurálásához válassza a Bővítmények ikont. Válassza a Fogaskerék kezelése gombot az Azurite-bejegyzéshez . Válassza a Bővítménybeállítások lehetőséget.

A következő beállítások támogatottak:

Setting	Description	Alapértelmezett beállítás
azurite.blobHost	A Blob szolgáltatás figyelési végpontja.	127.0.0.1
azurite.blobPort	A Blob szolgáltatás figyelési portja.	10000
azurite.queueHost	A Queue szolgáltatás figyelési végpontja.	127.0.0.1
azurite.queuePort	A Queue szolgáltatás figyelési portja.	10001
azurite.tableHost	A Table service figyelő végpontja.	127.0.0.1
azurite.tablePort	A Table szolgáltatás figyelőportja.	10002
azurite.cert	A HTTPS mód engedélyezéséhez egy helyileg megbízható PEM- vagy PFX-tanúsítványfájl elérési útja.
azurite.debug	Adja ki a hibakeresési naplót az Azurite-csatornára.	hamis
azurite.key	Egy helyileg megbízható PEM-kulcsfájl elérési útja, amely akkor szükséges, ha az Azurite: Cert egy PEM-fájlra mutat.
azurite.location	A munkaterület helyének elérési útja.	Visual Studio Code munkamappa
azurite.loose	Engedélyezze a laza módot, amely figyelmen kívül hagyja a nem támogatott fejléceket és paramétereket.	hamis
azurite.oauth	Nem kötelező OAuth szint.	None
azurite.pwd	A PFX-fájl jelszava. Kötelező, amikor a Azurite: Cert egy PFX-fájlra mutat.
azurite.silent	A csendes mód letiltja a hozzáférési naplót.	hamis
azurite.skipApiVersionCheck	Hagyja ki a kérelem API-verzióellenőrzését.	hamis
azurite.disableProductStyleUrl	A tárfiók nevének kinyerését a kérés URI-útvonalából kényszerítse ki a kérés URI gazdagépneve helyett.	hamis
azurite.inMemoryPersistence	Tiltsa le az adatok lemezen való megőrzését, és csak a memóriában tárolja az adatokat.	hamis
azurite.extentMemoryLimit	A memóriabeli tárterület (blob- és üzenetsor-tartalom esetén) korlátja megabájtban.	A gazdagépen található teljes memória 50%-a
azurite.disableTelemetry	Tiltsa le a telemetriai adatok gyűjtését az aktuális Azurite-futtatás során.	hamis

npm

Ehhez a telepítési módszerhez Node.js 8.0-s vagy újabb verziót kell telepítenie. A Node Csomagkezelő (npm) minden Node.js telepítéshez tartalmaz csomagkezelő eszközt. A Node.jstelepítése után hajtsa végre a következő npm parancsot az Azurite telepítéséhez.

npm install -g azurite

Docker Hub

A DockerHub használatával lekérheti a legújabb Azurite-rendszerképet az alábbi paranccsal:

docker pull mcr.microsoft.com/azure-storage/azurite

GitHub

Ez a telepítési módszer megköveteli, hogy telepítsd a Gitet és Node.js 21.0-s vagy újabb verziót . Klónozza az Azurite-projekt GitHub-adattárát az alábbi konzolparancs használatával.

git clone https://github.com/Azure/Azurite.git

A forráskód klónozása után hajtsa végre a következő parancsokat a klónozott adattár gyökeréből az Azurite létrehozásához és telepítéséhez.

npm install
npm run build
npm install -g

Az Azurite futtatása

Az alábbi fülek közül választva megtekintheti a környezetére vonatkozó konkrét utasításokat.

Visual Studio

Ahhoz, hogy az Azurite a Visual Studióban a legtöbb projekttípussal használható legyen, először futtatnia kell az Azurite végrehajtható fájlokat. A végrehajtható fájl futtatása után az Azurite figyeli az alkalmazás kapcsolatkéréseit. További információ: Azurite futtatása a parancssorból.

Az Azure Functions-projektek és ASP.NET projektek esetében beállíthatja, hogy a projekt automatikusan elindítsa az Azurite-t. Ez a konfiguráció a projekt beállítása során történik. Bár ez a projektkonfiguráció automatikusan elindítja az Azurite-t, a Visual Studio nem teszi elérhetővé a részletes Azurite-konfigurációs beállításokat. A részletes Azurite-konfigurációs beállítások testreszabásához futtassa az Azurite végrehajtható fájlját a Visual Studio elindítása előtt.

Az Azure Functions-projektek és ASP.NET projektek automatikus indításának konfigurálásáról az alábbi útmutatóban talál további információt:

• Az Azurite futtatása Azure Functions-projektből
• Azurite futtatása egy ASP.NET projektből

Azurite végrehajtható fájl helye

Az alábbi táblázat a Windows rendszerű Visual Studio különböző verzióihoz futtatható Azurite-végrehajtható fájl helyét mutatja be:

Visual Studio-verzió	Az Azurite futtatható fájljának helye
Visual Studio Community 2022	C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\Extensions\Microsoft\Azure Storage Emulator
Visual Studio Professional 2022	C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE\Extensions\Microsoft\Azure Storage Emulator
Visual Studio Enterprise 2022	C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Extensions\Microsoft\Azure Storage Emulator

Az Azurite futtatása a parancssorból

Az Azurite végrehajtható fájl a Visual Studio-telepítés bővítménymappájában található, az Azurite végrehajtható fájl helytáblájában leírtak szerint.

Lépjen a megfelelő helyre, és indítsa el azurite.exe. A végrehajtható fájl futtatása után az Azurite figyeli a kapcsolatokat.

Az Azurite konfigurálásához elérhető parancssori lehetőségekről a parancssori beállítások című témakörben olvashat bővebben.

Az Azurite futtatása Azure Functions-projektből

A Visual Studio 2022-ben hozzon létre egy Azure Functions-projektet . A projektbeállítások megadásakor jelölje be az Azurite használata futtatókörnyezeti tárfiókhoz feliratú jelölőnégyzetet.

A projekt létrehozása után az Azurite automatikusan elindul. Az Azurite végrehajtható fájl helye az Azurite végrehajtható fájl helytáblájában található. A kimenet az alábbi képernyőképhez hasonlóan néz ki:

Ez a konfigurációs beállítás később módosítható a projekt Csatlakoztatott szolgáltatások függőségeinek módosításával.

Azurite futtatása egy ASP.NET projektből

A Visual Studio 2022-ben hozzon létre egy ASP.NET Core Web App-projektet . Ezután nyissa meg a Csatlakoztatott szolgáltatások párbeszédpanelt, válassza a Szolgáltatásfüggőség hozzáadása, majd a Storage Azurite emulátor lehetőséget.

A Storage Azurite emulátor konfigurálása párbeszédpanelen állítsa be a Kapcsolati sztring neve mezőt a következőre StorageConnectionString, majd válassza a Befejezés lehetőséget.

Amikor a konfiguráció befejeződik, válassza a Bezárás lehetőséget, és az Azurite emulátor automatikusan elindul. Az Azurite végrehajtható fájl helye az Azurite végrehajtható fájl helytáblájában található. A kimenet az alábbi képernyőképhez hasonlóan néz ki:

Ez a konfigurációs beállítás később módosítható a projekt Csatlakoztatott szolgáltatások függőségeinek módosításával.

Visual Studio Code

Megjegyzés:

Az Azurite nem futtatható a parancssorból, ha csak a Visual Studio Code bővítményt telepítette. Ehelyett használja a Visual Studio Code parancskatalógusát a parancsok futtatásához. A konfigurációs beállításokat az Azurite bővítmény beállításainak konfigurálása című témakörben találja.

Az Azurite bővítmény a következő Visual Studio Code-parancsokat támogatja. A parancskatalógus megnyitásához nyomja le az F1 billentyűt a Visual Studio Code-ban.

• Azurite: Clean – Visszaállítja az összes Azurite-szolgáltatás perzisztenciaadatait.
  • Azurite: Clean Blob Service – Clean Blob Service
  • Azurite: Clean Queue Service – Clean queue service
  • Azurite: Clean Table Service – Clean table service
  • Azurite: Bezárás – Az összes Azurite-szolgáltatás bezárása
  • Azurite: Blob szolgáltatás bezárása – Blob szolgáltatás bezárása
  • Azurite: Üzenetsor-szolgáltatás bezárása - Üzenetsor-szolgáltatás bezárása
  • Azurite: Táblaszolgáltatás leállítása - Táblaszolgáltatás leállítása
  • Azurite: Start – Az összes Azurite-szolgáltatás indítása
  • Azurite: Blob szolgáltatás indítása – Blob szolgáltatás indítása
  • Azurite: Üzenetsor-szolgáltatás indítása – Üzenetsor-szolgáltatás indítása
  • Azurite: Táblaszolgáltatás indítása – Táblaszolgáltatás indítása

npm

Indítsa el az Azurite-t a következő parancs kiadásával:

azurite --silent --location c:\azurite --debug c:\azurite\debug.log

Ez a parancs arra utasítja az Azurite-t, hogy az összes adatot egy adott könyvtárban tárolja, c:\azurite. Ha a --location beállítás nincs megadva, az aktuális munkakönyvtárat használja.

Docker Hub

Futtassa az Azurite Docker-lemezképet:

Az alábbi parancs az Azurite Docker-rendszerképet futtatja. A -p 10000:10000 paraméter a gazdagép 10000-es portjáról a Docker-instanc felé irányítja át a kéréseket.

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 \
    mcr.microsoft.com/azure-storage/azurite

Adja meg a munkaterület helyét:

A következő példában a paraméter a -v c:/azurite:/datac:/azurite paramétert adja meg az Azurite által tárolt adathelyként. A c:/azurite könyvtárat a Docker-parancs futtatása előtt létre kell hozni.

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 \
    -v c:/azurite:/data mcr.microsoft.com/azure-storage/azurite

Futtassa csak a blobszolgáltatást

docker run -p 10000:10000 mcr.microsoft.com/azure-storage/azurite \
    azurite-blob --blobHost 0.0.0.0 --blobPort 10000

Az Azurite indításkor történő konfigurálásáról további információt a parancssori beállításokban talál.

GitHub

Ha azonnal hozzá szeretne kezdeni a parancssorhoz, hozzon létre egy c:\azurite nevű könyvtárat, majd indítsa el az Azurite-ot a következő parancs kiadásával:

azurite --silent --location c:\azurite --debug c:\azurite\debug.log

Ez a parancs arra utasítja az Azurite-t, hogy az összes adatot egy adott könyvtárban tárolja, c:\azurite. Ha a --location beállítás nincs megadva, az aktuális munkakönyvtárat használja.

Parancssori beállítások

Ez a szakasz az Azurite indításakor elérhető parancssori kapcsolókat ismerteti.

Help

Opcionális – A parancssori súgó megjelenítéséhez használja a -h vagy a --help kapcsolót.

azurite -h
azurite --help

Figyelő gazdagép

Blob Storage

Nem kötelező – Az Azurite alapértelmezés szerint a 127.0.0.1-et figyeli helyi kiszolgálóként. A --blobHost kapcsolóval állítsa be a címet az igényeinek megfelelően.

Csak a helyi gépen fogadja el a kéréseket:

azurite --blobHost 127.0.0.1

Távoli kérések engedélyezése:

azurite --blobHost 0.0.0.0

Caution

A távoli kérések engedélyezése sebezhetővé teheti a rendszert a külső támadásokkal szemben.

Sorok tárolása

Nem kötelező – Az Azurite alapértelmezés szerint a 127.0.0.1-et figyeli helyi kiszolgálóként. A --queueHost kapcsolóval állítsa be a címet az igényeinek megfelelően.

Csak a helyi gépen fogadja el a kéréseket:

azurite --queueHost 127.0.0.1

Távoli kérések engedélyezése:

azurite --queueHost 0.0.0.0

Caution

A távoli kérések engedélyezése sebezhetővé teheti a rendszert a külső támadásokkal szemben.

Táblatároló

Nem kötelező – Az Azurite alapértelmezés szerint a 127.0.0.1-et figyeli helyi kiszolgálóként. A --tableHost kapcsolóval állítsa be a címet az igényeinek megfelelően.

Csak a helyi gépen fogadja el a kéréseket:

azurite --tableHost 127.0.0.1

Távoli kérések engedélyezése:

azurite --tableHost 0.0.0.0

Caution

A távoli kérések engedélyezése sebezhetővé teheti a rendszert a külső támadásokkal szemben.

Figyelőport konfigurációja

Blob Storage

Nem kötelező – Az Azurite alapértelmezés szerint az 10000-s porton figyeli a Blob szolgáltatást. A(z) --blobPort kapcsolóval adhatja meg a kívánt figyelési portot.

Megjegyzés:

A testreszabott port használata után frissítenie kell a kapcsolati sztringet vagy a megfelelő konfigurációt az Azure Storage-eszközökben vagy SDK-kban.

A Blob szolgáltatás figyelési portjának testreszabása:

azurite --blobPort 8888

A rendszer automatikusan válasszon ki egy elérhető portot:

azurite --blobPort 0

Az Azurite indításakor megjelenik a használatban lévő port.

Sorok tárolása

Nem kötelező – Alapértelmezés szerint az Azurite figyeli a Queue szolgáltatást az 10001-s porton. A(z) --queuePort kapcsolóval adhatja meg a kívánt figyelési portot.

Megjegyzés:

A testreszabott port használata után frissítenie kell a kapcsolati sztringet vagy a megfelelő konfigurációt az Azure Storage-eszközökben vagy SDK-kban.

A Queue szolgáltatás figyelési portjának testreszabása:

azurite --queuePort 8888

A rendszer automatikusan válasszon ki egy elérhető portot:

azurite --queuePort 0

Az Azurite indításakor megjelenik a használatban lévő port.

Táblatároló

Nem kötelező – Alapértelmezés szerint az Azurite figyeli a Table szolgáltatást az 10002-s porton. A(z) --tablePort kapcsolóval adhatja meg a kívánt figyelési portot.

Megjegyzés:

A testreszabott port használata után frissítenie kell a kapcsolati sztringet vagy a megfelelő konfigurációt az Azure Storage-eszközökben vagy SDK-kban.

A Table szolgáltatás figyelési portjának testreszabása:

azurite --tablePort 11111

A rendszer automatikusan válasszon ki egy elérhető portot:

azurite --tablePort 0

Az Azurite indításakor megjelenik a használatban lévő port.

Munkaterület elérési útja

Nem kötelező – Azurite a végrehajtás során tárolja az adatokat a helyi lemezen. A munkaterület helyeként szolgáló elérési út megadásához használja a(z) -l vagy --location kapcsolót. Alapértelmezés szerint a rendszer az aktuális folyamat munkakönyvtárát használja. Jegyezze fel az "l" kisbetűt.

azurite -l c:\azurite
azurite --location c:\azurite

Hozzáférési napló

Nem kötelező – Alapértelmezés szerint a hozzáférési napló megjelenik a konzolablakban. Tiltsa le a hozzáférési napló megjelenítését a -s vagy a --silent kapcsoló használatával.

azurite -s
azurite --silent

Hibakeresési napló

Opcionális - A hibakeresési napló minden kérésről részletes információkat és kivételverem-nyomkövetéseket tartalmaz. Engedélyezze a hibakeresési naplózást úgy, hogy érvényes helyi fájlútvonalat ad meg a -d vagy a --debug kapcsolóhoz.

azurite -d path/debug.log
azurite --debug path/debug.log

Laza üzemmód

Nem kötelező – Az Azurite alapértelmezés szerint szigorú módot alkalmaz a nem támogatott kérésfejlécek és paraméterek letiltására. Tiltsa le a szigorú módot a -L vagy a --loose kapcsoló használatával. Figyeljen a nagy „L” betűre.

azurite -L
azurite --loose

verzió

Nem kötelező – A telepített Azurite verziószámának megjelenítése a -v vagy --version kapcsoló használatával.

azurite -v
azurite --version

Tanúsítványkonfiguráció (HTTPS)

Nem kötelező – Az Azurite alapértelmezés szerint a HTTP protokollt használja. A HTTPS-módot úgy engedélyezheti, hogy a kapcsolóval megadja egy Privacy Enhanced Mail (.pem) vagy --cert tanúsítványfájlhoz vezető elérési utat. HTTPS szükséges az Azurite-hoz OAuth-hitelesítéssel való csatlakozáshoz.

Ha --cert egy PEM-fájlhoz meg van adva, meg kell adnia egy megfelelő --key kapcsolót.

azurite --cert path/server.pem --key path/key.pem

Ha --cert egy PFX-fájlhoz van megadva, meg kell adnia egy megfelelő --pwd kapcsolót.

azurite --cert path/server.pfx --pwd pfxpassword

HTTPS-beállítás

A PEM- és PFX-fájlok létrehozásával kapcsolatos részletes információkért tekintse meg a HTTPS telepítőjét.

OAuth-konfiguráció

Nem kötelező – Engedélyezze az OAuth-hitelesítést az Azurite-hoz a --oauth kapcsolóval.

azurite --oauth basic --cert path/server.pem --key path/key.pem

Megjegyzés:

Az OAuthhoz HTTPS-végpont szükséges. Győződjön meg arról, hogy a HTTPS engedélyezve van azzal, hogy a --cert kapcsolót a --oauth kapcsolóval együtt adja meg.

Az Azurite az basic kapcsoló --oauth paraméterének megadásával támogatja az egyszerű hitelesítést. Az Azurite alapszintű hitelesítést végez, például ellenőrzi a bejövő tulajdonosi jogkivonatot, ellenőrzi a kiállítót, a célközönséget és a lejáratot. Az Azurite nem ellenőrzi a token aláírását vagy jogosultságait. Az engedélyezéssel kapcsolatos további információkért lásd: Csatlakozás az Azurite-hoz SDK-kkal és eszközökkel.

AZ API verzióellenőrzésének kihagyása

Nem kötelező – Az Azurite az indításkor ellenőrzi, hogy a kért API-verzió érvényes-e. Az alábbi parancs kihagyja az API verzióellenőrzését:

azurite --skipApiVersionCheck

Éles stílusú URL-cím letiltása

Választható. Ha az IP-cím helyett a teljesen minősített tartománynevet használja a kérés URI-jának gazdagépében, az Azurite alapértelmezés szerint a tárfiók nevét a kérés URI-jának gazdagépéből nyeri ki. A(z) --disableProductStyleUrl használatával kikényszerítheti a tárfiók nevének elemzését a kérés URI-útvonalából:

azurite --disableProductStyleUrl

Memóriabeli adatmegőrzés

Választható. Alapértelmezés szerint a blobok és az üzenetsorok metaadatai a lemezen tárolódnak, a tartalom pedig az extentfájlokban tárolódik. A táblatároló az összes adatot a lemezen tárolja. Letilthatja az adatok lemezen való megőrzését, és csak a memóriában tárolhatja az adatokat. A memóriabeli adatmegőrzési forgatókönyvben, ha az Azurite-folyamat leáll, az összes adat elveszik. Az alapértelmezett adatmegőrzési viselkedés felülbíráltatható az alábbi beállítással:

azurite --inMemoryPersistence

Ezt a beállítást a rendszer elutasítja, ha az SQL-alapú metaadatok implementációja engedélyezve van (via AZURITE_DB), vagy ha a --location beállítás meg van adva.

Memóriakorlát mértéke

Választható. Alapértelmezés szerint a memóriabeli tárterület (blob- és üzenetsor-tartalom esetén) a gazdagép teljes memóriájának 50% korlátozódik. Az összeg kiértékelése a(z) os.totalmem() használatával történik. Ezt a korlátot felül lehet bírálni a következő beállítással:

azurite --extentMemoryLimit <megabytes>

A beállításhoz megadott érték nincs korlátozva. A virtuális memória azonban akkor használható, ha a korlát meghaladja az operációs rendszer által biztosított rendelkezésre álló fizikai memória mennyiségét. A túl magas korlát idővel memóriahiány miatti hibákhoz vagy teljesítményromláshoz vezethet. Ezt a beállítást a rendszer elutasítja, ha --inMemoryPersistence nincs megadva.

További információ: Memóriabeli tárolás használata.

Telemetriai gyűjtemény letiltása

Választható. Az Azurite alapértelmezés szerint telemetriai adatokat gyűjt a termék javítása érdekében. Használja a(z) --disableTelemetry beállítást a telemetriai adatok gyűjtésének letiltásához az Azurite aktuális futtatása során, például az alábbi paranccsal:

azurite --disableTelemetry

Következő lépések

• Az Azurite-hoz való csatlakozás SDK-kkal és eszközökkel ismerteti, hogyan csatlakozhat az Azurite-hoz különböző Azure Storage SDK-k és -eszközök használatával.
• Az Azure Storage kapcsolati sztringjeinek konfigurálása bemutatja, hogyan állíthat össze érvényes Azure Storage-kapcsolati sztringet.
• Az Azurite használatával automatizált teszteket futtathat , és leírja, hogyan írhat automatizált teszteket az Azurite Storage emulátor használatával.
• Az Azure Storage Emulator használatával fejlesztheti és tesztelheti a régi Azure Storage Emulatort, amelyet az Azurite helyettesít.