Preparar seu ambiente de desenvolvimento no WindowsPrepare your development environment on Windows

Para compilar e executar aplicativos de Service Fabric do Azure no computador de desenvolvimento do Windows, instale o Service Fabric Runtime, o SDK e as ferramentas.To build and run Azure Service Fabric applications on your Windows development machine, install the Service Fabric runtime, SDK, and tools. Você também precisa habilitar a execução dos scripts do Windows PowerShell incluídos no SDK.You also need to enable execution of the Windows PowerShell scripts included in the SDK.

Pré-requisitosPrerequisites

Versões de sistema operacional com suporteSupported operating system versions

Há suporte de desenvolvimento para as seguintes versões de sistema operacional:The following operating system versions are supported for development:

  • Windows 7Windows 7
  • Windows 8/Windows 8.1Windows 8/Windows 8.1
  • Windows Server 2012 R2Windows Server 2012 R2
  • Windows Server 2016Windows Server 2016
  • Windows 10Windows 10

Observação

Suporte do Windows 7:Windows 7 support:

  • O Windows 7 inclui, por padrão, apenas o Windows PowerShell 2.0.Windows 7 only includes Windows PowerShell 2.0 by default. Cmdlets de PowerShell do Service Fabric exigem o PowerShell 3.0 ou superior.Service Fabric PowerShell cmdlets requires PowerShell 3.0 or higher. Você pode baixar o Windows PowerShell 5,0 do centro de download da Microsoft.You can download Windows PowerShell 5.0 from the Microsoft Download Center.
  • O Proxy Reverso do Service Fabric não está disponível no Windows 7.Service Fabric Reverse Proxy is not available on Windows 7.

Instalar o SDK e as ferramentasInstall the SDK and tools

O WebPI (Web Platform Installer) é a maneira recomendada de instalar o SDK e as ferramentas.Web Platform Installer (WebPI) is the recommended way to install the SDK and tools. Caso receba os erros de tempo de execução usando o WebPI, você também poderá encontrar links diretos para os instaladores nas notas sobre a versão específica do Service Fabric.If you receive runtime errors using WebPI, you can also find direct links to the installers in the release notes for a specific Service Fabric release. As notas sobre a versão podem ser encontradas em vários anúncios de lançamentos no blog da equipe do Service Fabric.The release notes can be found in the various release announcements on the Service Fabric team blog.

Observação

Não há suporte para atualizações de cluster de desenvolvimento do Service Fabric local.Local Service Fabric development cluster upgrades are not supported.

Para usar o Visual Studio 2017 ou 2019To use Visual Studio 2017 or 2019

Os Ferramentas do Service Fabric fazem parte da carga de trabalho de desenvolvimento do Azure no Visual Studio 2017 e 2019.The Service Fabric Tools are part of the Azure Development workload in Visual Studio 2017 and 2019. Habilite essa carga de trabalho como parte da instalação do Visual Studio.Enable this workload as part of your Visual Studio installation. Além disso, você precisa instalar o SDK e o tempo de execução do Microsoft Azure Service Fabric usando o Web Platform Installer.In addition, you need to install the Microsoft Azure Service Fabric SDK and runtime using Web Platform Installer.

Para usar o Visual Studio 2015 (requer a atualização do Visual Studio 2015 2 ou posterior)To use Visual Studio 2015 (requires Visual Studio 2015 Update 2 or later)

Para Visual Studio 2015, as ferramentas do Service Fabric são instaladas junto com o SDK e o tempo de execução, usando o Web Platform Installer:For Visual Studio 2015, the Service Fabric tools are installed together with the SDK and runtime using the Web Platform Installer:

Somente instalação do SDKSDK installation only

Se só precisar do SDK, você poderá instalar este pacote:If you only need the SDK, you can install this package:

As versões atuais são:The current versions are:

  • Service Fabric SDK e ferramentas 3.4.658Service Fabric SDK and Tools 3.4.658
  • 6.5.658 tempo de execução de Service FabricService Fabric runtime 6.5.658
  • Ferramentas do Service Fabric para Visual Studio 2015 2.5.20615.1Service Fabric Tools for Visual Studio 2015 2.5.20615.1
  • O Visual Studio 2017 15.9 inclui as Ferramentas do Service Fabric para Visual Studio 2.4.11024.1Visual Studio 2017 15.9 includes Service Fabric Tools for Visual Studio 2.4.11024.1
  • O Visual Studio 2019 16,1 inclui Ferramentas do Service Fabric para Visual Studio 2.5.20423.3Visual Studio 2019 16.1 includes Service Fabric Tools for Visual Studio 2.5.20423.3

Para obter uma lista das versões com suporte, consulte versões do Service FabricFor a list of supported versions, see Service Fabric versions

Observação

Os clusters de computador único (OneBox) não têm suporte para atualizações de Aplicativo ou Cluster. Exclua o cluster OneBox e recrie-o se precisar executar uma atualização de Cluster ou se tiver problemas ao executar uma atualização de Aplicativo.Single machine clusters (OneBox) are not supported for Application or Cluster upgrades; delete the OneBox cluster and recreate it if you need to perform a Cluster upgrade, or have any issues performing an Application upgrade.

Habilitar a execução de script do PowerShellEnable PowerShell script execution

A Malha do Serviço usa scripts do Windows PowerShell para criar um cluster de desenvolvimento local e implantar aplicativos do Visual Studio.Service Fabric uses Windows PowerShell scripts for creating a local development cluster and for deploying applications from Visual Studio. Por padrão, o Windows bloqueia a execução desses scripts.By default, Windows blocks these scripts from running. Para habilitá-los, você deve modificar sua política de execução do PowerShell.To enable them, you must modify your PowerShell execution policy. Abra o PowerShell com um administrador e insira o seguinte comando:Open PowerShell as an administrator and enter the following command:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Instalar o Docker (opcional)Install Docker (optional)

O Service Fabric é um orquestrador de contêineres para implantação de microsserviços em um cluster de computadores.Service Fabric is a container orchestrator for deploying microservices across a cluster of machines. Para executar aplicativos de contêiner do Windows no cluster de desenvolvimento local, você deve primeiro instalar o Docker for Windows.To run Windows container applications on your local development cluster, you must first install Docker for Windows. Obtenha o Docker CE for Windows (estável).Get Docker CE for Windows (stable). Depois de instalar e iniciar o Docker, clique no ícone de bandeja e selecione Alternar para contêineres do Windows.After installing and starting Docker, right-click on the tray icon and select Switch to Windows containers. Essa etapa é necessária para executar imagens do Docker com base no Windows.This step is required to run Docker images based on Windows.

Próximas etapasNext steps

Agora que você terminou de configurar seu ambiente de desenvolvimento, comece a compilar e executar aplicativos.Now that you've finished setting up your development environment, start building and running apps.