Vorbereiten Ihrer Entwicklungsumgebung unter LinuxPrepare your development environment on Linux

Zur Bereitstellung und Ausführung von Azure Service Fabric-Anwendungen auf Ihrem Linux-Entwicklungscomputer müssen Sie die Laufzeit und das allgemeine SDK installieren.To deploy and run Azure Service Fabric applications on your Linux development machine, install the runtime and common SDK. Darüber hinaus können Sie auch optionale SDKs für die Java- und .NET Core-Entwicklung installieren.You can also install optional SDKs for Java and .NET Core development.

Bei den Schritten in diesem Artikel wird davon ausgegangen, dass Sie eine native Installation unter Linux durchführen oder das Service Fabric-One-Box-Containerimage (microsoft/service-fabric-onebox) verwenden.The steps in this article assume that you install natively on Linux or use the Service Fabric OneBox container image, microsoft/service-fabric-onebox.

Die Service Fabric-Laufzeit und das SDK können nicht unter dem Windows-Subsystem für Linux installiert werden.Installing the Service Fabric runtime and SDK on Windows Subsystem for Linux is not supported. Sie können Service Fabric-Entitäten, die an anderen Orten in der Cloud oder lokal gehostet werden, mit der Azure Service Fabric-Befehlszeilenschnittstelle (Command-Line Interface, CLI) verwalten. Diese wird unterstützt.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. Informationen zum Installieren der Befehlszeilenschnittstelle finden Sie unter Azure Service Fabric CLI.For information on how to install the CLI, see Set up the Service Fabric CLI.

VoraussetzungenPrerequisites

Die folgenden Betriebssystemversionen werden bei der Entwicklung unterstützt:These operating system versions are supported for development.

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

    Stellen Sie sicher, dass das Paket apt-transport-https installiert ist.Make sure that the apt-transport-https package is installed.

    sudo apt-get install apt-transport-https
    
  • Red Hat Enterprise Linux 7.4 (Unterstützung der Service Fabric-Vorschauversion)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

InstallationsmethodenInstallation methods

Skriptinstallation (Ubuntu)Script installation (Ubuntu)

Ein Skript soll Ihnen als Hilfe beim Installieren der Service Fabric-Runtime und des allgemeinen Service Fabric SDK zusammen mit der sfctl-CLI dienen.For convenience, a script is provided to install the Service Fabric runtime and the Service Fabric common SDK along with the sfctl CLI. Führen Sie die Schritte für die manuelle Installation im nächsten Abschnitt aus.Run the manual installation steps in the next section. Sie sehen die installierten Komponenten und die zugehörigen Lizenzen.You see what is being installed and the associated licenses. Für die Ausführung des Skripts wird vorausgesetzt, dass Sie den Lizenzen für die gesamte zu installierende Software zustimmen.Running the script assumes you agree to the licenses for all the software that is being installed.

Nach der erfolgreichen Ausführung des Skripts können Sie direkt zu Einrichten eines lokalen Clusters springen.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

Manuelle InstallationManual installation

Die Schritte zum manuellen Installieren der Service Fabric-Runtime und des allgemeinen SDK finden Sie im restlichen Teil dieser Anleitung.For manual installation of the Service Fabric runtime and common SDK, follow the rest of this guide.

Aktualisieren Ihrer APT-Quellen oder Yum-RepositorysUpdate your APT sources or Yum repositories

Um das SDK und das dazugehörige Runtimepaket über das Befehlszeilenprogramm „apt-get“ installieren zu können, müssen Sie zunächst Ihre APT-Datenquellen (Advanced Packaging Tool) aktualisieren.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. Öffnen Sie ein Terminal.Open a terminal.

  2. Fügen Sie der Quellenliste das Service Fabric-Repository hinzu.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. Fügen Sie das dotnet-Repository Ihrer Quellenliste hinzu.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. Fügen Sie Ihrem APT-Schlüsselbund den neuen GnuPG- bzw. GPG-Schlüssel (Gnu Privacy Guard) hinzu.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. Fügen Sie Ihrem APT-Schlüsselbund den offiziellen Docker-GPG-Schlüssel hinzu.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. Richten Sie das Docker-Repository ein.Set up the Docker repository.

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
    
  7. Fügen Sie Ihrem APT-Schlüsselbund den Azul JDK-Schlüssel hinzu, und richten Sie sein Repository ein.Add Azul JDK Key to your APT keyring and setup its repository.

    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"
    
  8. Aktualisieren Sie Ihre Paketlisten auf der Grundlage der neu hinzugefügten Repositorys.Refresh your package lists based on the newly added repositories.

    sudo apt-get update
    

Red Hat Enterprise Linux 7.4 (Unterstützung der Service Fabric-Vorschauversion)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

  1. Öffnen Sie ein Terminal.Open a terminal.

  2. Laden Sie Extra Packages for Enterprise Linux (EPEL) herunter, und installieren Sie es.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. Fügen Sie Ihrem System das EfficiOS-RHEL7-Paketrepository hinzu.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. Importieren Sie den EfficiOS-Paketsignaturschlüssel in den lokalen GPG-Schlüsselbund.Import the EfficiOS package signing key to the local GPG keyring.

    sudo rpmkeys --import https://packages.efficios.com/rhel/repo.key
    
  5. Fügen Sie Ihrem System das Microsoft-RHEL-Repository hinzu.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. Installieren Sie das .NET SDK.Install the .NET SDK.

    yum install rh-dotnet20 -y
    

Installieren und Einrichten des Service Fabric SDK für einen lokalen ClusterInstall and set up the Service Fabric SDK for a local cluster

Nach der Aktualisierung Ihrer Quellen können Sie das SDK installieren.After you update your sources, you can install the SDK. Installieren Sie das Service Fabric SDK-Paket, bestätigen Sie die Installation, und stimmen Sie dem Lizenzvertrag zu.Install the Service Fabric SDK package, confirm the installation, and accept the license agreement.

UbuntuUbuntu

sudo apt-get install servicefabricsdkcommon

Tipp

Mit den folgenden Befehlen wird das Akzeptieren der Lizenz für Service Fabric-Pakete automatisiert: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 (Unterstützung der Service Fabric-Vorschauversion)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

sudo yum install servicefabricsdkcommon

Die Service Fabric-Runtime aus der SDK-Installation enthält die Pakete in der folgenden Tabelle: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 Implizit von npmImplicit from npm latestlatest
RHELRHEL - OpenJDK 1.8OpenJDK 1.8 Implizit von npmImplicit from npm latestlatest

Einrichten eines lokalen ClustersSet up a local cluster

Starten Sie nach Abschluss der Installation einen lokalen Cluster.Start a local cluster after the installation finishes.

  1. Führen Sie das Clustersetupskript aus.Run the cluster setup script.

    sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
    
  2. Navigieren Sie in einem Webbrowser zu Service Fabric Explorer (http://localhost:19080/Explorer).Open a web browser and go to Service Fabric Explorer (http://localhost:19080/Explorer). Beim Starten des Clusters wird das Dashboard von Service Fabric Explorer angezeigt.When the cluster starts, you see the Service Fabric Explorer dashboard. Die Clustereinrichtung kann einige Minuten dauern.It might take several minutes for the cluster to be completely set up. Sollte sich die URL in Ihrem Browser nicht öffnen lassen oder das System in Service Fabric Explorer nicht als bereit angezeigt werden, versuchen Sie es nach einigen Minuten noch einmal.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 unter Linux

    Nun können Sie vorgefertigte Service Fabric-Anwendungspakete oder neue, auf Gastcontainern oder ausführbaren Gastdateien basierende Anwendungspakete bereitstellen.Now you can deploy prebuilt Service Fabric application packages or new ones based on guest containers or guest executables. Wenn Sie neue Dienste mit dem Java oder .NET Core SDK erstellen möchten, führen Sie die optionalen Einrichtungsschritte aus den nächsten Abschnitten aus.To build new services by using the Java or .NET Core SDKs, follow the optional setup steps that are provided in the next sections.

Hinweis

Eigenständige Cluster werden unter Linux nicht unterstützt.Standalone clusters aren't supported in Linux.

Tipp

Falls Sie über einen SSD-Datenträger verfügen, wird empfohlen, einen SSD-Ordnerpfad zu übergeben, indem Sie --clusterdataroot mit „devclustersetup.sh“ verwenden, um eine höhere Leistung zu erzielen.If you have an SSD disk available, we recommend to pass an SSD folder path by using --clusterdataroot with devclustersetup.sh for superior performance.

Einrichten der Service Fabric-BefehlszeilenschnittstelleSet up the Service Fabric CLI

Die Service Fabric CLI enthält Befehle für die Interaktion mit Service Fabric-Entitäten, etwa Clustern und Anwendungen.The Service Fabric CLI has commands for interacting with Service Fabric entities, including clusters and applications. Befolgen Sie die Anweisungen unter Service Fabric-Befehlszeilenschnittstelle, um die CLI zu installieren.To install the CLI, follow the instructions at Service Fabric CLI.

Einrichten von Yeoman-Generatoren für Container und ausführbare GastdateienSet up Yeoman generators for containers and guest executables

Die Gerüstbautools von Service Fabric unterstützen Sie beim Erstellen von Service Fabric-Anwendungen über das Terminal mithilfe von Yeoman-Vorlagengeneratoren.Service Fabric provides scaffolding tools that help you create Service Fabric applications from a terminal by using Yeoman template generators. Führen Sie die folgenden Schritte aus, um die Service Fabric-Yeoman-Vorlagengeneratoren einzurichten:Follow these steps to set up the Service Fabric Yeoman template generators:

  1. Installieren Sie Node.js und npm auf dem Computer.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. Installieren Sie den Yeoman-Vorlagengenerator über npm auf dem Computer:Install the Yeoman template generator from npm on your machine.

    sudo npm install -g yo
    
  3. Installieren Sie den Service Fabric-Yeo-Containergenerator und den Generator für die ausführbare Gastdatei über 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
    

Erstellen Sie nach der Installation der Generatoren ausführbare Gastdateien oder Containerdienste, indem Sie yo azuresfguest bzw. yo azuresfcontainer ausführen.After you install the generators, create guest executable or container services by running yo azuresfguest or yo azuresfcontainer, respectively.

Einrichten der .NET Core 2.0-EntwicklungSet up .NET Core 2.0 development

Installieren Sie das .NET Core 2.0 SDK für Ubuntu, um mit dem Erstellen von Service Fabric-C#-Anwendungen zu beginnen.Install the .NET Core 2.0 SDK for Ubuntu to start creating C# Service Fabric applications. Pakete für Service Fabric-Anwendungen mit .NET Core 2.0 werden auf NuGet.org gehostet (derzeit in der Vorschauphase).NuGet.org hosts packages for .NET Core 2.0 Service Fabric applications, currently in preview.

Einrichten der Java-EntwicklungSet up Java development

Installieren Sie Gradle zum Ausführen von Buildaufgaben, um Service Fabric-Dienste mit Java zu erstellen.To build Service Fabric services using Java, install Gradle to run build tasks. Führen Sie den folgenden Befehl aus, um Gradle zu installieren.Run the below command to install Gradle. Die Service Fabric-Java-Bibliotheken werden aus Maven abgerufen.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 (Unterstützung der Service Fabric-Vorschauversion)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
    

Sie müssen auch den Service Fabric-Yeo-Generator für ausführbare Java-Dateien installieren.You also need to install the Service Fabric Yeo generator for Java executables. Stellen Sie sicher, dass Yeoman installiert ist, und führen Sie dann den folgenden Befehl aus:Make sure you have Yeoman installed, and then run the following command:

npm install -g generator-azuresfjava

Installieren des Eclipse-Plug-Ins (optional)Install the Eclipse plug-in (optional)

Das Eclipse-Plug-In für Service Fabric können Sie über die Eclipse-IDE für Java-Entwickler oder für Java EE-Entwickler installieren.You can install the Eclipse plug-in for Service Fabric from within the Eclipse IDE for Java Developers or Java EE Developers. Sie können Eclipse verwenden, um zusätzlich zu Service Fabric-Java-Anwendungen Anwendungen mit ausführbarer Gastanwendungsdatei und Containeranwendungen für Service Fabric zu erstellen.You can use Eclipse to create Service Fabric guest executable applications and container applications in addition to Service Fabric Java applications.

Wichtig

Für das Service Fabric-Plug-In ist Eclipse Neon oder eine höhere Version erforderlich.The Service Fabric plug-in requires Eclipse Neon or a later version. Wie Sie Ihre Version von Eclipse überprüfen, erfahren Sie in der Anleitung im Anschluss an diesen Hinweis.See the instructions that follow this note for how to check your version of Eclipse. Falls Sie eine ältere Version von Eclipse installiert haben, können Sie neuere Versionen von der Eclipse-Website herunterladen.If you have an earlier version of Eclipse installed, you can download more recent versions from the Eclipse site. Es wird davon abgeraten, eine bereits vorhandene Installation von Eclipse durch eine neue Installation zu überschreiben.We recommend that you do not install on top of (overwrite) an existing installation of Eclipse. Entfernen Sie entweder die ältere Version, bevor Sie das Installationsprogramm ausführen, oder installieren Sie die neuere Version in einem anderen Verzeichnis.Either remove it before running the installer, or install the newer version in a different directory.

Unter Ubuntu sollten Sie die Installation direkt über die Eclipse-Website ausführen, anstatt ein Paketinstallationsprogramm (apt oder apt-get) zu verwenden.On Ubuntu, we recommend installing directly from the Eclipse site rather than using a package installer (apt or apt-get). Dadurch wird sichergestellt, dass Sie die neueste Version von Eclipse erhalten.Doing so ensures that you get the most current version of Eclipse. Die Eclipse-IDE kann für Java-Entwickler oder für Java EE-Entwickler installiert werden.You can install the Eclipse IDE for Java Developers or for Java EE Developers.

  1. Vergewissern Sie sich in Eclipse, dass bei Ihnen mindestens Eclipse Neon und mindestens die Buildship-Version 2.2.1 installiert sind.In Eclipse, make sure that you have installed Eclipse Neon or later and Buildship version 2.2.1 or later. Ermitteln Sie die Version der installierten Komponenten unter Hilfe > Über Eclipse > Installationsdetails.Check the versions of installed components by selecting Help > About Eclipse > Installation Details. Anweisungen zum Aktualisieren von Buildship finden Sie unter Eclipse Buildship: Eclipse-Plug-Ins für Gradle.You can update Buildship by using the instructions at Eclipse Buildship: Eclipse Plug-ins for Gradle.

  2. Wählen Sie zum Installieren des Service Fabric-Plug-Ins Hilfe > Neue Software installieren... aus.To install the Service Fabric plug-in, select Help > Install New Software.

  3. Geben Sie im Feld Work with (Arbeiten mit) Folgendes ein: https://dl.microsoft.com/eclipse .In the Work with box, enter https://dl.microsoft.com/eclipse.

  4. Wählen Sie Hinzufügen.Select Add.

    Seite „Verfügbare Software“

  5. Wählen Sie das Plug-In ServiceFabric aus, und klicken Sie auf Weiter.Select the ServiceFabric plug-in, and then select Next.

  6. Führen Sie die Installationsschritte aus.Perform the installation steps. Akzeptieren Sie anschließend den Endbenutzer-Lizenzvertrag.Then accept the end-user license agreement.

Falls Sie das Service Fabric-Plug-In für Eclipse bereits installiert haben, vergewissern Sie sich, dass Sie über die aktuelle Version verfügen.If you already have the Service Fabric Eclipse plug-in installed, make sure that you have the latest version. Die Version können Sie unter Hilfe > Über Eclipse > Installationsdetails überprüfen.Check by selecting Help > About Eclipse > Installation Details. Suchen Sie in der Liste der installierten Plug-Ins nach „Service Fabric“. Klicken Sie auf Aktualisieren, falls eine neuere Version verfügbar ist.Then search for Service Fabric in the list of installed plug-ins. Select Update if a newer version is available.

Weitere Informationen finden Sie unter Service Fabric-Plug-In für die Entwicklung von Eclipse-Java-Anwendungen.For more information, see Service Fabric plug-in for Eclipse Java application development.

Aktualisieren des SDKs und der LaufzeitUpdate the SDK and runtime

Führen Sie die folgenden Befehle aus, um das Update auf die aktuelle Version des SDK und der Runtime durchzuführen: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

Für die Aktualisierung der Java SDK-Binärdateien aus Maven müssen Sie die Versionsdetails der entsprechenden Binärdatei in der Datei build.gradle so aktualisieren, dass sie auf die aktuelle Version verweisen.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. Informationen dazu, wo genau die Version aktualisiert werden muss, finden Sie in jeder build.gradle-Datei in den Beispielen für die ersten Schritte mit 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.

Hinweis

Die Aktualisierung der Pakete kann die Beendigung Ihres lokalen Entwicklungsclusters zur Folge haben.Updating the packages might cause your local development cluster to stop running. Starten Sie den lokalen Cluster nach einem Upgrade anhand der Anweisungen in diesem Artikel neu.Restart your local cluster after an upgrade by following the instructions in this article.

Entfernen des SDKRemove the SDK

Führen Sie die folgenden Befehle aus, um die Service Fabric SDKs zu entfernen: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 (Unterstützung der Service Fabric-Vorschauversion)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
    

Nächste SchritteNext steps