Linux で開発環境を準備するPrepare your development environment on Linux

Linux の開発コンピューターに Azure Service Fabric アプリケーション をデプロイして実行するには、ランタイムと共通 SDK をインストールする必要があります。To deploy and run Azure Service Fabric applications on your Linux development machine, install the runtime and common SDK. また、必要に応じて Java および .NET Core デプロイ用 SDK をインストールすることもできます。You can also install optional SDKs for Java and .NET Core development.

この記事の手順では、Linux にネイティブにインストールするか、Service Fabric OneBox コンテナー イメージ (つまり、 を使用することを想定しています。The steps in this article assume that you install natively on Linux or use the Service Fabric OneBox container image, i.e.

Azure Service Fabric コマンド ライン インターフェイス (CLI) を使用して、クラウドやオンプレミスでホストされている Service Fabric のエンティティを管理することができます。You can manage Service Fabric entities hosted in the cloud or on-premises with the Azure Service Fabric command-line interface (CLI). CLI をインストールする方法については、Service Fabric CLI のセットアップに関するページを参照してください。For information on how to install the CLI, see Set up the Service Fabric CLI.


開発用に、次のオペレーティング システムのバージョンがサポートされています。These operating system versions are supported for development.

  • Ubuntu 16.04 (Xenial Xerus)、18.04 (Bionic Beaver)Ubuntu 16.04 (Xenial Xerus), 18.04 (Bionic Beaver)

    apt-transport-https パッケージがインストールされていることを確認してください。Make sure that the apt-transport-https package is installed.

    sudo apt-get install apt-transport-https
  • Red Hat Enterprise Linux 7.4 (Service Fabric プレビュー サポート)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

インストール方法Installation methods

APT ソースを更新するUpdate your APT sources

コマンド ライン ツール apt-get を実行して SDK および関連付けられたランタイム パッケージをインストールするために、まず 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.

インストール スクリプトScript installation

sfctl CLI と併せて Service Fabric ランタイムと Service Fabric 共通 SDK をインストールする場合に便利であるように、スクリプトが用意されています。For convenience, a script is provided to install the Service Fabric runtime and the Service Fabric common SDK along with the sfctl CLI. スクリプトの実行では、インストールされているすべてのソフトウェアのライセンスに同意することを前提としています。Running the script assumes you agree to the licenses for all the software that is being installed. または、次のセクションで手動インストール手順を行うこともできます。ここでは、関連付けられたライセンスと、インストールされているコンポーネントが示されます。Alternatively you may run the Manual installation steps in the next section which will present associated licenses as well as the components being installed.

スクリプトが正常に実行されたら、ローカル クラスターのセットアップに進みます。After the script runs successfully, you can skip to Set up a local cluster.

sudo curl -s | sudo bash

手動のインストールManual installation

Service Fabric ランタイムと共通 SDK の手動インストールの場合、このガイドの残りの説明に従います。For manual installation of the Service Fabric runtime and common SDK, follow the rest of this guide.

  1. ターミナルを開きます。Open a terminal.

  2. 配布に対応するソース リストに dotnet リポジトリを追加します。Add the dotnet repo to your sources list corresponding to your distribution.

    wget -q$(lsb_release -rs)/packages-microsoft-prod.deb
    sudo dpkg -i packages-microsoft-prod.deb
  3. 新しい MS Open Tech Gnu Privacy Guard (GnuPG または GPG) キーを APT キーリングに追加します。Add the new MS Open Tech Gnu Privacy Guard (GnuPG or GPG) key to your APT keyring.

    sudo curl -fsSL | sudo apt-key add -
  4. 公式の Docker GPG キーを APT キーリングに追加します。Add the official Docker GPG key to your APT keyring.

    sudo curl -fsSL | sudo apt-key add -
  5. Docker レポジトリを設定します。Set up the Docker repository.

    sudo add-apt-repository "deb [arch=amd64] $(lsb_release -cs) stable"
  6. Azul JDK キーを APT キーリングに追加し、そのリポジトリを設定します。Add Azul JDK Key to your APT keyring and setup its repository.

    sudo apt-key adv --keyserver hkp:// --recv-keys 0xB1998361219BD9C9
    sudo apt-add-repository "deb stable main"
  7. 新しく追加されたリポジトリに基づいてパッケージ リストを更新します。Refresh your package lists based on the newly added repositories.

    sudo apt-get update

ローカル クラスター用の Service Fabric SDK をインストールしてセットアップするInstall and set up the Service Fabric SDK for a local cluster

ソースを更新したら、SDK をインストールできます。After you update your sources, you can install the SDK. Service Fabric SDK パッケージをインストールし、インストールを確認して、ライセンス契約に同意します。Install the Service Fabric SDK package, confirm the installation, and accept the license agreement.


sudo apt-get install servicefabricsdkcommon


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

含まれているパッケージIncluded packages

SDK インストールに付属する Service Fabric ランタイムには、次の表のパッケージが含まれています。The Service Fabric runtime that comes with the SDK installation includes the packages in the following table.

DotNetCoreDotNetCore JavaJava PythonPython NodeJSNodeJS
UbuntuUbuntu AzulJDK 1.8AzulJDK 1.8 npm から暗黙的にImplicit from npm latestlatest
RHELRHEL - OpenJDK 1.8OpenJDK 1.8 npm から暗黙的にImplicit from npm latestlatest

ローカル クラスターをセットアップするSet up a local cluster

  1. ローカルの開発用 Service Fabric クラスターを起動します。Start a local Service Fabric cluster for development.

コンテナーベースの Onebox Service Fabric クラスターを起動します。Start a container-based Service Fabric Onebox cluster.

  1. Moby をインストールして、Docker コンテナーをデプロイできるようにします。Install Moby to be able to deploy Docker containers.

    sudo apt-get install moby-engine moby-cli -y
  2. 次の設定を使用してホスト上の Docker デーモン構成を更新し、Docker デーモンを再起動します。Update the Docker daemon configuration on your host with the following settings and restart the Docker daemon. 詳細:「Enable IPv6 support」 (IPv6 サポートを有効にする)Details: Enable IPv6 support

        "ipv6": true,
        "fixed-cidr-v6": "fd00::/64"
  3. クラスターを起動します。Start the cluster.
    Ubuntu 18.04 LTS: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

    Ubuntu 16.04 LTS:Ubuntu 16.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


    既定では、最新バージョンの Service Fabric を含んだイメージがプルされます。By default, this will pull the image with the latest version of Service Fabric. 特定のリビジョンについては、Docker Hub のページをご覧ください。For particular revisions, please visit the Docker Hub page.

  1. Web ブラウザーを開いて、 Service Fabric Explorer (http://localhost:19080/Explorer) に移動します。Open a web browser and go to Service Fabric Explorer (http://localhost:19080/Explorer). クラスターが起動すると、Service Fabric Explorer ダッシュボードが表示されます。When the cluster starts, you see the Service Fabric Explorer dashboard. クラスターが完全にセットアップされるまでに数分かかる場合があります。It might take several minutes for the cluster to be completely set up. ブラウザーで URL を開けない場合、またはシステムの準備が完了していることを Service Fabric Explorer で確認できない場合は、数分待ってからもう一度実行してください。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 on Linux

    これで、構築済みの Service Fabric アプリケーション パッケージか、またはゲスト コンテナーやゲスト実行可能ファイルをベースに新規作成したパッケージをデプロイできるようになりました。Now you can deploy prebuilt Service Fabric application packages or new ones based on guest containers or guest executables. Java 用 SDK または .NET Core 用 SDK を使用して新しいサービスを構築するには、次のセクションに示すセットアップ手順を実行します。To build new services by using the Java or .NET Core SDKs, follow the optional setup steps that are provided in the next sections.


スタンドアロン クラスターは Linux ではサポートされません。Standalone clusters aren't supported in Linux.


SSD ディスクが利用できる場合、優れたパフォーマンスを得るために、 で --clusterdataroot を使用して SSD フォルダー パスを渡すことをお勧めします。If you have an SSD disk available, we recommend to pass an SSD folder path by using --clusterdataroot with for superior performance.

Service Fabric CLI のセットアップSet up the Service Fabric CLI

Service Fabric CLI には、クラスターやアプリケーションなどの Service Fabric エンティティを操作するコマンドが含まれています。The Service Fabric CLI has commands for interacting with Service Fabric entities, including clusters and applications. CLI をインストールするには、Service Fabric CLI に関するページの手順に従ってください。To install the CLI, follow the instructions at Service Fabric CLI.

コンテナーとゲスト実行可能ファイルを作成するための Yeoman ジェネレーターをセットアップするSet up Yeoman generators for containers and guest executables

Service Fabric には、ターミナルから Yeoman テンプレート ジェネレーターを使って Service Fabric アプリケーションを作成できるスキャフォールディング ツールが用意されています。Service Fabric provides scaffolding tools that help you create Service Fabric applications from a terminal by using Yeoman template generators. 次の手順に従って、Service Fabric Yeoman テンプレート ジェネレーターを設定します。Follow these steps to set up the Service Fabric Yeoman template generators:

  1. マシンに Node.js と npm をインストールします。Install Node.js and npm on your machine.

    sudo add-apt-repository "deb $(lsb_release -s -c) main"
    sudo apt-get update
    sudo apt-get install nodejs
  2. npm からマシンに Yeoman テンプレート ジェネレーターをインストールします。Install the Yeoman template generator from npm on your machine.

    sudo npm install -g yo
  3. npm から Service Fabric Yeo のコンテナー ジェネレーターとゲスト実行可能ジェネレーターをインストールします。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

ジェネレーターのインストール後、yo azuresfguest または yo azuresfcontainer を実行して、ゲスト実行可能ファイルまたはコンテナー サービスを作成します。After you install the generators, create guest executable or container services by running yo azuresfguest or yo azuresfcontainer, respectively.

.NET Core 3.1 開発環境を設定するSet up .NET Core 3.1 development

.NET Core 3.1 SDK for Ubuntu をインストールして、C# Service Fabric アプリケーションの作成を開始します。Install the .NET Core 3.1 SDK for Ubuntu to start creating C# Service Fabric applications. .NET Core Service Fabric アプリケーション用のパッケージは、 でホストされています。Packages for .NET Core Service Fabric applications are hosted on

Java 開発をセットアップするSet up Java development

Java を使用して Service Fabric サービスをビルドするには、Gradle をインストールしてビルド タスクを実行します。To build Service Fabric services using Java, install Gradle to run build tasks. 次のコマンドを実行して、Gradle をインストールします。Run the below command to install Gradle. Service Fabric Java ライブラリが Maven から取り込まれます。The Service Fabric Java libraries are pulled from Maven.

  • UbuntuUbuntu

    curl -s | bash
    sdk install gradle 5.1
  • Red Hat Enterprise Linux 7.4 (Service Fabric プレビュー サポート)Red Hat Enterprise Linux 7.4 (Service Fabric preview support)

    sudo yum install java-1.8.0-openjdk-devel
    curl -s | bash
    sdk install gradle

さらに、Java 実行可能ファイル用の Service Fabric Yeo ジェネレーターをインストールする必要があります。You also need to install the Service Fabric Yeo generator for Java executables. Yeoman がインストールされている ことを確認してから、次のコマンドを実行します。Make sure you have Yeoman installed, and then run the following command:

npm install -g generator-azuresfjava

Eclipse プラグインをインストールする (省略可能)Install the Eclipse plug-in (optional)

Eclipse IDE for Java Developers または Eclipse IDE for Java EE Developers 内から Service Fabric 用 Eclipse プラグインをインストールできます。You can install the Eclipse plug-in for Service Fabric from within the Eclipse IDE for Java Developers or Java EE Developers. Eclipse を使用すると、Service Fabric Java アプリケーションのほかに、Service Fabric ゲスト実行可能アプリケーションと Service Fabric コンテナー アプリケーションを作成できます。You can use Eclipse to create Service Fabric guest executable applications and container applications in addition to Service Fabric Java applications.


Service Fabric プラグインには、Eclipse Neon またはそれ以降のバージョンが必要です。The Service Fabric plug-in requires Eclipse Neon or a later version. Eclipse のバージョンを確認する方法については、この注の後の手順を参照してください。See the instructions that follow this note for how to check your version of Eclipse. 以前のバージョンの Eclipse がインストールされている場合は、より新しいバージョンを Eclipse サイトからダウンロードすることができます。If you have an earlier version of Eclipse installed, you can download more recent versions from the Eclipse site. Eclipse の既存のインストールの上にインストールする (上書きする) ことはお勧めしません。We recommend that you do not install on top of (overwrite) an existing installation of Eclipse. インストーラーを実行する前に削除するか、新しいバージョンを別のディレクトリにインストールします。Either remove it before running the installer, or install the newer version in a different directory.

Ubuntu では、パッケージ インストーラー (apt または apt-get) を使用するのではなく、Eclipse サイトから直接インストールすることをお勧めします。On Ubuntu, we recommend installing directly from the Eclipse site rather than using a package installer (apt or apt-get). そうすることで、Eclipse の最新バージョンを確実に入手することができます。Doing so ensures that you get the most current version of Eclipse. Eclipse IDE for Java Developers または Eclipse IDE for Java EE Developers をインストールできます。You can install the Eclipse IDE for Java Developers or for Java EE Developers.

  1. Eclipse で、Eclipse Neon 以降および Buildship バージョン 2.2.1 以降がインストールされていることを確認します。In Eclipse, make sure that you have installed Eclipse Neon or later and Buildship version 2.2.1 or later. [ヘルプ] > [Eclipse について] > [インストール詳細] の順に選択して、インストールされたコンポーネントのバージョンを確認します。Check the versions of installed components by selecting Help > About Eclipse > Installation Details. Buildship は、Eclipse Buildship:Gradle 用の Eclipse プラグインに関するページの手順に従って更新できます。You can update Buildship by using the instructions at Eclipse Buildship: Eclipse Plug-ins for Gradle.

  2. [Help](ヘルプ) > [Install New Software](新しいソフトウェアのインストール) の順に選択して、Service Fabric プラグインをインストールします。To install the Service Fabric plug-in, select Help > Install New Software.

  3. [Work with](作業対象) ボックスに、「 」と入力します。In the Work with box, enter

  4. [追加] を選択します。Select Add.

    [利用可能なソフトウェア] ページ

  5. [ServiceFabric] プラグインを選択し、 [次へ] を選択します。Select the ServiceFabric plug-in, and then select Next.

  6. インストール手順を実行します。Perform the installation steps. 次に、使用許諾契約に同意します。Then accept the end-user license agreement.

Service Fabric Eclipse プラグインを既にインストールしてある場合は、最新バージョンを使用していることを確認してください。If you already have the Service Fabric Eclipse plug-in installed, make sure that you have the latest version. 確認するには、 [ヘルプ] > [Eclipse について] > [インストール詳細] の順に選択します。Check by selecting Help > About Eclipse > Installation Details. 次に、インストールされているプラグインの一覧で Service Fabric を探します。新しいバージョンが使用できる場合は [更新] を選択します。Then search for Service Fabric in the list of installed plug-ins. Select Update if a newer version is available.

詳細については、「Eclipse Java アプリケーション開発用の Service Fabric プラグイン」を参照してください。For more information, see Service Fabric plug-in for Eclipse Java application development.

SDK とランタイムを更新するUpdate the SDK and runtime

SDK とランタイムを最新バージョンに更新するには、次のコマンドを実行します。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

Maven からの Java SDK バイナリを更新するには、build.gradle ファイルで、最新バージョンが参照されるように、対応するバイナリのバージョン情報を更新する必要があります。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. 具体的なバージョンの更新箇所については、Service Fabric 入門用サンプルにある任意の build.gradle ファイルを参照してください。To know exactly where you need to update the version, refer to any build.gradle file in the Service Fabric getting-started samples.


上記のパッケージを更新すると、ローカルの開発クラスターが停止する可能性があります。Updating the packages might cause your local development cluster to stop running. この記事の手順に従って、アップグレード後にローカル クラスターを再起動してください。Restart your local cluster after an upgrade by following the instructions in this article.

SDK を削除するRemove the SDK

Service Fabric SDK を削除するには、次のコマンドを実行します。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 (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

次のステップNext steps