Preparar seu ambiente de desenvolvimento no Windows

Para compilar e executar os aplicativos do Azure Service Fabric no computador de desenvolvimento do Windows, instale o runtime do Service Fabric, o SDK e as ferramentas. Você também precisa habilitar a execução dos scripts do Windows PowerShell incluídos no SDK.

Pré-requisitos

Verifique se você está usando uma versão do Windows com suporte.

Baixar e instalar o runtime e o SDK

Observação

O WebPI usado anteriormente para instalação de SDK/Ferramentas foi preterido em 1º de julho de 2022

O runtime pode ser instalado de forma independente. No entanto, o SDK requer o runtime. Portanto, para um ambiente de desenvolvimento, você deve instalar o runtime e o SDK. Os seguintes links são downloads das versões mais recentes do runtime e do SDK:

Pacote Versão
Instalar o runtime do Service Fabric para Windows 11.8.121.1
Instalar o SDK do Service Fabric 8.8.121

Você pode encontrar links diretos para os instaladores para versões anteriores em Versões do Service Fabric.

Para saber as versões com suporte, confira versões do Service Fabric.

Instalar o runtime

O instalador do runtime deve ser executado em um shell de linha de comando, e você deve usar o sinalizador /accepteula. É recomendável executar o shell de linha de comando com privilégios elevados para manter as impressões de log. O seguinte exemplo está no PowerShell:

.\MicrosoftServiceFabric.<version>.exe /accepteula

Instalar o SDK

Depois que o runtime for instalado, será possível instalar o SDK com êxito. Você pode executar o instalador no shell de linha de comando ou no explorador de arquivos.

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.

Para usar Visual Studio 2017, 2019, 2022 ou 2026

As Ferramentas do Service Fabric fazem parte da carga de trabalho de desenvolvimento do Azure no Visual Studio 2019 e 2017. Habilite essa carga de trabalho como parte da instalação do Visual Studio. Além disso, você precisa instalar o runtime e o SDK do Microsoft Azure Service Fabric, conforme descrito acima em Baixar e instalar o runtime e o SDK.

Para usar especificamente o Visual Studio 2026, baixe a extensão "Service Fabric Tools" no Visual Studio Marketplace: Service Fabric Tools Extension

Habilitar a execução de script do PowerShell

A Malha do Serviço usa scripts do Windows PowerShell para criar um cluster de desenvolvimento local e implantar aplicativos do Visual Studio. Por padrão, o Windows bloqueia a execução desses scripts. Para habilitá-los, você deve modificar sua política de execução do PowerShell. Abra o PowerShell com um administrador e insira o seguinte comando:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Instalar o Docker (opcional)

O Service Fabric é um orquestrador de contêineres para implantação de microsserviços em um cluster de computadores. Para executar aplicativos de contêiner do Windows no cluster de desenvolvimento local, você deve primeiro instalar o Docker for Windows. Obtenha o Docker CE for Windows (estável). Depois de instalar e iniciar o Docker, clique com o botão direito do mouse no ícone de bandeja e selecione Alternar para contêineres do Windows. Essa etapa é necessária para executar imagens do Docker com base no Windows.

Próximas etapas

Agora que você terminou de configurar seu ambiente de desenvolvimento, comece a compilar e executar aplicativos.

  • Última atualização em