.NET Aspire 多言語

この記事では、.NET 以外の言語やフレームワークを使用する場合でも、.NET Aspire などのツールを活用して分散アプリケーションの構築と展開の方法を改善する方法を検討したいと思います。

.NET Aspireとは

.NET Aspire は、監視可能で本番環境に対応した分散アプリケーションの構築エクスペリエンスを向上させるために設計された、独自の クラウド対応スタック です。これは、特定のクラウドネイティブの問題を処理する NuGet パッケージのコレクションを通じて提供されます。

.NET Aspire は次のことを支援するように設計されています。

• オーケストレーション: .NET Aspire は、マルチプロジェクト アプリケーションとその依存関係をローカル開発環境で実行および接続するための機能を提供します。
• 統合: .NET Aspire 統合は、Redis や Postgres などの一般的に使用されるサービスの NuGet パッケージであり、標準化されたインターフェイスにより、アプリとの一貫性とシームレスな接続が保証されます。
• ツール: .NET Aspire には、.NET Aspire プロジェクトの作成と操作に役立つ、Visual Studio、Visual Studio Code、および dotnet CLI のプロジェクト テンプレートとツール エクスペリエンスが付属しています。

.NET Aspire のコアは、.NET テンプレートから Aspire の作業を開始するときに作成される AppHost プロジェクトにあります。 AppHost プロジェクトは、バックエンドやフロントなどのサービスからデータベースやキャッシュなどのリソースに至るまで、分散アプリケーションのコンポーネントを定義します。
このプロジェクトでは、インフラストラクチャの観点からアプリケーションを説明するマニフェストを生成できます。したがって、これは Azure Developer CLI によって解釈され、Infrastructure as Code を記述する必要なく、アプリケーションを Azure にデプロイできます。

さまざまな言語を使用して作業する

もちろん、分散アプリケーションやマイクロサービスを扱う場合、異なるチームが異なる言語でコードを書きたがるというシナリオが発生する可能性があります。そしてもちろん、.NET Aspire は .NET エコシステムに属します。それにもかかわらず、異なる言語やフレームワークと統合できるように設計されています。

分散計算機

簡単な例を考えてみましょう。さまざまなサービス、つまり各操作のフロントエンド サービスとバックエンドで構成される分散計算機があります。

• 前に出た: 反応する
• 減算: dotnet
• 追加: 行きます
• 乗算: Python
• ディビジョン:nodejs

計算機の状態を保存するための Redis キャッシュもあります。

このシナリオでは、.NET Aspire を使用して分散計算機を構築し、それに付属するすべてのツールと統合を活用できます。 Aspire は特定の言語のネイティブ サポートを提供していますが、コンテナを使用して他の言語をサポートするように拡張することもできます。

この記事の執筆時点では、.NET Aspire は次の言語をサポートしています。

• 複数の JS フレームワーク (React、Angular、Vue、NodeJS)
• パイソン

AppHost プロジェクトですべてのバックエンド サービスを構成する方法は次のとおりです。

ゴラン

Golang はネイティブにサポートされていないため、コンテナとして追加します。マニフェストの公開またはローカル開発のために AppHost を実行するシナリオでは、異なるイメージを使用するかどうかを決定できることに注意してください。

// Configure Adder in Go
var add = (builder.ExecutionContext.IsPublishMode
    ? builder.AddContainer("addapp", "acrt6xtihl2b3uxe.azurecr.io/addapp")
    : builder.AddContainer("addapp", "addapp"))
        .WithHttpEndpoint(targetPort: 6000, env: "APP_PORT", name: "http")
        .WithOtlpExporter()
        .WithEnvironment("OTEL_SERVICE_NAME", "addapp")
        .PublishAsContainer();
var addEnpoint = add.GetEndpoint("http");

パイソン

Python はネイティブでサポートされているため、AddPythonProject メソッドを使用して乗算器サービスを構成できます。このチュートリアルに従って、Python プロジェクトを正しく構成してください。

// Configure Multiplier in Python
var multiply = builder.AddPythonProject("multiplyapp", "../../python-multiplier", "app.py")
    .WithHttpEndpoint(targetPort: 5001, env: "APP_PORT", name: "http")
    .WithEnvironment("OTEL_SERVICE_NAME", "multiplyapp")
    .PublishAsDockerFile();

NodeJS

NodeJS はネイティブでサポートされているため、AddNodeApp メソッドを使用してディバイダー サービスを構成できます。

// Configure Divider in NodeJS
var divide = builder.AddNodeApp(name: "divideapp", scriptPath: "app.js", workingDirectory: "../../node-divider")
    .WithHttpEndpoint(targetPort: 4000, env: "APP_PORT", name: "http")
    .WithEnvironment("OTEL_SERVICE_NAME", "divideapp")
    .PublishAsDockerFile();

。ネット

ここでは驚くことではありません。.NET Aspire は .NET をネイティブにサポートしているため、AddProject メソッドを使用して減算器サービスを構成できます。

// Configure Subtractor in .NET
var subtract = builder.AddProject<Projects.dotnet_subtractor>("subtractapp")
    .WithReference(insights)
    .WithEnvironment("OTEL_SERVICE_NAME", "subtractapp");

レディス

Redis キャッシュは、AddRedis メソッドを使用して簡単に構成できます。このシナリオでは、AddDaprStateStore メソッド経由で Dapr を使用します。

// Configure Dapr State Store
var stateStore = builder.AddDaprStateStore("statestore");

Dapr はこの記事の焦点では​​ありませんが、.NET Aspire を Dapr と組み合わせて使用​​して分散アプリケーションを構築できることは言及する価値があります。 Dapr の詳細については、公式ドキュメントを参照してください。

反応する

最後に、AddNpmApp メソッドを使用してフロントエンド サービスを構成できます。

// Configure Frontend in React
builder.AddNpmApp(name: "calculator-front-end", workingDirectory: "../../react-calculator")
    .WithDaprSidecar(new DaprSidecarOptions
    {
        AppPort = 3000,
        AppProtocol = "http",
        DaprHttpPort = 3500
    })
    .WithEnvironment("DAPR_HTTP_PORT", "3500")
    .WithReference(addEnpoint)
    .WithReference(multiply)
    .WithReference(divide)
    .WithReference(subtract)
    .WithReference(stateStore)
    .WithReference(insights)
    .WithHttpEndpoint(targetPort: 3000, env: "PORT")
    .WithExternalHttpEndpoints()
    .WithEnvironment("OTEL_SERVICE_NAME", "calculator-front-end")
    .PublishAsDockerFile();

以前に構成されたすべてのサービスを参照しているため、それらをフロントエンド サービスに簡単に接続できます。フロントエンドから加算器を呼び出す必要がある場合は、Aspire によって挿入された環境変数を使用することで簡単に呼び出すことができます:

app.post('/calculate/add', async (req, res) => {
  try {
      const serviceUrl = process.env.services__addapp__http__0;

      const appResponse = await axios.post(`${serviceUrl}/add`, req.body);

      // Return expected string result to client
      return res.send(`${appResponse.data}`); 
  } catch (err) {
      console.log(err);
  }
});

Further considerations

The entire application can be deployed to Azure using the Azure Developer CLI. The CLI will read the manifest generated by the AppHost project and deploy the application to Azure, creating all the necessary resources. To learn how to integrate Aspire with the Azure Developer CLI, please reference the official tutorial.

All the code for the distributed calculator can be found in the Aspire Multilanguage repository.

以上が.NET Aspire 多言語の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。