Share via

Configurare l'ambiente di sviluppo Windows per compilare app Service Fabric Mesh

  • Articolo

Importante

L'anteprima di Azure Service Fabric Mesh è stata ritirata. Le nuove distribuzioni non saranno più consentite tramite l'API Di Service Fabric Mesh. Il supporto per le distribuzioni esistenti continuerà fino al 28 aprile 2021.

Per informazioni dettagliate, vedere Ritiro dell'anteprima di Azure Service Fabric Mesh.

Per compilare ed eseguire applicazioni di Azure Service Fabric Mesh nel computer di sviluppo Windows, occorrono:

  • Docker
  • Visual Studio 2017 o versioni successive
  • Runtime di Service Fabric Mesh
  • SDK e strumenti di Service Fabric Mesh.

E una delle versioni seguenti di Windows:

  • Windows 10 (Enterprise, Professional o Education) versioni 1709 (Fall Creators Update) o 1803 (aggiornamento Windows 10 di aprile 2018)
  • Windows Server versione 1709
  • Windows Server versione 1803

Le istruzioni seguenti consentono di installare tutti gli elementi in base alla versione di Windows in esecuzione.

Mesh Service Fabric è attualmente in anteprima. Le anteprime vengono rese disponibili per l'utente a condizione che si accettino le condizioni d'uso aggiuntive. Alcuni aspetti di questa funzionalità potrebbero subire modifiche prima della disponibilità a livello generale.

Visual Studio

Visual Studio 2017 o versione successiva è necessario per distribuire applicazioni Service Fabric Mesh. Installare la versione 15.6.0 o successiva e abilitare i carichi di lavoro seguenti:

  • Sviluppo Web e ASP.NET
  • Sviluppo di Azure

Installare Docker

Se Docker è già installato, assicurarsi di disporre della versione più recente. Docker potrebbe richiedere quando una nuova versione è in uscita, ma controllare manualmente per assicurarsi di avere la versione più recente.

Installare Docker in Windows 10

Scaricare e installare la versione più recente di Docker Community Edition per Windows per supportare le app di Service Fabric in contenitori usate da Service Fabric Mesh.

Durante l'installazione, selezionare Use Windows containers instead of Linux containers (Usa contenitori Windows invece di contenitori Linux) quando viene richiesto.

Se Hyper-V non è abilitato nel computer, il programma di installazione di Docker offrirà di abilitarlo. Fare clic su OK per farlo se viene richiesto.

Installare Docker in Windows Server 2016

Se il ruolo Hyper-V non è abilitato, aprire PowerShell come amministratore ed eseguire il comando seguente per abilitare Hyper-V, quindi riavviare il computer. Per altre informazioni, vedere Docker Enterprise Edition for Windows Server (Docker Enterprise Edition per Windows Server).

Install-WindowsFeature -Name Hyper-V -IncludeManagementTools

Riavviare il computer.

Aprire PowerShell come amministratore ed eseguire il comando seguente per installare Docker:

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

SDK e strumenti

Installare il runtime di Service Fabric Mesh, l'SDK e gli strumenti nell'ordine seguente.

  1. Installare Service Fabric Mesh SDK usando Installazione guidata piattaforma Web. Verranno installati anche Microsoft Azure Service Fabric SDK e il runtime.
  2. Installare l'estensione Strumenti di Service Fabric Mesh per Visual Studio (anteprima) da Visual Studio Marketplace.

Creare un cluster

Importante

Prima di poter creare un cluster, Docker deve essere in esecuzione. Per testare se Docker è in esecuzione, aprire una finestra del terminale ed eseguire docker ps per vedere se si verifica un errore. Se la risposta non indica un errore, Docker è in esecuzione ed è possibile creare un cluster.

Nota

Se si sta sviluppando in un computer con Windows Fall Creators Update (versione 1709), è possibile usare solo le immagini Docker di Windows versione 1709. Se si sta sviluppando in un computer con l'aggiornamento di Windows 10 di aprile 2018 (versione 1803), è possibile scegliere fra le immagini Docker di Windows versione 1709 o 1803.

Se si usa Visual Studio, è possibile ignorare questa sezione perché Visual Studio creerà automaticamente un cluster locale, se non ne è disponibile uno.

Per ottenere prestazioni di debug ottimali durante la creazione e l'esecuzione di una singola app di Service Fabric alla volta, creare un cluster di sviluppo locale a nodo singolo. Se si eseguono più applicazioni alla volta, creare un cluster di sviluppo locale a cinque nodi. Il cluster deve essere in esecuzione ogni volta che si distribuisce o si esegue il debug di un progetto Service Fabric Mesh.

Dopo aver installato il runtime, gli SDK e gli strumenti di Visual Studio e aver avviato il Docker, creare un cluster di sviluppo.

  1. Chiudere la finestra di PowerShell.

  2. Aprire una nuova finestra di PowerShell con privilegi elevati come amministratore. Questo passaggio è necessario per caricare i moduli di Service Fabric installati di recente.

  3. Eseguire il comando di PowerShell seguente per creare un cluster di sviluppo:

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

  4. Per avviare lo strumento di gestione cluster locale, eseguire il comando seguente di PowerShell:

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

  5. Una volta che lo strumento di gestione cluster del servizio è in esecuzione (compare nella barra delle applicazioni), fare clic su di esso con il pulsante destro del mouse e scegliere Start Local Cluster (Avvia cluster locale).

Figura 1 - Avvio del cluster locale

È ora possibile creare applicazioni Service Fabric Mesh.

Passaggi successivi

Leggere l'esercitazione sulla creazione di un'app Azure Service Fabric.

Risposte a domande comuni e problemi noti.