Preparar o 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. Também precisa de ativar 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 operativo com suporteSupported operating system versions

As seguintes versões do sistema operativo são suportadas para desenvolvimento: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

Nota

Suporte do Windows 7:Windows 7 support:

  • O Windows 7 inclui, por predefinição, apenas o Windows PowerShell 2.0.Windows 7 only includes Windows PowerShell 2.0 by default. Os cmdlets do PowerShell do Service Fabric necessitam do 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 Inverso 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

Web Platform Installer (WebPI) é a maneira recomendada para instalar o SDK e as ferramentas.Web Platform Installer (WebPI) is the recommended way to install the SDK and tools. Se você receber erros de tempo de execução usando o WebPI, também poderá encontrar links diretos para os instaladores nas notas de versão de uma 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 de versão podem ser encontradas nos vários anúncios de versão no blog da equipe do Service Fabric.The release notes can be found in the various release announcements on the Service Fabric team blog.

Nota

Não há suporte para atualizações de cluster de desenvolvimento Service Fabric locais.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. Ative esta carga de trabalho como parte da instalação do Visual Studio.Enable this workload as part of your Visual Studio installation. Para além disso, deve instalar o runtime e o Microsoft Azure Service Fabric SDK, utilizando o Instalador de Plataforma Web.In addition, you need to install the Microsoft Azure Service Fabric SDK and runtime using Web Platform Installer.

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

Para o Visual Studio 2015, as ferramentas do Service Fabric são instaladas juntamente com o SDK e o runtime, utilizando o Instalador de Plataforma Web:For Visual Studio 2015, the Service Fabric tools are installed together with the SDK and runtime using the Web Platform Installer:

Apenas instalação do SDKSDK installation only

Se apenas precisa do SDK, pode 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 4.0.457Service Fabric SDK and Tools 4.0.457
  • 7.0.457 tempo de execução de Service FabricService Fabric runtime 7.0.457

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

Nota

Não há suporte para clusters de computador único (OneBox) para atualizações de cluster ou aplicativo; Exclua o cluster OneBox e recrie-o se você precisar executar uma atualização de cluster ou tiver problemas para 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.

Ativar a execução do script do PowerShellEnable PowerShell script execution

O Service Fabric utiliza scripts do Windows PowerShell para criar um cluster de desenvolvimento local e para implementação de aplicações do Visual Studio.Service Fabric uses Windows PowerShell scripts for creating a local development cluster and for deploying applications from Visual Studio. Por predefinição, o Windows bloqueará a execução destes scripts.By default, Windows blocks these scripts from running. Para ativá-los, tem de modificar a política de execução do PowerShell.To enable them, you must modify your PowerShell execution policy. Abra o PowerShell como administrador e introduza 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)

Service Fabric é um orquestrador de contêiner para implantar microserviç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 em seu 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. Obter Docker CE for Windows (estável).Get Docker CE for Windows (stable). Depois de instalar e iniciar o Docker, clique com o botão direito do rato no ícone de tabuleiro e selecione Mudar para os contentores do Windows.After installing and starting Docker, right-click on the tray icon and select Switch to Windows containers. Este passo é necessário para executar imagens do Docker baseadas no Windows.This step is required to run Docker images based on Windows.

Passos seguintesNext steps

Agora que o ambiente de desenvolvimento está configurado, pode começar a criar e executar aplicações.Now that you've finished setting up your development environment, start building and running apps.