Partilhar via

Configurar um cluster do Linux Service Fabric via WSL2 em sua máquina de desenvolvedor Windows

  • Artigo

Este documento aborda como configurar um cluster Linux Service Fabric local via WSL2 em uma máquina de desenvolvimento Windows. Configurar um cluster Linux local é útil para testar rapidamente aplicativos direcionados para clusters Linux, mas são desenvolvidos em uma máquina Windows.

Pré-requisitos

Os clusters do Service Fabric baseados em Linux não são executados diretamente no Windows, mas para habilitar a prototipagem entre plataformas, fornecemos uma maneira de implantar o Service Fabric Cluster dentro da distribuição Linux via WSL2 (Subsistema Windows para Linux) para Windows.

Antes de começar, vai precisar do:

  • WSL2 Configurar no Windows e garantir WSL 2 como versão padrão
  • Configurar a distribuição Linux do Ubuntu 18.04 da Microsoft Store durante a configuração do WSL2

Gorjeta

Para instalar o WSL2 em sua máquina Windows, siga as etapas na documentação do WSL. Após a instalação, por favor, certifique-se de instalação do Ubuntu-18.04, torná-lo sua distribuição padrão e ele deve estar pronto e funcionando.

Configurar o SDK do Service Fabric dentro da distribuição Linux

A Instalação do Service Fabric não pode ser feita na Distribuição Linux WSL2 da mesma forma que é feita no sistema operacional linux padrão. Como systemd como PID1 não está sendo executado dentro da VM e systemd como PID1 é um pré-requisito para que o SF SDK funcione com êxito. Para habilitar o systemd como PID1, systemd-genie é usado como solução alternativa. Mais detalhes sobre o systemd-genie podem ser encontrados em systemd genie setup As etapas de instalação do script e da instalação manual abrangem a instalação do systemd-genie e do service fabric sdk.

Instalação com script

Por conveniência, um script é fornecido para instalar o SDK comum do Service Fabric junto com a CLI sfctl. A execução do script parte do princípio de que concorda com as licenças de todo o software que está a ser instalado. Como alternativa, você pode executar as etapas de instalação manual na próxima seção, que apresentará as licenças associadas e os componentes que estão sendo instalados.

Após a execução com êxito do script, pode avançar para Configurar um cluster local.

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh | sudo bash

Instalação manual

Para instalar manualmente o runtime do Service Fabric e o SDK comum, siga o resto deste guia.

  1. Abra um terminal.

  2. Faça login na distribuição WSL2 Linux

  3. Configure o systemd-genie como mencionado na configuração do systemd genie (se o systemd-genie já estiver configurado, você pode pular para a próxima etapa)

  4. Entre no namespace genie usando genie -s

  5. Dentro do namespace genie, o SF SDK também pode ser instalado conforme mencionado em Etapas de Instalação de Script ou Instalação Manual em Configurar um cluster local linux

  6. Forneça privilégios sudo ao usuário atual fazendo uma entrada <USERNAME\> ALL = (ALL) NOPASSWD:ALL em /etc/sudoers

Configurar um cluster local

O Service Fabric dentro da VM WSL2 é recomendado para gerenciar a partir de janelas de host

  1. Instalar o SDK do Service Fabric (versão 6.0 ou superior) no host do Windows

  2. No Windows, o cluster pode ser gerenciado usando a ferramenta ServiceFabricLocalClusterManager fornecida como parte do SF SDK

  3. A opção para gerenciar o Linux Local Cluster é ativada somente quando a. WSL2 VM está em execução, b. Os pacotes Systemd-genie, servicefabricruntime e servicefabricsdkcommon são instalados corretamente dentro de VM e c. Systemd-genie está em estado de execução. Você pode configurar ou alternar para o Linux Local Cluster a partir desta ferramenta.

  4. Outra maneira de configurar o cluster linux é implantar usando scripts de configuração de cluster fornecidos como parte do SF SDK.

  5. Abra um navegador da Web e vá para Service Fabric Explorer http://localhost:19080. Quando o cluster for iniciado, verá o dashboard do Service Fabric Explorer. Pode levar vários minutos para que o cluster seja configurado. Se o navegador não conseguir abrir a URL ou se o Service Fabric Explorer não mostrar o cluster, aguarde alguns minutos e tente novamente. Você também pode ver o cluster no ServiceFabricExplorer fornecido no SF SDK.

  6. Depois que o Cluster estiver instalado e em execução, você poderá se conectar ao cluster local no PowerShell e no Visual Studio.

Instalação manual com ServiceFabric personalizado e pacote Debian ServieFabricSdkCommon

Para a instalação manual do Service Fabric a partir de pacotes debian personalizados ou baixados, siga o resto deste guia.

  1. Abra um terminal.

  2. Faça login na distribuição WSL2 Linux

  3. Clonar arquivo de configuração

sudo curl -s https://raw.githubusercontent.com/Azure/service-fabric-scripts-and-templates/master/scripts/SetupServiceFabric/SetupServiceFabric.sh > SetupServiceFabric.sh
  1. Tornar o ficheiro executável
sudo chmod +x SetupServiceFabric.sh
  1. Execute o script de configuração com o caminho de pacotes debian local. Certifique-se de que os caminhos fornecidos são válidos. Abaixo encontra-se um exemplo:
sudo ./SetupServiceFabric.sh --servicefabricruntime=/mnt/c/Users/testuser/Downloads/servicefabric.deb --servicefabricsdk=/mnt/c/Users/testuser/Downloads/servicefabric_sdkcommon.deb

Limitações Conhecidas

A seguir estão as limitações conhecidas do cluster local em execução dentro da Distribuição Linux:

  • Atualmente, a distribuição Ubuntu-18.04 só é suportada.
  • Para ter uma experiência perfeita com o Gerenciador de Cluster Local e o Visual Studio, é recomendável gerenciar o cluster a partir de scripts do PowerShell ou LocalClusterManager no host do Windows.

Perguntas Mais Frequentes

  1. Quais distribuições linux são suportadas para SF Local Cluster Setup?
    Atualmente, apenas o Ubuntu-18.04 é suportado para cluster local linux.

  2. O Windows e Linux SF Cluster pode ser executado em paralelo com a configuração do WSL2?
    Não, ao mesmo tempo, apenas um cluster local pode ser executado no host ou na VM convidada.

  3. Como implantar um nó linux cluster local?
    Um nó ou cinco nós linux cluster local pode ser implantado a partir do Local Cluster Manager a partir das opções do menu. Durante a implantação a partir do script de instalação, o cluster de cinco nós é implantado por padrão e, para um cluster de nó, CreateOneNodeCluster deve ser passado.

  4. Como se conectar ao Linux Local Cluster no PowerShell e Visual Studio?
    Se o cluster local linux estiver ativo e em execução, o cmdlet connect-servicefabriccluster deverá se conectar automaticamente a esse cluster. Visual Studio semelhante detetará automaticamente esse cluster local. Esse cluster também pode ser conectado fornecendo ponto de extremidade de cluster no PowerShell ou no visual studio.

  5. Onde estão localizados os dados do SF Cluster para o cluster local linux?
    Se estiver usando a distribuição Ubuntu-18.04, os dados SF estão localizados em \wsl$\Ubuntu-18.04\home\sfuser\sfdevcluster do host Windows.

Próximos passos