Configurar o ambiente de desenvolvimento Windows para compilar aplicações do Service Fabric Mesh

  • Artigo

Importante

A pré-estreia da Malha de Tecido de Serviço Azure foi reformada. As novas implementações deixarão de ser permitidas através da API de Malha de Malha de Tecido de Serviço. O apoio às implementações existentes continuará até 28 de abril de 2021.

Para mais detalhes, consulte a pré-reforma da pré-aposentadoria de pré-aposentadoria de malha de malha de tecido de serviço Azure.

Para construir e executar aplicações de malha de tecido de serviço Azure na sua máquina de desenvolvimento Windows, você precisará:

  • Docker
  • Estúdio Visual 2017 ou mais tarde
  • Tempo de funcionação da malha de tecido de serviço
  • Rede de malha de tecido de serviço SDK, e ferramentas.

E uma das seguintes versões do Windows:

  • Windows 10 (Enterprise, Professional, or Education) versões 1709 (atualização dos Criadores de outono) ou 1803 (Windows 10 atualização de abril de 2018)
  • Versão 1709 do Windows Server
  • Versão 1803 do Windows Server

As seguintes instruções irão ajudá-lo a instalar tudo com base na versão do Windows que está a executar.

O Service Fabric Mesh está atualmente em pré-visualização. As pré-visualizações são disponibilizadas a si na condição de concordar com os termos suplementares de utilização. Alguns aspetos desta funcionalidade podem alterar-se após a disponibilidade geral (GA).

Visual Studio

O Visual Studio 2017 ou mais tarde é necessário para implementar aplicações de Malha de Tecido de Serviço. Instale a versão 15.6.0 ou superior e ative as seguintes cargas de trabalho:

  • Desenvolvimento ASP.NET e Web
  • Desenvolvimento do Azure

Instalar o Docker

Se já tiver o Docker instalado, certifique-se de que tem a versão mais recente. O Docker pode pedir-lhe quando uma nova versão estiver fora, mas verifique manualmente para garantir que tem a versão mais recente.

Instale Docker no Windows 10

Transfira e instale a versão mais recente do Docker Community Edition para Windows para suportar as aplicações do Service Fabric em contentores utilizadas pelo Service Fabric Mesh.

Durante a instalação, selecione Utilizar contentores do Windows em vez de contentores do Linux quando lhe for pedido.

Se o Hiper-V não estiver ativado na sua máquina, o instalador do Docker oferecer-se-á para o ativar. Clique em OK para fazer isso, se lhe for pedido.

Instale Docker no Windows Server 2016

Se não tiver a função do Hyper-V ativada, abra o PowerShell como administrador e execute o seguinte comando para ativar o Hyper-V e, em seguida, reinicie o computador. Para obter mais informações, veja Docker Enterprise Edition para Windows Server.

Install-WindowsFeature -Name Hyper-V -IncludeManagementTools

Reinicie o computador.

Abra o PowerShell como administrador e execute os seguintes comandos para instalar o Docker:

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

SDK e ferramentas

Instale o runtime, o SDK e as ferramentas do Service Fabric Mesh pela ordem seguinte.

  1. Instale o SDK do Service Fabric Mesh através do Instalador de Plataforma Web. Também será instalado o SDK e o runtime do Microsoft Azure Service Fabric.
  2. Instale a extensão Ferramentas do Service Fabric Mesh para Visual Studio (pré-visualização) a partir do Visual Studio Marketplace.

Compilar um cluster

Importante

O Docker tem estar em execução antes de poder compilar um cluster. Teste se o Docker está em execução ao abrir uma janela de terminal e ao executar docker ps para ver se ocorre um erro. Se a resposta não indicar um erro, o Docker está a ser executado e está pronto para compilar um cluster.

Nota

Se estiver a desenvolver na máquina de atualização de Criadores de outono do Windows (versão 1709), só pode utilizar imagens de docker da versão 1709 do Windows. Se estiver a desenvolver na máquina de atualização Windows 10 abril de 2018 (versão 1803), pode utilizar imagens de estivadores do Windows 1709 ou 1803.

Se estiver a usar o Visual Studio, pode saltar esta secção porque o Visual Studio criará um cluster local para si se não tiver um.

Para obter o melhor desempenho de depuração quando estiver a criar e executar uma única aplicação de Tecido de Serviço de cada vez, crie um cluster de desenvolvimento local de nó único. Se estiver a executar várias aplicações de cada vez, crie um cluster de desenvolvimento local de cinco nós. O cluster deve estar em funcionamento sempre que implementar ou depurar um projeto de malha de tecido de serviço.

Depois de instalar o tempo de execução, SDKs, ferramentas de Estúdio Visual, Docker, e ter Docker em execução, crie um cluster de desenvolvimento.

  1. Feche a janela do PowerShell.

  2. Abra uma nova janela do PowerShell elevada como administrador. Este passo é necessário para carregar os módulos do Service Fabric instalados recentemente.

  3. Execute o seguinte comando do PowerShell para criar um cluster de desenvolvimento:

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

  4. Para iniciar a ferramenta de gestor de clusters locais, execute o seguinte comando do PowerShell:

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

  5. Uma vez que a ferramenta de gestor de cluster de serviço está em funcionamento (aparece na bandeja do seu sistema), clique com o botão direito e clique em Iniciar Cluster Local.

Figura 1 - Inicie o cluster local

Está agora pronto para criar aplicações do Service Fabric Mesh!

Passos seguintes

Leia o tutorial Criar uma aplicação do Azure Service Fabric.

Encontre respostas a perguntas comuns e questões conhecidas.