演習 - サンプル アプリを作成する

  • 2 分

Orleans を使用するには、まず適切に構成されたアプリケーションを作成する必要があります。 このモジュールでは、ASP.NET Core 7.0 Minimal API を使って、シンプルですが便利な URL 短縮 Web サービスを構築します。 URL 短縮サービスを使うと、ユーザーは長い URL をアプリに送信し、はるかに短い URL を受け取って、それを自分の顧客やネットワークと共有できます。 ユーザーが短縮された URL をブラウザーに入力すると、完全なアドレスの正しいサイトにリダイレクトされます。

このモジュールでは、コンピューターに .NET 7.0 がインストールされている必要があります。 次の .NET CLI コマンドを使って、インストールされている .NET のバージョンを確認できます。

dotnet --list-sdks

コンソールの出力は以下のテキストのようになります。7.x で始まるバージョンが含まれている必要があります。

7.0.0 [C:\Program Files\dotnet\sdk]

完成したプロジェクトを GitHub からクローンする

このモジュールに取り組むことで、URL 短縮アプリを初めから終わりまで構築できます。 または、GitHub から完成したサンプル プロジェクトをクローンして過程をたどっていくか、完成したコードに照らして作業内容を確認することもできます。

git clone https://github.com/Azure-Samples/build-your-first-orleans-app-aspnetcore

Visual Studio Code を使ってプロジェクトを作成する

アプリを初めから終わりまで構築したい場合は、次の手順に従って、新しい Minimal API プロジェクトを作成して実行します。

  1. .NET 7.0 で新しい Minimal API プロジェクトを作成するには、任意のターミナルで次のコマンドを実行します。

    dotnet new web -o UrlShortener -f net7.0

  2. 次のコマンドを使って、Visual Studio Code 内でフォルダーを開きます。

    cd UrlShortener
code .

  3. Visual Studio Code 内でプロジェクトを開いたら、dotnet run コマンドを使って、統合ターミナルからアプリをビルドして実行できます。

    dotnet run

    しばらくすると、アプリがブラウザーで起動し、Hello World! というメッセージが表示されるはずです。 このモジュールを完了するまでに、このアプリを拡張して URL 短縮機能を実装します。

プロジェクトに Orleans を追加する

Orleans は、NuGet パッケージのコレクションを通じて利用できます。 以下の手順に従って、作成したプロジェクトに Orleans を統合します。

  1. このモジュールでは、Visual Studio Code ターミナルで dotnet add package コマンドを実行して、以下の特定の Orleans パッケージをインストールする必要があります。 この演習では最新バージョンである 7.x が適しています。または、次のコマンドで指定されているバージョンを使用できます。

    dotnet add package Microsoft.Orleans.Server -v 7.0.0

  2. 以下の using ステートメントを、Program クラスの先頭に追加します。 これらの using ステートメントにより、今後の手順で必要なクラスを使用できるようになります。

    using Microsoft.AspNetCore.Http.Extensions;
using Orleans.Runtime;

この時点で、Orleans が含まれている基本的な Minimal API を作成できました。 次の手順では、グレインとサイロを使って Orleans アプリの基本的な構成要素を作成する方法について説明します。