Partilhar via

Preparar o ambiente de desenvolvimento no Linux

  • Artigo

Para implementar e executar aplicações do Azure Service Fabric no seu computador de desenvolvimento Linux, instale o runtime e o SDK comum. Também pode instalar SDKs opcionais para programação em Java e .NET Core.

As etapas neste artigo pressupõem que você instale nativamente no Linux ou use a imagem de contêiner OneBox do Service Fabric, ou seja, mcr.microsoft.com/service-fabric/onebox:u18.

Você pode gerenciar entidades do Service Fabric hospedadas na nuvem ou no local com a CLI (interface de linha de comando) do Azure Service Fabric. Para obter mais informações sobre como instalar a CLI, veja Configurar a CLI do Service Fabric.

Pré-requisitos

  • Certifique-se de que está a utilizar uma versão Linux suportada.

  • Instale o apt-transport-https pacote:

    sudo apt-get install apt-transport-https

Métodos de instalação

Atualizar as origens do APT

Para instalar o SDK e o pacote de runtime associado através da ferramenta de linha de comandos apt-get, primeiro tem de atualizar as origens do Advanced Packaging Tool (APT).

Instalação com script

Por conveniência, um script é fornecido para instalar o tempo de execução do Service Fabric e 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, bem como 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. Adicione o dotnet repositório à sua lista de fontes correspondente à sua distribuição.

    wget -q https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

  3. Adicione a nova chave MS Open Tech Gnu Privacy Guard (GnuPG ou GPG) ao seu porta-chaves APT.

    sudo curl -fsSL https://packages.microsoft.com/keys/msopentech.asc | sudo apt-key add -

  4. Adicione a chave de GPG oficial do Docker ao porta-chaves do APT.

    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

  5. Configure o repositório do Docker.

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

  6. Adicione a chave JDK Azul ao seu porta-chaves APT e configure seu repositório.

    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 0xB1998361219BD9C9
sudo apt-add-repository "deb http://repos.azul.com/azure-only/zulu/apt stable main"

  7. Atualize as listas de pacotes com base nos repositórios adicionados recentemente.

    sudo apt-get update

Instalar e configurar o SDK do Service Fabric para um cluster local

Depois de atualizar as origens, pode instalar o SDK. Instale o pacote do SDK do Service Fabric, confirme a instalação e aceite o contrato de licença.

Ubuntu

sudo apt-get install servicefabricsdkcommon

Gorjeta

Os comandos seguintes automatizam a aceitação da licença para pacotes do Service Fabric:

echo "servicefabric servicefabric/accepted-eula-ga select true" | sudo debconf-set-selections
echo "servicefabricsdkcommon servicefabricsdkcommon/accepted-eula-ga select true" | sudo debconf-set-selections

Configurar um cluster local

  1. Inicie um cluster local do Service Fabric para desenvolvimento.

Inicie um cluster Onebox do Service Fabric baseado em contêiner.

  1. Instale o Moby para poder implantar contêineres do Docker.

    sudo apt-get install moby-engine moby-cli -y

  2. Atualize a configuração do daemon do Docker em seu host com as seguintes configurações e reinicie o daemon do Docker. Detalhes: Ativar suporte a IPv6

    {
    "ipv6": true,
    "fixed-cidr-v6": "fd00::/64"
}

  3. Inicie o cluster.
    Ubuntu 20.04 LTS:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u20

    Ubuntu 18.04 LTS:

    docker run --name sftestcluster -d -v /var/run/docker.sock:/var/run/docker.sock -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 mcr.microsoft.com/service-fabric/onebox:u18

    Gorjeta

    Por predefinição, isto irá extrair a imagem com a versão mais recente do Service Fabric. Para revisões específicas, visite a página do Hub do Docker Hub.

  1. Abra um browser e aceda a Service Fabric Explorer (http://localhost:19080/Explorer). Quando o cluster for iniciado, verá o dashboard do Service Fabric Explorer. Pode demorar alguns minutos até o cluster estar totalmente configurado. Se o browser falhar em abrir o URL ou se o Service Fabric Explorer não indicar que o sistema está preparado, aguarde alguns minutos e tente novamente.

    Service Fabric Explorer no Linux

    Agora, pode implementar pacotes de aplicações do Service Fabric pré-configurados ou novos com base em contentores convidados ou em executáveis convidados. Para criar novos serviços com os SDKs Java ou .NET Core, siga os passos de configuração opcionais apresentados nas secções seguintes.

Nota

O Linux não suporta clusters autónomos.

Gorjeta

Se tiver um disco SSD disponível, recomendamos a passagem de um caminho de pasta SSD com --clusterdataroot, com devclustersetup.sh para um desempenho superior.

Configurar a CLI do Service Fabric

A CLI do Service Fabric inclui comandos para interagir com entidades do Service Fabric, incluindo clusters e aplicações. Para instalar a CLI, siga as instruções em CLI do Service Fabric.

Instalar geradores do Yeoman para contentores e executáveis convidados

O Service Fabric fornece ferramentas estruturais que o ajudam a criar aplicações do Service Fabric a partir de um terminal com os geradores de modelos Yeoman. Siga estes passos para configurar os geradores de modelos Yeoman do Service Fabric:

  1. Instale Node.js e npm no seu computador.

    sudo add-apt-repository "deb https://deb.nodesource.com/node_8.x $(lsb_release -s -c) main"
sudo apt-get update
sudo apt-get install nodejs

  2. Instale o gerador de modelos Yeoman no seu computador a partir do npm.

    sudo npm install -g yo

  3. Instale o gerador de contentor Yeo do Service Fabric e o gerador executável convidado a partir do npm.

    sudo npm install -g generator-azuresfcontainer  # for Service Fabric container application
sudo npm install -g generator-azuresfguest      # for Service Fabric guest executable application

Depois de instalar os geradores, crie serviços de contentor ou executáveis convidados ao executar yo azuresfguest ou yo azuresfcontainer, respetivamente.

Configurar o desenvolvimento do .NET Core 3.1

Instale o SDK do .NET Core 3.1 para Ubuntu para começar a criar aplicativos C# Service Fabric. Os pacotes para aplicativos .NET Core Service Fabric são hospedados no NuGet.org.

Configurar o desenvolvimento em Java

Para criar serviços do Service Fabric usando Java, instale o Gradle para executar tarefas de compilação. Execute o comando abaixo para instalar o Gradle. As bibliotecas Java do Service Fabric são extraídas do Maven.

  • Ubuntu

    curl -s https://get.sdkman.io | bash
sdk install gradle 5.1

  • Red Hat Enterprise Linux 7.4 (suporte de pré-visualização do Service Fabric)

    sudo yum install java-1.8.0-openjdk-devel
curl -s https://get.sdkman.io | bash
sdk install gradle

Também terá de instalar o gerador Yeo do Service Fabric para executáveis Java. Certifique-se de que tem o Yeoman instalado e, em seguida, execute o seguinte comando:

npm install -g generator-azuresfjava

Instalar o plug-in Eclipse (opcional)

Pode instalar o plug-in do Eclipse para o Service Fabric a partir do IDE do Eclipse para Programadores de Java ou Programadores de Java EE. Pode utilizar o Eclipse para criar aplicações executáveis de convidado do Service Fabric e aplicações de contentor, além de aplicações Java do Service Fabric.

Importante

O plug-in do Service Fabric requer o Eclipse ou uma versão posterior. Consulte as instruções que se seguem a esta nota para saber como verificar a sua versão do Eclipse. Se tiver uma versão anterior do Eclipse instalada, pode transferir as versões mais recentes do site do Eclipse. Recomendamos que não instale por cima de (substituir) uma versão existente do Eclipse. Remova-o antes de executar o instalador ou instale a versão mais recente num diretório diferente.

No Ubuntu, é recomendável instalar diretamente a partir do site do Eclipse, em vez de utilizar um instalador de pacote (apt ou apt-get). Se o fizer, assegura que obtém a versão mais recente do Eclipse. Pode instalar o Eclipse IDE para Programadores de Java ou para Programadores de Java EE.

  1. No Eclipse, certifique-se de que tem instalado o Eclipse Neon ou posterior e a versão 2.2.1 do Buildship ou posterior. Verifique as versões dos componentes instalados ao selecionar Ajuda>Acerca do Eclipse>Detalhes da Instalação. Pode atualizar o Buildship com as instruções apresentadas em Eclipse Buildship: Eclipse Plug-ins for Gradle (Eclipse Buildship: Plug-ins do Eclipse para Gradle).

  2. Para instalar o plug-in do Service Fabric, selecione Ajuda>Instalar Novo Software.

  3. Na caixa Compatível com, escreva https://dl.microsoft.com/eclipse.

  4. Selecione Adicionar.

    Página Software Disponível

  5. Selecione o plug-in ServiceFabric e selecione Seguinte.

  6. Execute os passos de instalação. Em seguida, aceite o contrato de licença do utilizador final.

Se já tiver o plug-in do Service Fabric para o Eclipse instalado, confirme que tem a versão mais recente. Verifique ao selecionar Ajuda>Acerca do Eclipse>Detalhes da Instalação. Em seguida, procure o Service Fabric na lista de plug-ins instalados. Selecione Atualizar se uma versão mais recente estiver disponível.

Para obter mais informações, veja Plug-in do Service Fabric para desenvolvimento de aplicações Java de Eclipse.

Atualizar o SDK e o runtime

Para atualizar para a versão mais recente do SDK e do runtime, execute os seguintes comandos.

sudo apt-get update
sudo apt-get install servicefabric servicefabricsdkcommon

Para atualizar os binários SDK do Java a partir do Maven, tem de atualizar os detalhes da versão do binário correspondente no ficheiro build.gradle, para que apontem para a versão mais recente. Para saber exatamente onde é necessário atualizar a versão, consulte qualquer ficheiro build.gradle nos exemplos de introdução ao Service Fabric.

Nota

Atualizar os pacotes pode fazer com que a execução do cluster de desenvolvimento local pare. Reinicie o cluster local após uma atualização ao seguir as instruções neste artigo.

Remover o SDK

Para remover os SDKs do Service Fabric, execute os seguintes comandos.

  • Ubuntu

    sudo apt-get remove servicefabric servicefabicsdkcommon
npm uninstall -g generator-azuresfcontainer
npm uninstall -g generator-azuresfguest
sudo apt-get install -f

  • Red Hat Enterprise Linux 7.4 (suporte de pré-visualização do Service Fabric)

    sudo yum remove servicefabric servicefabicsdkcommon
npm uninstall -g generator-azuresfcontainer
npm uninstall -g generator-azuresfguest

Próximos passos