Windows で開発環境を準備する

Windows 開発コンピューターで Azure Service Fabric アプリケーションをビルドして実行するには、Service Fabric ランタイム、SDK、およびツールをインストールしてください。 また、SDK に含まれる Windows PowerShell スクリプトの実行を有効にする必要があります。

前提条件

サポートされている Windows バージョンを使用していることを確認します。

ランタイムと SDK をダウンロードしてインストールする

Note

SDK/ツールのインストールに以前に使用された WebPI は、2022 年 7 月 1 日に非推奨になりました

ランタイムは個別にインストールできます。 ただし、SDK にはランタイムが必要であるため、開発環境の場合は、ランタイムと SDK の両方をインストールする必要があります。 次のリンクを使うと、ランタイムと SDK 両方の最新バージョンがダウンロードされます。

Package バージョン
Windows 用の Service Fabric ランタイムのインストール 10.1.1951.9590
Service Fabric SDK のインストール 7.1.1951

以前のリリースのインストーラへの直接リンクは、Service Fabric のリリースで確認できます。

サポートされているバージョンについては、Service Fabric のバージョンに関するページを参照してください。

ランタイムをインストールする

ランタイム インストーラーはコマンド ライン シェルから実行する必要があり、/accepteula フラグを使う必要があります。 ログ出力を保つため、昇格された特権でコマンド ライン シェルを実行することをお勧めします。 PowerShell の例を次に示します。

.\MicrosoftServiceFabric.<version>.exe /accepteula

SDK のインストール

ランタイムがインストールされたら、SDK を正常にインストールできます。 インストーラーは、コマンド ライン シェルまたはエクスプローラーから実行できます。

Note

アプリケーションまたはクラスターのアップグレードには、1 台のマシンのクラスター (OneBox) はサポートされていません。クラスターのアップグレードを実行する必要がある場合や、アプリケーションのアップグレードの実行で問題がある場合は、OneBox クラスターを削除し再作成します。

Visual Studio 2017 または 2019 を使用するには

Service Fabric ツールは、Visual Studio 2019 および 2017 の Azure 開発ワークロードに含まれています。 このワークロードを Visual Studio のインストールの一環として有効にします。 さらに、上の「ランタイムと SDK をダウンロードしてインストールする」の説明に従って、Microsoft Azure Service Fabric SDK とランタイムをインストールする必要があります。

PowerShell スクリプトの実行の有効化

Service Fabric は、ローカル開発クラスターの作成、および Visual Studio からのアプリケーションのデプロイに、Windows PowerShell スクリプトを使用します。 既定では、Windows はこれらのスクリプトの実行をブロックします。 これらを有効にするには、PowerShell 実行ポリシーを変更する必要があります。 管理者として PowerShell を開き、次のコマンドを入力します。

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope CurrentUser

Docker のインストール (省略可能)

Service Fabric は、マシン クラスター全体にマイクロサービスをデプロイするコンテナー オーケストレーターです。 ローカル開発クラスターで Windows コンテナー アプリケーションを実行するには、まず Docker for Windows をインストールする必要があります。 Docker CE for Windows (安定版) を入手します。 Docker をインストールして開始した後、トレイ アイコンを右クリックして、[Windows コンテナーに切り替える] を選びます。 この手順は、Windows に基づいて Docker イメージを実行するために必要です。

次のステップ

開発環境のセットアップが済んだので、アプリのビルドと実行を始めてください。