Visual Studio Code 用の Service Fabric

[アーティクル]
06/01/2023

VS Code 用の Service Fabric Reliable Services 拡張機能には、Windows、Linux、および macOS オペレーティングシステム上で Service Fabric アプリケーションを作成、ビルド、およびデバッグするために必要なツールが用意されています。

この記事では、拡張機能の要件と設定の概要と、拡張機能で提供されているさまざまなコマンドの使用方法について説明します。

重要

Service Fabric Java アプリケーションは Windows マシン上で開発できますが、デプロイは Azure Linux クラスターに対してのみ実行できます。 Java アプリケーションのデバッグは Windows 上ではサポートされていません。

前提条件

すべての環境に以下の前提条件をインストールする必要があります。

Visual Studio Code
Node.js
Git
Service Fabric SDK

Yeoman Generators -- アプリケーションに適したジェネレーターをインストールしてください

npm install -g yo
npm install -g generator-azuresfjava
npm install -g generator-azuresfcsharp
npm install -g generator-azuresfcontainer
npm install -g generator-azuresfguest

Java 開発の場合は、以下の前提条件をインストールする必要があります。

Java SDK (バージョン 1.8)
Gradle
Debugger for Java VS Code 拡張機能 Java サービスのデバッグに必要です。 Java のデバッグサービスは Linux 上でのみサポートされています。 VS Code のアクティビティバーにある [拡張機能] アイコンをクリックし、拡張機能を検索してインストールするか、VS Code Marketplace からインストールすることができます。

.NET Core/C# 開発の場合は、以下の前提条件をインストールする必要があります。

.NET Core (バージョン 2.0.0 以降)
C# for Visual Studio Code (OmniSharp 搭載) VS Code 拡張機能 C# サービスのデバッグに必要です。 VS Code のアクティビティバーにある [拡張機能] アイコンをクリックし、拡張機能を検索してインストールするか、VS Code Marketplace からインストールすることができます。

セットアップ

VS Code を開きます。
VS Code の左側にあるアクティビティバーで [デバッグ] アイコンをクリックします。「Service Fabric」を探します。 Service Fabric Reliable Services 拡張機能の [インストール] をクリックします。

コマンド

VS Code の Service Fabric Reliable Services 拡張機能には、開発者が Service Fabric プロジェクトを作成してデプロイするために役立つコマンドが多数用意されています。 コマンドパレットからコマンドを呼び出すには、(Ctrl + Shift + p) を押し、入力バーにコマンド名を入力し、プロンプトリストから目的のコマンドを選択します。

[Service Fabric: Create Application]\(Service Fabric: アプリケーションの作成\)
[Service Fabric: Publish Application](Service Fabric: アプリケーションの発行)
[Service Fabric: Deploy Application](Service Fabric: アプリケーションのデプロイ)
[Service Fabric: Remove Application](Service Fabric: アプリケーションの削除)
[Service Fabric: Build Application](Service Fabric: アプリケーションのビルド)
[Service Fabric: Clean Application](Service Fabric: アプリケーションの消去)

[Service Fabric: Create Application](Service Fabric: アプリケーションの作成)

[Service Fabric: Create Application](Service Fabric: アプリケーションの作成) コマンドで、現在のワークスペースに新しい Service Fabric アプリケーションを作成します。開発マシンにインストールされている Yeoman ジェネレーターに応じて、Java、C#、コンテナー、ゲストプロジェクトなど、複数種類の Service Fabric アプリケーションを作成できます。

[Service Fabric: アプリケーションの消去] コマンドを選択します。
新しい Service Fabric アプリケーションの種類を選択します。
作成するアプリケーションの名前を入力します。
Service Fabric アプリケーションに追加するサービスの種類を選択します。
メッセージに従って、サービスに名前を付けます。
新しい Service Fabric アプリケーションがワークスペースに表示されます。
新しいアプリケーションフォルダーを開いて、ワークスペースのルートフォルダーにします。ここからコマンドの実行を継続できます。

[Service Fabric: Add Service](Service Fabric: サービスの追加)

[Service Fabric: Add Service](Service Fabric: サービスの追加) コマンドで、新しいサービスを既存の Service Fabric アプリケーションに追加します。サービスを追加するアプリケーションは、ワークスペースのルートディレクトリである必要があります。

[Service Fabric: Add Application](Service Fabric: アプリケーションの追加) コマンドを選択します。
現在の Service Fabric アプリケーションの種類を選択します。
Service Fabric アプリケーションに追加するサービスの種類を選択します。
メッセージに従って、サービスに名前を付けます。
新しいサービスがプロジェクトディレクトリに表示されます。

[Service Fabric: Publish Application](Service Fabric: アプリケーションの発行)

[Service Fabric: Publish Application](Service Fabric: アプリケーションの発行) コマンドで、リモートクラスター上に Service Fabric アプリケーションをデプロイします。ターゲットクラスターには、セキュリティで保護されたクラスターまたは保護されていないクラスターを指定できます。 Cloud.json にパラメーターが設定されていない場合、アプリケーションはローカルクラスターにデプロイされます。

アプリケーションを初めてビルドすると、Cloud.json ファイルがプロジェクトディレクトリに生成されます。
接続するクラスターの値を Cloud.json ファイルに入力します。
[Service Fabric: Publish Application](Service Fabric: アプリケーションの発行) コマンドを選択します。
Service Fabric Explorer でターゲットクラスターを表示し、アプリケーションがインストールされていることを確認します。

[Service Fabric: Deploy Application (Localhost)](Service Fabric: アプリケーションのデプロイ (Localhost))

[Service Fabric: Deploy Application](Service Fabric: アプリケーションのデプロイ) コマンドで、リローカルクラスター上に Service Fabric アプリケーションをデプロイします。コマンドを使用する前に、ローカルクラスターが実行されていることを確認します。

[Service Fabric: Deploy Application](Service Fabric: アプリケーションのデプロイ) コマンドを選択します。
Service Fabric Explorer でローカルクラスターを表示し (http://localhost:19080/Explorer)、アプリケーションがインストールされていることを確認します。この処理には時間がかかる場合があります。
Cloud.json ファイルでパラメーターを指定せずに [Service Fabric: Publish Application](Service Fabric: アプリケーションの発行) コマンドを使用して、ローカルクラスターにデプロイすることもできます。

Note

ローカルクラスターへの Java アプリケーションのデプロイは、Windows マシンではサポートされていません。

[Service Fabric: Remove Application](Service Fabric: アプリケーションの削除)

[Service Fabric: Remove Application](Service Fabric: アプリケーションの削除) コマンドで、VS Code 拡張機能を使用して以前にデプロイされたクラスターから Service Fabric アプリケーションを削除します。

[Service Fabric: Remove Application](Service Fabric: アプリケーションの削除) コマンドを選択します。
Service Fabric Explorer でクラスターを表示し、アプリケーションが削除されたことを確認します。この処理には時間がかかる場合があります。

[Service Fabric: Build Application](Service Fabric: アプリケーションのビルド)

[Service Fabric: アプリケーションのビルド] コマンドで、Java または C# Service Fabric アプリケーションをビルドできます。

このコマンドを実行する前に、現在のフォルダーがアプリケーションルートフォルダーであることを確認します。このコマンドでアプリケーションの種類 (C# または Java) が特定され、それに応じてアプリケーションがビルドされます。
[Service Fabric: Build Application](Service Fabric: アプリケーションのビルド) コマンドを選択します。
ビルドプロセスの出力は統合ターミナルに書き込まれます。

[Service Fabric: Clean Application](Service Fabric: アプリケーションの消去)

[Service Fabric: Clean Application](Service Fabric: アプリケーションの消去) コマンドで、ビルドによって生成されたすべての jar ファイルおよびネイティブライブラリを削除します。 Java アプリケーションにのみ有効です。

このコマンドを実行する前に、現在のフォルダーがアプリケーションルートフォルダーであることを確認します。
[Service Fabric: Clean Application](Service Fabric: アプリケーションの消去) コマンドを選択します。
消去プロセスの出力は統合ターミナルに書き込まれます。

次のステップ

VS Code を使用して C# Service Fabric アプリケーションを開発し、デバッグする方法について学びます。
VS Code を使用して Java Service Fabric アプリケーションを開発し、デバッグする方法について学びます。

次の方法で共有