Preparar seu ambiente de desenvolvimento no LinuxPrepare your development environment on Linux

Para implantar e executar os aplicativos do Azure Service Fabric em seu computador de desenvolvimento Linux, instale o tempo de execução e o SDK comum.To deploy and run Azure Service Fabric applications on your Linux development machine, install the runtime and common SDK. Você também pode instalar os SDKs opcionais para desenvolvimento em Java e .NET Core.You can also install optional SDKs for Java and .NET Core development.

As etapas neste artigo presumem a instalação nativa no Linux ou o uso da imagem de contêiner do Service Fabric OneBox, microsoft/service-fabric-onebox.The steps in this article assume that you install natively on Linux or use the Service Fabric OneBox container image, microsoft/service-fabric-onebox.

Não há suporte para a instalação do tempo de execução do Service Fabric e do SDK no subsistema do Windows para Linux.Installing the Service Fabric runtime and SDK on Windows Subsystem for Linux is not supported. É possível gerenciar entidades do Service Fabric hospedadas em outro lugar na nuvem ou no local com a interface de linha de comando (CLI) do Azure Service Fabric, para a qual há suporte.You can manage Service Fabric entities hosted elsewhere in the cloud or on-premises with the Azure Service Fabric command-line interface (CLI), which is supported. Para obter informações sobre como instalar a CLI, consulte Configurar a CLI do Service Fabric.For information on how to install the CLI, see Set up the Service Fabric CLI.

Pré-requisitosPrerequisites

Há suporte de desenvolvimento para estas versões de sistema operacional.These operating system versions are supported for development.

  • Ubuntu 16.04 (Xenial Xerus)Ubuntu 16.04 (Xenial Xerus)

    Verifique se o pacote apt-transport-https está instalado.Make sure that the apt-transport-https package is installed.

    sudo apt-get install apt-transport-https
    
  • Red Hat Enterprise Linux 7.4 (suporte à versão prévia do Service Fabric)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

Métodos de instalaçãoInstallation methods

Instalação por script (Ubuntu)Script installation (Ubuntu)

Para conveniência, um script é fornecido para instalar o tempo de execução do Service Fabric e o SDK do Service Fabric comum juntamente com a CLI sfctl.For convenience, a script is provided to install the Service Fabric runtime and the Service Fabric common SDK along with the sfctl CLI. Execute as etapas de instalação manual da próxima seção.Run the manual installation steps in the next section. Você vê o que está sendo instalado e as licenças associadas.You see what is being installed and the associated licenses. A execução do script supõe que você concorda com as licenças para todos os softwares que estão sendo instalados.Running the script assumes you agree to the licenses for all the software that is being installed.

Depois que o script for executado com êxito, é possível pular para Configurar um cluster local.After the script runs successfully, you can skip to Set up a local cluster.

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

Instalação manualManual installation

Para a instalação manual do tempo de execução do Service Fabric e SDK comum, siga o restante deste guia.For manual installation of the Service Fabric runtime and common SDK, follow the rest of this guide.

Atualizar suas fontes APT ou repositórios YumUpdate your APT sources or Yum repositories

Para instalar o SDK e o pacote de execução associado via ferramenta da linha de comando apt-get, primeiro atualize as fontes APT (Advanced Packaging Tool).To install the SDK and associated runtime package via the apt-get command-line tool, you must first update your Advanced Packaging Tool (APT) sources.

UbuntuUbuntu

  1. Abra um terminal.Open a terminal.

  2. Adicione o repositório do Service Fabric à sua lista de fontes.Add the Service Fabric repo to your sources list.

    sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/servicefabric/ xenial main" > /etc/apt/sources.list.d/servicefabric.list'
    
  3. Adicionar o repositório dotnet à sua lista de fontes.Add the dotnet repo to your sources list.

    wget -q https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
    
  4. Adicione a nova chave Gnu Privacy Guard (GnuPG ou GPG) ao arquivo de chaves APT.Add the new Gnu Privacy Guard (GnuPG or GPG) key to your APT keyring.

    curl -fsSL https://packages.microsoft.com/keys/msopentech.asc | sudo apt-key add -
    
  5. Adicione a chave GPG oficial do Docker ao arquivo de chaves APT.Add the official Docker GPG key to your APT keyring.

    sudo apt-get install curl
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    
  6. Configure o repositório do Docker.Set up the Docker repository.

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
    
  7. Adicionar chave de JDK Azul ao seu token de autenticação APT e configurar seu repositório.Add Azul JDK Key to your APT keyring and setup its repository.

    curl -fsSL https://repos.azul.com/azul-repo.key | sudo apt-key add -
    sudo add-apt-repository 'deb http://repos.azulsystems.com/ubuntu stable main'
    
  8. Atualize suas listas de pacote com base nos repositórios recém-adicionados.Refresh your package lists based on the newly added repositories.

    sudo apt-get update
    

Red Hat Enterprise Linux 7.4 (suporte à versão prévia do Service Fabric)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

  1. Abra um terminal.Open a terminal.

  2. Faça o download e instale EPEL (Pacotes adicionais para Enterprise Linux).Download and install Extra Packages for Enterprise Linux (EPEL).

    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    sudo yum install epel-release-latest-7.noarch.rpm
    
  3. Adicione o repositório de pacotes de EfficiOS RHEL7 ao seu sistema.Add the EfficiOS RHEL7 package repository to your system.

    sudo wget -P /etc/yum.repos.d/ https://packages.efficios.com/repo.files/EfficiOS-RHEL7-x86-64.repo
    
  4. Importe a chave de assinatura do pacote EfficiOS para o chaveiro GPG local.Import the EfficiOS package signing key to the local GPG keyring.

    sudo rpmkeys --import https://packages.efficios.com/rhel/repo.key
    
  5. Adicione o repositório RHEL da Microsoft ao seu sistema.Add the Microsoft RHEL repository to your system.

    curl https://packages.microsoft.com/config/rhel/7.4/prod.repo > ./microsoft-prod.repo
    sudo cp ./microsoft-prod.repo /etc/yum.repos.d/
    
  6. Instale o SDK do .NET.Install the .NET SDK.

    yum install rh-dotnet20 -y
    

Instalar e configurar o SDK do Service Fabric para um cluster localInstall and set up the Service Fabric SDK for a local cluster

Após a atualização das fontes, você poderá instalar o SDK.After you update your sources, you can install the SDK. Instale o pacote do SDK do Service Fabric, confirme a instalação e aceite o contrato de licença.Install the Service Fabric SDK package, confirm the installation, and accept the license agreement.

UbuntuUbuntu

sudo apt-get install servicefabricsdkcommon

Dica

Os comandos a seguir automatizam a aceitação da licença para pacotes do Service Fabric:The following commands automate accepting the license for Service Fabric packages:

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

Red Hat Enterprise Linux 7.4 (suporte à versão prévia do Service Fabric)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

sudo yum install servicefabricsdkcommon

O tempo de execução do Service Fabric que vem com a instalação anterior do SDK inclui os pacotes da tabela a seguir.The Service Fabric runtime that comes with the SDK installation includes the packages in the following table.

DotNetCoreDotNetCore JavaJava PythonPython NodeJSNodeJS
UbuntuUbuntu 2.0.02.0.0 AzulJDK 1.8AzulJDK 1.8 Implícito do npmImplicit from npm latestlatest
RHELRHEL - OpenJDK 1.8OpenJDK 1.8 Implícito do npmImplicit from npm latestlatest

Configurar um cluster localSet up a local cluster

Inicie um cluster local após a conclusão da instalação.Start a local cluster after the installation finishes.

  1. Execute o script de configuração do cluster.Run the cluster setup script.

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
    
  2. Abra um navegador da web e vá para o Service Fabric Explorer (http://localhost:19080/Explorer).Open a web browser and go to Service Fabric Explorer (http://localhost:19080/Explorer). Ao iniciar o cluster, você vê o painel do Service Fabric Explorer.When the cluster starts, you see the Service Fabric Explorer dashboard. A configuração completa do cluster pode demorar alguns minutos.It might take several minutes for the cluster to be completely set up. Se o seu navegador não conseguir abrir a URL, ou se o Service Fabric Explorer não mostrar que o sistema está pronto, aguarde alguns minutos e tente novamente.If your browser fails to open the URL or if Service Fabric Explorer doesn't show that the system is ready, wait a few minutes and try again.

    Service Fabric Explorer no Linux

    Agora você pode implantar os pacotes do aplicativo Service Fabric predefinidos ou novos com base nos contêineres ou executáveis do convidado.Now you can deploy prebuilt Service Fabric application packages or new ones based on guest containers or guest executables. Para compilar novos serviços usando os SDKs do Java ou .NET Core, siga as etapas de configuração opcionais fornecidas nas próximas seções.To build new services by using the Java or .NET Core SDKs, follow the optional setup steps that are provided in the next sections.

Observação

Não há suporte para os clusters autônomos no Linux.Standalone clusters aren't supported in Linux.

Dica

Se você tiver um disco SSD disponível, é recomendável passar um caminho de pasta SSD usando --clusterdataroot com devclustersetup.sh para obter um desempenho melhor.If you have an SSD disk available, we recommend to pass an SSD folder path by using --clusterdataroot with devclustersetup.sh for superior performance.

Configurar a CLI do Service FabricSet up the Service Fabric CLI

A CLI do Service Fabric tem comandos para interagir com as entidades do Service Fabric, inclusive clusters e aplicativos.The Service Fabric CLI has commands for interacting with Service Fabric entities, including clusters and applications. Para instalar a CLI, siga as instruções em CLI do Service Fabric.To install the CLI, follow the instructions at Service Fabric CLI.

Configurar os geradores do Yeoman para os contêineres e executáveis do convidadoSet up Yeoman generators for containers and guest executables

O Service Fabric fornece ferramentas de scaffolding que ajudam a criar aplicativos do Service Fabric em um terminal usando geradores de modelos Yeoman.Service Fabric provides scaffolding tools that help you create Service Fabric applications from a terminal by using Yeoman template generators. Siga estas etapas para configurar os geradores de modelo do Yeoman do Service Fabric:Follow these steps to set up the Service Fabric Yeoman template generators:

  1. Instale o Node.js e o npm em seu computador.Install Node.js and npm on your machine.

    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 do npm em seu computador.Install the Yeoman template generator from npm on your machine.

    sudo npm install -g yo
    
  3. Instalar o gerador de contêineres Yeo do Service Fabric e o gerador de executáveis do convidado a partir do npm.Install the Service Fabric Yeo container generator and guest executable generator from npm.

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

Após a instalação dos geradores, crie os serviços do contêiner ou do executável do convidado executando yo azuresfguest ou yo azuresfcontainer respectivamente.After you install the generators, create guest executable or container services by running yo azuresfguest or yo azuresfcontainer, respectively.

Configurar o desenvolvimento do .NET Core 2.0Set up .NET Core 2.0 development

Instale o SDK do .NET Core 2.0 para Ubuntu para iniciar a criação de aplicativos do Service Fabric em C#.Install the .NET Core 2.0 SDK for Ubuntu to start creating C# Service Fabric applications. Os pacotes hospedados do NuGet.org para aplicativos do .NET Core 2.0 Service Fabric estão em versão prévia atualmente.NuGet.org hosts packages for .NET Core 2.0 Service Fabric applications, currently in preview.

Configurar o desenvolvimento de JavaSet up Java development

Para criar serviços do Service Fabric usando o Java, instale o Gradle para executar tarefas de compilação.To build Service Fabric services using Java, install Gradle to run build tasks. Execute o comando abaixo para instalar o Gradle.Run the below command to install Gradle. As bibliotecas Java do Service Fabric são extraídas do Maven.The Service Fabric Java libraries are pulled from Maven.

  • UbuntuUbuntu

    curl -s https://get.sdkman.io | bash
    sdk install gradle 5.1
    
  • Red Hat Enterprise Linux 7.4 (suporte à versão prévia do Service Fabric)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

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

Você também precisa instalar o gerador de Yeo do Service Fabric para executáveis do Java.You also need to install the Service Fabric Yeo generator for Java executables. Verifique se você tem o Yeoman instalado, depois execute o seguinte comando:Make sure you have Yeoman installed, and then run the following command:

npm install -g generator-azuresfjava

Instalar o plug-in do Eclipse (opcional)Install the Eclipse plug-in (optional)

Você pode instalar o plug-in Eclipse do Service Fabric de dentro do IDE do Eclipse para Desenvolvedores Java ou Java EE para Desenvolvedores.You can install the Eclipse plug-in for Service Fabric from within the Eclipse IDE for Java Developers or Java EE Developers. Você pode usar o Eclipse para criar aplicativos executáveis de convidado do Service Fabric e aplicativos de contêiner além dos aplicativos Java do Service Fabric.You can use Eclipse to create Service Fabric guest executable applications and container applications in addition to Service Fabric Java applications.

Importante

O plug-in do Service Fabric requer o Eclipse Neon ou uma versão posterior.The Service Fabric plug-in requires Eclipse Neon or a later version. Consulte as instruções após essa observação para saber como verificar qual versão do Eclipse você possui.See the instructions that follow this note for how to check your version of Eclipse. Se você tiver uma versão anterior do Eclipse instalada, pode baixar as versões mais recentes no site do Eclipse.If you have an earlier version of Eclipse installed, you can download more recent versions from the Eclipse site. Não é recomendável instalar por cima de (substituir) uma instalação existente do Eclipse.We recommend that you do not install on top of (overwrite) an existing installation of Eclipse. Remova-a antes de executar o instalador ou instale a versão mais recente em um diretório diferente.Either remove it before running the installer, or install the newer version in a different directory.

No Ubuntu, é recomendável instalar diretamente a partir do site do Eclipse em vez de usar um instalador de pacote (apt ou apt-get).On Ubuntu, we recommend installing directly from the Eclipse site rather than using a package installer (apt or apt-get). Isso garante que você obtenha a versão mais atual do Eclipse.Doing so ensures that you get the most current version of Eclipse. Você pode instalar o IDE do Eclipse para Desenvolvedores Java ou para Java EE para Desenvolvedores.You can install the Eclipse IDE for Java Developers or for Java EE Developers.

  1. No Eclipse, verifique se você instalou o Eclipse Neon ou posterior e o Buildship versão 2.2.1 ou posterior.In Eclipse, make sure that you have installed Eclipse Neon or later and Buildship version 2.2.1 or later. Verifique as versões dos componentes instalados selecionando Ajuda > Sobre o Eclipse > Detalhes da Instalação.Check the versions of installed components by selecting Help > About Eclipse > Installation Details. Você pode atualizar Buildship usando as instruções em Buildship do Eclipse: Plug-ins do Eclipse para Gradle.You can update Buildship by using the instructions at Eclipse Buildship: Eclipse Plug-ins for Gradle.

  2. Para instalar o plug-in Service Fabric, selecioneAjuda > Instalar Novo Software.To install the Service Fabric plug-in, select Help > Install New Software.

  3. Na caixa Trabalhar com, insira https://dl.microsoft.com/eclipse .In the Work with box, enter https://dl.microsoft.com/eclipse.

  4. Selecione Adicionar.Select Add.

    Página do software disponível

  5. Selecione o plug-in ServiceFabric e selecione Avançar.Select the ServiceFabric plug-in, and then select Next.

  6. Execute as etapas de instalação.Perform the installation steps. Depois aceite os termos de licença do usuário final.Then accept the end-user license agreement.

Se você já tiver o plug-in Service Fabric instalado, verifique se tem a versão mais recente.If you already have the Service Fabric Eclipse plug-in installed, make sure that you have the latest version. Faça a verificação selecionando Ajuda > Sobre o Eclipse > Detalhes da Instalação.Check by selecting Help > About Eclipse > Installation Details. Em seguida, procure o Service Fabric na lista de plug-ins instalados. Selecione Atualizar se houver uma versão mais recente disponível.Then search for Service Fabric in the list of installed plug-ins. Select Update if a newer version is available.

Para obter mais informações, consulte Plug-in Service Fabric para o desenvolvimento de aplicativos Java do Eclipse.For more information, see Service Fabric plug-in for Eclipse Java application development.

Atualizar SDK e execuçãoUpdate the SDK and runtime

Para atualizar para a versão mais recente do SDK e tempo de execução, execute os seguintes comandos.To update to the latest version of the SDK and runtime, run the following commands.

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

Para atualizar os binários SDK do Java a partir do Maven, você precisa atualizar os detalhes da versão do binário correspondente no arquivo build.gradle para apontar para a versão mais recente.To update the Java SDK binaries from Maven, you need to update the version details of the corresponding binary in the build.gradle file to point to the latest version. Para saber exatamente onde você precisa atualizar a versão, consulte qualquer build.gradle arquivo nos exemplos de introdução do Service Fabric.To know exactly where you need to update the version, refer to any build.gradle file in the Service Fabric getting-started samples.

Observação

Atualizar os pacotes pode causar a interrupção do seu cluster de desenvolvimento local.Updating the packages might cause your local development cluster to stop running. Reinicie o cluster local após uma atualização seguindo as instruções deste artigo.Restart your local cluster after an upgrade by following the instructions in this article.

Remover o SDKRemove the SDK

Para remover os SDKs do Service Fabric, execute os comandos a seguir.To remove the Service Fabric SDKs, run the following commands.

  • UbuntuUbuntu

    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 à versão prévia do Service Fabric)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

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

Próximas etapasNext steps