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.
Abra um terminal.
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
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 -
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 -
Configure o repositório do Docker.
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
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"
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
- Inicie um cluster local do Service Fabric para desenvolvimento.
Inicie um cluster onebox do Service Fabric baseado em contentores.
Instale o Moby para poder implementar contentores do Docker.
sudo apt-get install moby-engine moby-cli -y
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" }
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.
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.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:
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
Instale o gerador de modelos Yeoman no seu computador a partir do npm.
sudo npm install -g yo
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.
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).
Para instalar o plug-in do Service Fabric, selecione Ajudar a>Instalar Novo Software.
Na caixa Compatível com, escreva https://dl.microsoft.com/eclipse.
Selecione Adicionar.
Selecione o plug-in ServiceFabric e selecione Seguinte.
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
- Criar e implementar a sua primeira aplicação Java do Service Fabric no Linux com o Yeoman
- Criar e implementar a sua primeira aplicação Java do Service Fabric no Linux com o Plug-in do Service Fabric para Eclipse
- Criar a sua primeira aplicação C# no Linux
- Prepare your development environment on OSX (Preparar o ambiente de desenvolvimento no OSX)
- Prepare a Linux development environment on Windows (Preparar um ambiente de desenvolvimento do Linux no Windows)
- Gerir as aplicações com a CLI do Service Fabric
- Diferenças do Service Fabric no Windows e no Linux
- Introdução à CLI do Service Fabric