Preparar o ambiente de desenvolvimento no Windows

  • Artigo

Para compilar e executar aplicações do Azure Service Fabric no computador de desenvolvimento Windows, tem de instalar o runtime do Service Fabric, o SDK e as ferramentas. Também precisa de ativar a execução dos scripts do Windows PowerShell incluídos no SDK.

Pré-requisitos

Certifique-se de que está a utilizar uma versão suportada do Windows.

Baixe e instale o tempo de execução e o SDK

Nota

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

O tempo de execução pode ser instalado independentemente. No entanto, o SDK requer o tempo de execução, portanto, para um ambiente de desenvolvimento, você deve instalar o tempo de execução e o SDK. Os links a seguir são baixados para as versões mais recentes do tempo de execução e do SDK:

Pacote Versão
Instalar o Tempo de Execução do Service Fabric para Windows 10.1.2493.9590
Instalar o SDK do Service Fabric 7.1.2493

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

Para versões suportadas, consulte Versões do Service Fabric.

Instalar o tempo de execução

O instalador do tempo de execução deve ser executado a partir de um shell de linha de comando e você deve usar o /accepteula sinalizador. Recomendamos que você execute seu shell de linha de comando com privilégios elevados para manter as impressões de log. O exemplo a seguir está no PowerShell:

.\MicrosoftServiceFabric.<version>.exe /accepteula

Instale o SDK

Depois que o tempo de execução estiver instalado, você poderá instalar o SDK com êxito. Você pode executar o instalador a partir do shell de linha de comando ou do explorador de arquivos.

Nota

Não há suporte para clusters de máquina única (OneBox) para atualizações de aplicativos ou clusters; exclua o cluster OneBox e recrie-o se precisar executar uma atualização de Cluster ou tiver problemas para executar uma atualização de Aplicativo.

Para usar o Visual Studio 2017 ou 2019

As Ferramentas do Service Fabric fazem parte da carga de trabalho do Desenvolvimento do Azure no Visual Studio 2019 e 2017. Ative esta carga de trabalho como parte da instalação do Visual Studio. Além disso, você precisa instalar o SDK e o tempo de execução do Microsoft Azure Service Fabric conforme descrito acima Baixar e instalar o tempo de execução e o SDK.

Ativar a execução do script do PowerShell

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. Por predefinição, o Windows bloqueará a execução destes scripts. Para ativá-los, tem de modificar a política de execução do PowerShell. Abra o PowerShell como administrador e introduza o seguinte comando:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Instalar o Docker (opcional)

O Service Fabric é um orquestrador de contêineres para a implantação de microsserviços em um cluster de máquinas. Para executar aplicativos de contêiner do Windows em seu cluster de desenvolvimento local, você deve primeiro instalar o Docker para Windows. Obtenha o Docker CE para Windows (estável). Depois de instalar e iniciar o Docker, clique com o botão direito do mouse no ícone da bandeja e selecione Alternar para contêineres do Windows. Este passo é necessário para executar imagens do Docker baseadas no Windows.

Próximos passos

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