eShop

ESHOPリファレンスアプリケーション - 「AdventureWorks」

.NET Aspireを使用したサービスベースのアーキテクチャを使用して、eコマースWebサイトを実装するリファレンス.NETアプリケーション。

はじめる

ESHOPのこのバージョンは.NET 9に基づいています。

以前のeShopバージョン：

• .NET 8

前提条件

• ESHOPリポジトリをクローン：https：//github.com/dotnet/eshop
• Dockerデスクトップをインストールして開始します

ビジュアルスタジオ付きの窓

• Visual Studio 2022バージョン17.10以降をインストールします。
  • 次のワークロードを選択します。
    • ASP.NET and web developmentワークロード。
    • .NET Aspire SDKコンポーネントはIndividual componentsにあります。
    • オプション： .NET Multi-platform App UI developmentクライアントアプリを実行する

または

• このアプリケーションを構築および実行するために必要なツールで環境を自動的に構成するためにAdministratorとして実行されているPowerShell＆ターミナルで次のコマンドを実行します。 （注：再起動が必要で、以下のスクリプトに含まれています。）

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvside.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

または

• Dev HomeからMachine Configuration -> Clone repositoriesに移動します。このリポジトリのURLを入力します。確認画面では、 Configuration File Detectedを探し、 Run Fileをクリックします。

Visual StudioのないMac、Linux、およびWindows

• 最新の.NET 9 SDKをインストールします

または

• このアプリケーションを構築および実行するために必要なツールで環境を自動的に構成するためにAdministratorとして実行されているPowerShell＆ターミナルで次のコマンドを実行します。 （注：下のスクリプトを実行した後、再起動が必要です。）

Visual Studioコードと関連する拡張機能をインストールします

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense  - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvscode.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

注：これらのコマンドにはsudo必要になる場合があります

• オプション：C＃DevキットにVisual Studioコードをインストールします
• オプション：.NET MAUIワークロードをインストールします

注：Appleシリコン（Mシリーズプロセッサ）を使用してMacで実行する場合、GRPC-Tools用のRosetta 2。

ソリューションを実行します

警告

Dockerが開始されることを確認することを忘れないでください

• （Windowsのみ）Visual Studioからアプリケーションを実行します。

• Visual StudioでeShop.Web.slnfファイルを開きます
• eShop.AppHost.csprojがスタートアッププロジェクトであることを確認してください
• Ctrl-F5を押してAspireを立ち上げます

• または、端末からアプリケーションを実行します。

dotnet run -- project src / eShop.AppHost / eShop.AppHost.csproj

次に、Aspireダッシュボードを開くためのURLを見つけるために、コンソール出力でこのような行を探します。

Login to the dashboard at: http://localhost:19888/login ? t=uniquelogincodeforyou

最初にASP.NETコアHTTPS開発証明書をインストールしてから、すべてのブラウザタブを閉じる必要がある場合があります。詳細については、https：//aka.ms/aspnet/https-trust-dev-certをご覧ください

Azure Open AI

azure openaiを使用する場合、 eshop.apphost/appsettings.json内で、次のセクションを追加します。

  "ConnectionStrings" : {
    "OpenAi" : " Endpoint=xxx;Key=xxx; "
  }

値を自分のものに置き換えます。次に、eShop.Apphost Program.csで、この値をtrueに設定します

 bool useOpenAI = false ;

.NET Aspire Openaiコンポーネントに関する追加のガイダンスを次に示します。

Azure開発者CLIを使用します

Azure Developer CLIを使用して、このプロジェクトをAzureでいくつかのコマンドで実行できます。次の指示に従ってください：

• 最新のAzure開発者CLI（AZD）に最新または更新をインストールします。
• azd （以前に行ったことがない場合）にazureアカウントにログインします。

azd auth login

• リポジトリのルートからazd初期化します。

azd init

• initの間：

  • Use code in the current directory 。 AZDは、.NET Aspireプロジェクトを自動的に検出します。
  • .NET (Aspire)確認し、続行します。
  • インターネットに公開するサービスを選択します（サンプルをテストするにはwebapp公開で十分です）。
  • 環境に名前を付けて初期化を完成させます。

• Azureリソースを作成し、実行してサンプルを展開します。

azd up

注：

• 環境で初めて実行されるのに、操作には数分かかります。
• プロセスの最後に、 azd WebAppのurlを表示します。そのリンクに従って、サンプルをテストします。
• サンプルの変更を保存してサンプルを再デプロイして更新した後、 azd up実行できます。
• Azure-Dev Repoに問題を報告します。
• AZDのFAQとトラブルシューティング。

貢献

このレポの貢献の詳細については、貢献文書と行動規範をお読みください。

サンプルデータ

サンプルカタログデータは、catalog.jsonで定義されています。これらの製品名、説明、およびブランド名は架空のものであり、GPT-35ターボを使用して生成され、対応する製品画像はDall・E 3を使用して生成されました。

AzureのEshop

Azureでの展開用に構成されたこのアプリのバージョンについては、Azure RepoのeShopをご覧ください。