Installieren und Ausführen des Azurite-Emulators

Mit dem Azurite-Emulator können Entwickler cloudbasierte Anwendungs- und Toolentwicklung schnell verfolgen, ohne dass eine Internetverbindung erforderlich ist.

Dieser Artikel enthält Anweisungen für die Installation und Ausführung von Azurite sowie die Konfiguration für die lokale Entwicklung. Weitere Informationen zur Verwendung von Azurite finden Sie unter Verwenden des Azurite-Emulators für die lokale Entwicklung mit Azure Storage.

Azurite ersetzt den Azure Storage-Emulator und wird weiterhin aktualisiert, um die neuesten Versionen von Azure Storage-APIs zu unterstützen.

Installieren von Azurite

Azurite kann mit verschiedenen Methoden installiert und ausgeführt werden, darunter npm, Docker und Visual Studio Code. In diesem Video erfahren Sie, wie Sie den Azurite-Emulator installieren und ausführen.

Die Schritte im Video werden auch in den folgenden Abschnitten beschrieben. Wählen Sie eine dieser Registerkarten aus, um bestimmte Anweisungen anzuzeigen, die für Ihre Umgebung relevant sind.

Azurite ist automatisch mit Visual Studio 2022 verfügbar. Die ausführbare Datei Azurite wird als Teil der neuen Versionen von Visual Studio aktualisiert. Wenn Sie eine frühere Version von Visual Studio ausführen, können Sie Azurite entweder mit Node Paket-Manager (npm), DockerHub oder durch Klonen des Azurite GitHub-Repositorys installieren.

Azurite ausführen

Wählen Sie eine der folgenden Registerkarten aus, um spezifische Anweisungen anzuzeigen, die für Ihre Umgebung relevant sind.

Um Azurite mit den meisten Projekttypen in Visual Studio zu verwenden, müssen Sie zuerst die ausführbare Datei "Azurite" ausführen. Sobald die ausführbare Datei ausgeführt wird, lauscht Azurite auf Verbindungsanforderungen von der Anwendung. Weitere Informationen finden Sie unter Running Azurite über die Befehlszeile.

Bei Azure Functions-Projekten und ASP.NET Projekten können Sie das Projekt so konfigurieren, dass das Azurite automatisch gestartet wird. Diese Konfiguration erfolgt während der Projekteinrichtung. Während diese Projektkonfiguration azurite automatisch startet, macht Visual Studio keine detaillierten Azurite-Konfigurationsoptionen verfügbar. Um detaillierte Azureite-Konfigurationsoptionen anzupassen, führen Sie die ausführbare Datei azurite aus, bevor Sie Visual Studio starten.

Weitere Informationen zum Konfigurieren von Azure Functions-Projekten und ASP.NET Projekten zum automatischen Starten von Azurite finden Sie in den folgenden Anleitungen:

Speicherort der ausführbaren Azurite-Datei

Die folgende Tabelle zeigt den Speicherort der ausführbaren Datei Azurite für verschiedene Versionen von Visual Studio, die auf einem Windows-Computer ausgeführt werden:

Visual Studio-Version Speicherort der ausführbaren Azurite-Datei
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

Ausführen von Azurite über die Befehlszeile

Sie finden die ausführbare Azurite-Datei im Ordner „Extensions“ Ihrer Visual Studio-Installation, wie in der Tabelle zum Speicherort der ausführbaren Azurite-Datei beschrieben.

Navigieren Sie zum entsprechenden Speicherort und starten Sie azurite.exe. Nachdem Sie die ausführbare Datei ausgeführt haben, lauscht Azurite auf Verbindungen.

Bildschirmaufnahme der Azurite-Befehlszeilenausgabe.

Weitere Informationen zu den verfügbaren Befehlszeilenoptionen zum Konfigurieren von Azurite finden Sie unter Befehlszeilenoptionen.

Ausführen von Azurite aus einem Azure Functions-Projekt

Erstellen Sie in Visual Studio 2022 ein Azure Functions-Projekt . Markieren Sie beim Festlegen der Projektoptionen das Feld "Use Azurite" für das Laufzeitspeicherkonto.

Screenshot, der zeigt, wie Azurite als Laufzeitspeicherkonto für ein Azure Functions-Projekt festgelegt wird.

Nachdem Sie das Projekt erstellt haben, beginnt Azurite automatisch. Der Speicherort der ausführbaren Azurite-Datei ist in der Tabelle Speicherort der ausführbaren Azurite-Datei aufgeführt. Die Ausgabe ähnelt dem folgenden Screenshot:

Screenshot der Ausgabe nach dem Festlegen von Azurite als Laufzeitspeicherkonto für ein Azure Functions-Projekt.

Diese Konfigurationsoption kann später geändert werden, indem die Abhängigkeiten der verbundenen Dienste des Projekts geändert werden.

Ausführen von Azurite aus einem ASP.NET Projekt

Erstellen Sie in Visual Studio 2022 ein ASP.NET Core Web App-Projekt . Öffnen Sie dann das Dialogfeld "Verbundene Dienste ", wählen Sie " Dienstabhängigkeit hinzufügen" und dann den Emulator "Storage Azurite" aus.

Screenshot, der zeigt, wie Azurite als Abhängigkeit zu einem ASP.NET Projekt hinzugefügt wird.

Legen Sie im Dialogfeld „Speicher-Azurite-Emulator konfigurieren“ für das Feld Verbindungszeichenfolgenname den Wert StorageConnectionString fest, und wählen Sie dann Fertig stellen aus.

Screenshot, der zeigt, wie Eine Verbindungszeichenfolge für die Verwendung von Azurite mit einem ASP.NET Projekt konfiguriert wird.

Wenn die Konfiguration abgeschlossen ist, wählen Sie "Schließen" aus, und der Azurite-Emulator wird automatisch gestartet. Der Speicherort der ausführbaren Azurite-Datei ist in der Tabelle Speicherort der ausführbaren Azurite-Datei aufgeführt. Die Ausgabe ähnelt dem folgenden Screenshot:

Screenshot der Ausgabe nach dem Verbinden eines ASP.NET Projekts mit dem Azurite-Emulator.

Diese Konfigurationsoption kann später geändert werden, indem die Abhängigkeiten der verbundenen Dienste des Projekts geändert werden.

Befehlszeilenoptionen

In diesem Abschnitt werden die Befehlszeilenoptionen erläutert, die beim Starten von Azurite verfügbar sind.

Hilfe

Optional – Rufen Sie die Befehlszeilenhilfe mit dem Schalter -h oder --help ab.

azurite -h
azurite --help

Lauschender Host

Optional - Standardmäßig lauscht Azurite auf 127.0.0.1 als lokaler Server. Verwenden Sie den --blobHost Schalter, um die Adresse auf Ihre Anforderungen festzulegen.

Akzeptieren Sie Anforderungen nur auf dem lokalen Computer:

azurite --blobHost 127.0.0.1

Remoteanforderungen zulassen:

azurite --blobHost 0.0.0.0

Vorsicht

Das Zulassen von Remoteanforderungen macht Ihr System möglicherweise anfällig für externe Angriffe.

Konfiguration des Ports für eingehende Verbindungen

Optional – Standardmäßig lauscht Azurite auf den Blob-Dienst am Port 10000. Verwenden Sie den --blobPort-Schalter, um den Port anzugeben, auf dem gelauscht werden soll.

Hinweis

Nachdem Sie einen angepassten Port verwendet haben, müssen Sie die Verbindungszeichenfolge oder die entsprechende Konfiguration in Ihren Azure Storage-Tools oder SDKs aktualisieren.

Anpassen des Ports, auf dem der Blob-Dienst lauscht:

azurite --blobPort 8888

Lassen Sie das System automatisch einen verfügbaren Port auswählen:

azurite --blobPort 0

Der verwendete Hafen wird während des Azurite-Starts angezeigt.

Arbeitsbereichspfad

Optional – Azurite speichert Daten während der Ausführung auf dem lokalen Datenträger. Verwenden Sie den Schalter -l oder --location, um einen Pfad als Speicherort des Arbeitsbereichs anzugeben. Standardmäßig wird das aktuelle Arbeitsverzeichnis für Prozesse verwendet. Notieren Sie sich das Kleinbuchstabe "l".

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

Zugriffsprotokoll

Optional – Standardmäßig wird das Zugriffsprotokoll im Konsolenfenster angezeigt. Deaktivieren Sie die Anzeige des Zugriffsprotokolls mithilfe des Schalters -s oder --silent.

azurite -s
azurite --silent

Debug-Protokoll

Optional – Das Debugprotokoll enthält detaillierte Informationen zu jeder Anforderungs- und Ausnahmestapelablaufverfolgung. Aktivieren Sie das Debugprotokoll, indem Sie einen gültigen lokalen Dateipfad für die Option -d oder --debug angeben.

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

Lockerer Modus

Optional – Standardmäßig wendet Azurite den strengen Modus an, um nicht unterstützte Anforderungsheader und Parameter zu blockieren. Deaktivieren Sie den strikten Modus mithilfe des -L Oder --loose Schalters. Notieren Sie sich das Großbuchstaben "L".

azurite -L
azurite --loose

Version

Optional - Zeigen Sie die installierte Azurite-Version mithilfe des Schalters -v oder --version an.

azurite -v
azurite --version

Zertifikatkonfiguration (HTTPS)

Optional – Standardmäßig verwendet Azurite das HTTP-Protokoll. Sie können den HTTPS-Modus aktivieren, indem Sie für den Schalter einen Pfad zu einer Privacy-Enhanced-Mail-Datei (.pem) oder einer --cert angeben. HTTPS ist erforderlich, um mithilfe der OAuth-Authentifizierung eine Verbindung mit Azurite herzustellen.

Wenn --cert für eine PEM-Datei angegeben wird, müssen Sie einen entsprechenden --key Schalter angeben.

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

Wenn --cert für eine PFX-Datei angegeben wird, müssen Sie einen entsprechenden --pwd Switch angeben.

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

HTTPS-Einrichtung

Ausführliche Informationen zum Generieren von PEM- und PFX-Dateien finden Sie unter HTTPS Setup.

OAuth-Konfiguration

Optional – Aktivieren Sie die OAuth-Authentifizierung für Azurite mithilfe der --oauth Option.

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

Hinweis

OAuth erfordert einen HTTPS-Endpunkt. Stellen Sie sicher, dass HTTPS aktiviert ist, indem Sie den Schalter --cert zusammen mit dem Schalter --oauth angeben.

Azurite unterstützt die Standardauthentifizierung durch Angabe des basic Parameters für den --oauth Switch. Azurite führt eine grundlegende Authentifizierung durch, etwa indem es den eingehenden Bearer-Token validiert und den Aussteller, die Zielgruppe und das Ablaufdatum überprüft. Azurite überprüft die Tokensignatur oder -berechtigungen nicht. Weitere Informationen zur Autorisierung finden Sie unter Connect to Azurite mit SDKs und Tools.

Api-Versionsüberprüfung überspringen

Optional – Beim Start überprüft Azurite, ob die angeforderte API-Version gültig ist. Mit dem folgenden Befehl wird die API-Versionsüberprüfung übersprungen:

azurite --skipApiVersionCheck

URL im Produktionsstil deaktivieren

Optional Wenn Sie im Host der Anforderungs-URI anstelle der IP-Adresse den vollqualifizierten Domänennamen verwenden, ermittelt Azurite standardmäßig den Namen des Speicherkontos aus dem Host der Anforderungs-URI. Sie können das Parsen des Namens des Speicherkontos aus dem Anforderungs-URI-Pfad mithilfe von --disableProductStyleUrl erzwingen:

azurite --disableProductStyleUrl

In-Memory-Persistenz

Optional Standardmäßig werden Blob- und Warteschlangenmetadaten auf dem Datenträger persistiert, und der Inhalt wird in Extent-Dateien persistiert. Der Tabellenspeicher speichert alle Daten dauerhaft auf dem Datenträger. Sie können das Speichern von Daten auf einem Datenträger deaktivieren und nur Daten im Arbeitsspeicher speichern. Wenn der Azurit-Prozess beendet wird, gehen im Speicherpersistenzszenario alle Daten verloren. Das Standardmäßige Persistenzverhalten kann mithilfe der folgenden Option außer Kraft gesetzt werden:

azurite --inMemoryPersistence

Diese Einstellung wird abgelehnt, wenn die SQL-basierte Metadatenimplementierung aktiviert (über AZURITE_DB) oder wenn die --location Option angegeben wird.

Umfang der Speichergrenze

Optional Standardmäßig ist der Speicher im Arbeitsspeicher (für Blob- und Warteschlangeninhalte) auf 50% des gesamten Arbeitsspeichers auf dem Hostcomputer beschränkt. Die Summe wird mit os.totalmem() berechnet. Dieser Grenzwert kann mit der folgenden Option außer Kraft gesetzt werden:

azurite --extentMemoryLimit <megabytes>

Es gibt keine Einschränkung für den für diese Option angegebenen Wert. Der virtuelle Speicher kann jedoch verwendet werden, wenn der Grenzwert die menge des verfügbaren physischen Arbeitsspeichers überschreitet, wie vom Betriebssystem bereitgestellt. Eine hohe Grenze kann schließlich zu Speicherfehlern oder zu einer verringerten Leistung führen. Diese Option wird abgelehnt, wenn --inMemoryPersistence nicht angegeben ist.

Weitere Informationen finden Sie unter "In-Memory-Speicher verwenden".

Telemetriesammlung deaktivieren

Optional Standardmäßig sammelt Azurite Telemetriedaten, um das Produkt zu verbessern. Verwenden Sie die Option zum Deaktivieren der --disableTelemetry Telemetriedatensammlung für die aktuelle Azurite-Ausführung, z. B. den folgenden Befehl:

azurite --disableTelemetry

Nächste Schritte

  • Last updated on