Einrichten der Windows-Entwicklungsumgebung zum Erstellen von Service Fabric Mesh-Anwendungen

  • Artikel

Wichtig

Die Vorschauversion von Azure Service Fabric Mesh wurde eingestellt. Neue Bereitstellungen über die Service Fabric Mesh-API werden nicht mehr gestattet. Unterstützung für vorhandene Bereitstellungen wird bis zum 28. April 2021 fortgesetzt.

Einzelheiten finden Sie unter Einstellung der Vorschauversion von Azure Service Fabric Mesh.

Zum Entwickeln und Ausführen von Azure Service Fabric Mesh-Anwendungen auf dem Windows-Entwicklungscomputer benötigen Sie:

  • Docker
  • Visual Studio 2017 oder höher
  • Service Fabric Mesh-Runtime
  • Service Fabric Mesh-SDK und -Tools.

Außerdem eine der folgenden Versionen von Windows:

  • Windows 10 (Enterprise, Professional, oder Education), Versionen 1709 (Fall Creators-Update) oder 1803 (Windows 10 April 2018-Update)
  • Windows Server, Version 1709
  • Windows Server, Version 1803

Die folgenden Anweisungen helfen Ihnen bei der Installation basierend auf der von Ihnen verwendeten Version von Windows.

Service Fabric Mesh befindet sich derzeit in der Vorschauphase. Vorschauversionen werden Ihnen zur Verfügung gestellt, wenn Sie die zusätzlichen Nutzungsbedingungen akzeptieren. Einige Aspekte dieses Features werden bis zur allgemeinen Verfügbarkeit unter Umständen noch geändert.

Visual Studio

Visual Studio 2017 oder höher ist erforderlich, um Service Fabric Mesh-Anwendungen bereitzustellen. Installieren Sie Version 15.6.0 oder höher, und aktivieren Sie die folgenden Workloads:

  • ASP.NET und Webentwicklung
  • Azure-Entwicklung

Installieren von Docker

Wenn Sie Docker bereits installiert haben, stellen Sie sicher, dass Sie über die neueste Version verfügen. Docker kann Sie auffordern, wenn eine neue Version ausgecheckt ist, aber überprüfen Sie manuell, um sicherzustellen, dass Sie über die neueste Version verfügen.

Installieren von Docker unter Windows 10

Laden Sie die aktuelle Version der Docker Community Edition für Windows herunter, und installieren Sie sie, um die containerbasierten Service Fabric-Apps zu unterstützen, die von Service Fabric Mesh verwendet werden.

Wählen Sie während der Installation Windows-Container anstelle von Linux-Containern verwenden aus, falls Sie dazu aufgefordert werden.

Wenn Hyper-V auf Ihrem Computer nicht aktiviert ist, wird dieser Schritt vom Docker-Installationsprogramm angeboten. Klicken Sie auf OK, wenn die entsprechende Aufforderung angezeigt wird.

Installieren von Docker unter Windows Server 2016

Ist die Hyper-V-Rolle nicht aktiviert, öffnen Sie PowerShell als Administrator, und führen Sie den folgenden Befehl aus, um Hyper-V zu aktivieren. Starten Sie anschließend Ihren Computer neu. Weitere Informationen finden Sie in der Docker Enterprise Edition für Windows Server.

Install-WindowsFeature -Name Hyper-V -IncludeManagementTools

Starten Sie den Computer neu.

Öffnen Sie PowerShell als Administrator, und führen Sie den folgenden Befehl aus, um Docker zu installieren:

Install-Module DockerMsftProvider -Force
Install-Package Docker -ProviderName DockerMsftProvider -Force
Install-WindowsFeature Containers

SDKs und Tools

Installieren Sie die Service Fabric Mesh-Laufzeit, das SDK und die Tools in der folgenden Reihenfolge.

  1. Installieren Sie das Service Fabric Mesh SDK mithilfe des Webplattform-Installers. Dadurch werden auch das Microsoft Azure Service Fabric SDK und die Laufzeit installiert.
  2. Installieren Sie Service Fabric Mesh Tools für Visual Studio (Vorschauversion) aus Visual Studio Marketplace.

Erstellen eines Clusters

Wichtig

Docker muss ausgeführt werden, bevor Sie einen Cluster erstellen können. Testen Sie, ob Docker ausgeführt wird, indem Sie ein Terminalfenster öffnen und docker ps ausführen, um zu sehen, ob ein Fehler auftritt. Wenn in der Antwort kein Fehler angegeben wird, wird Docker ausgeführt, und Sie sind bereit, einen Cluster zu erstellen.

Hinweis

Wenn Sie zur Entwicklung einen Computer verwenden, auf dem das Windows Fall Creators-Update (Version 1709) installiert ist, können Sie nur Docker-Images für Windows-Version 1709 verwenden. Wenn Sie zur Entwicklung einen Computer verwenden, auf dem das Windows 10-Update vom April 2018 (Version 1803) installiert ist, können Sie entweder Docker-Images für Windows-Version 1709 oder 1803 verwenden.

Bei Verwendung von Visual Studio können Sie diesen Abschnitt überspringen, da Visual Studio einen lokalen Cluster für Sie erstellt, falls dieser nicht vorhanden ist.

Zur Erzielung einer optimalen Debugleistung beim Erstellen und Ausführen von jeweils einer einzelnen Service Fabric-App sollten Sie einen lokalen Entwicklungscluster mit nur einem Knoten erstellen. Erstellen Sie einen lokalen Entwicklungscluster mit fünf Knoten, wenn Sie mehrere Anwendungen gleichzeitig ausführen. Dieser Cluster muss immer dann ausgeführt werden, wenn Sie ein Service Fabric Mesh-Projekt bereitstellen oder debuggen.

Nachdem Sie die Laufzeit, SDKs, Visual Studio-Tools und Docker installiert haben und Docker ausgeführt wird, erstellen Sie einen Entwicklungscluster.

  1. Schließen Sie das PowerShell-Fenster.

  2. Öffnen Sie als Administrator ein neues PowerShell-Fenster mit erhöhten Rechten. Dieser Schritt ist erforderlich, um die zuletzt installierten Service Fabric-Module zu laden.

  3. Führen Sie den folgenden PowerShell-Befehl aus, um einen Entwicklungscluster zu erstellen:

    . "C:\Program Files\Microsoft SDKs\Service Fabric\ClusterSetup\DevClusterSetup.ps1" -CreateMeshCluster -CreateOneNodeCluster

  4. Um das lokale Cluster-Manager-Tool zu starten, führen Sie den folgenden PowerShell-Befehl aus:

    . "C:\Program Files\Microsoft SDKs\Service Fabric\Tools\ServiceFabricLocalClusterManager\ServiceFabricLocalClusterManager.exe"

  5. Sobald das Dienstcluster-Manager-Tool ausgeführt wird (es wird auf Ihrer Taskleiste angezeigt), klicken Sie mit der rechten Maustaste darauf, und klicken Sie auf Lokalen Cluster starten.

Abbildung 1: Starten des lokalen Clusters

Jetzt können Sie Service Fabric Mesh-Anwendungen erstellen!

Nächste Schritte

Lesen Sie das Tutorial Erstellen einer Azure Service Fabric-App.

Hier finden Sie Antworten auf häufig gestellte Fragen sowie Informationen zu bekannten Problemen.