Preparar o ambiente de desenvolvimento no Linux

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.

Os passos neste artigo partem do princípio de que instala nativamente no Linux ou utiliza a imagem de contentor do OneBox do Service Fabric, ou seja, mcr.microsoft.com/service-fabric/onebox:u18.

Pode gerir entidades do Service Fabric alojadas na cloud ou no local com a interface de linha de comandos (CLI) 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 do 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

Para conveniência, é fornecido um script para instalar o runtime do Service Fabric e o SDK comum do Service Fabric, juntamente 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. Em alternativa, pode executar os passos de instalação manual na próxima secção que apresentará licenças associadas, bem como os componentes que estão a ser 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 à lista de origens 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 do 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 à sua tecla APT e configure o 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

Dica

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 contentores.

  1. Instale o Moby para poder implementar contentores do Docker.

    sudo apt-get install moby-engine moby-cli -y
    
  2. Atualize a configuração do daemon do Docker no anfitrião com as seguintes definições e reinicie o daemon do Docker. Detalhes: Ativar o suporte 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
    

    Dica

    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.

Dica

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 .NET Core 3.1 para ubuntu para começar a criar aplicações do Service Fabric C#. Os pacotes para aplicações do Service Fabric .NET Core estão alojados no NuGet.org.

Configurar o desenvolvimento em Java

Para criar serviços do Service Fabric com 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 Neon 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> Sobreos Detalhes da Instalação doEclipse>. 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 Ajudar a>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> Sobreos Detalhes da Instalação doEclipse>. Em seguida, procure o Service Fabric na lista de plug-ins instalados. Selecione Atualizar se estiver disponível uma versão mais recente.

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
    

Passos seguintes