AWS Lambda での.NET ワークロード

Visual Studio で、[拡張機能] メニューに移動し、[拡張機能の管理] を選択します。右側の検索ボックスに「AWS Toolkit」と入力します。結果ウィンドウで、「Visual Studio 用 AWS ツールキット」拡張機能を選択し、「ダウンロード」をクリックします。プロンプトに従って拡張機能をインストールします。Visual Studio を再起動する必要がある場合があります。

Lambda サービスに関連して、このツールキットには、Lambda 関数用のプロジェクトテンプレートと、Lambda 関数のデプロイ、管理、テスト/呼び出しを支援するツールという 2 つの主要な機能セットが用意されています。これに加えて、ツールキットを使用すると、他の AWS リソースを管理したり、AWS Fargate、AWS App Runner、AWS Elastic Beanstalk などの他のタイプの AWS インフラストラクチャにアプリケーションをデプロイしたりできます (このコースでは取り上げません)。

ツールキットには、さまざまな Lambda 関数の作成に役立つ多くの Lambda プロジェクトテンプレートが追加されています。

最も単純なものは文字列を受け取り、その文字列の大文字バージョンを返します。シンプルで、デプロイしやすく、テストも簡単なため、これは始めるのに最適です。ほんの数分で、.NET Lambda 関数を AWS 上で実行し、リクエストを送信してレスポンスを取得できます。

より複雑な側面としては、(Web ページと API コントローラを含む) .NET 6 Web アプリケーション全体を提供するテンプレートがあります。これをデプロイすると、ウェブからアクセスできるようにするために必要なインフラストラクチャもデプロイされ、自動的に構成されます。

好みに応じて、コンテナプロジェクトテンプレートも利用できます。これらが機能するには、コンピューターに Docker がインストールされている必要があることに注意してください。Lambda 関数でコンテナーイメージを使用する理由については、モジュール 4 の「自分に合ったランタイムの選択」セクションを参照してください。

Lambda 関数のユニットテストは、他のコードのテストと同じくらい重要です。ほとんどのプロジェクトテンプレートには、xUnit を使用してソースコードプロジェクトのコードをテストするテストプロジェクトが含まれています。これにより、ユニットテストを簡単に開始できます。

上記から分かるように、Visual Studio から AWS Lambda サービスに関数をパブリッシュすることもできます。パブリッシュ機能では、パッケージの構築、Lambda サービスへのアップロード、権限の適用、API Gateway エンドポイントの作成、およびコードを実行して呼び出しできるようにするために必要なその他のステップがすべて実行されます。お客様はコードを書くだけです。

このツールキットのもう 1 つの機能は、AWS エクスプローラーです。これにより、DynamoDB、S3、SNS、SQS キュー、EC2、そしてもちろん Lambda 関数など、多くの AWS リソースを表示および管理できます。

AWS エクスプローラーを開くには、[表示] メニューから [AWS Explorer] を選択します。

Lambda 関数に関連して、AWS エクスプローラーでは次のことができます。

• リージョンを選択する
• Lambda 関数を表示および管理します。
• AWS で Lambda 関数を呼び出し、必要なパラメータを渡して、応答を表示します。このツールは、他のさまざまな AWS サービスからの呼び出しをシミュレートするためのサンプル入力を提供します。これは、S3 で作成されているファイルなど、他のサービスからのイベントによってトリガーされる Lambda 関数を構築する場合に非常に便利です。
• ローカルで実行されている Lambda 関数をデバッグします。
• Lambda 関数をトリガーできるサービスを設定します。
• Lambda 関数によって生成されたログを表示します。
  

ツールキットから Lambda 関数を呼び出すには、AWS Explorer を開き、Lambda セクションを展開し、実行する Lambda 関数を右クリックして [関数を表示] を選択します。

そこから、ドロップダウンリストからリクエスト例を選択できます。 これらのサンプルでは、API Gateway、S3、SNS などの他の AWS サービスからの呼び出しをシミュレートできます。これにより、他のサービスからのイベントによって呼び出される Lambda 関数を簡単かつ直接テストできます。

または、独自のリクエストを使用することもできます。

上記に加えて、Lambda 関連のコマンドラインツールはすべてターミナルから使用できます。

AWS を初めて使用する場合は、Visual Studio のツールキットを使用するのが最善の方法です。入手可能なすべてのツールキットの中で最も多くの機能を備えており、デバッグやデプロイメントを実行するのが最も簡単です。Visual Studio 用 AWS ツールキットは、無料で提供されている Visual Studio コミュニティエディションでも動作します。これと AWS の無料利用枠は、AWS を初めて使用する開発者にとっては素晴らしい組み合わせです。

AWS Toolkit for Rider をインストールするには、[ファイル] メニューから [設定]、[プラグイン] の順に開きます。AWS Toolkit を検索してインストールします。

コンピュータで既に AWS アカウントを設定している場合、ツールキットは自動的に AWS アカウントに接続します。

インストールが完了すると、さまざまな新しい AWS Lambda 関数テンプレートを利用できるようになります。

AWS CLI は Linux、Windows、macOS で利用できます。インストール方法は、オペレーティングシステムによって異なります。詳細な手順は、AWS ページ「AWS CLI の最新バージョンをインストールまたは更新する」に記載されています。 AWS では、パッケージ管理ソフトウェアを使用して AWS CLI をインストールしないことをお勧めします。代わりに、上記のリンクを使用してください。

最新の機能を利用するには、AWS CLI を随時更新する必要があることに注意してください。

お使いの AWS CLI のバージョンを確認するには、次のコマンドを実行します。

次のようなレスポンスが表示されます。

これにより、AWS CLI のバージョン 2.5.4 がインストールされていることがわかります。

AWS CLI の最新バージョンを確認するには、 https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst にアクセスしてください。下の「CHANGELOG」が最新リリースのバージョンになります。これを書いている時点では 2.7.2 なので、AWS CLI を更新する必要があります。

AWS CLI を使用すると、すべての AWS リソースを管理できます。AWS CLI には、探しているリソースを見つけるのに役立つ強力なクエリ機能とフィルタリング機能が含まれています。ご想像のとおり、AWS CLI では Lambda 関数を一覧表示、表示、管理、および呼び出すことができます。

例を含む詳細なドキュメントは、AWS CLI コマンドリファレンスで入手できます。

Helm チャートをインストールするには、次のコマンドを実行します。

インストールが完了したら、dotnet new コマンドを使用して新しい Lambda 関数プロジェクトを作成します。

使用可能なプロジェクトテンプレートのリストを表示するには、以下のコマンドを実行します。

次のような出力が表示されます (使用可能なテンプレートは定期的に変更されることに注意してください)。

一部のテンプレートの短縮名が「serverless」で始まっていることに気付くかもしれません。」で始まるものもあれば、「lambda」で始まるものもあります。」。

「サーバーレス」で始まるもの.AWS サーバーレスアプリケーションモデル (SAM) を使用して Lambda 関数をデプロイし、Lambda 関数が使用する必要なインフラストラクチャを構築します。AWS SAM は、AWS 上でサーバーレスアプリケーションを構築できるオープンソースのフレームワークです。Lambda 関数の定義に加えて、AWS SAM では API ゲートウェイ、データベース、イベントソースなどの他のリソースを定義できます。

プロジェクト名/src/プロジェクト名ディレクトリに移動すると、serverless.template というファイルが表示されます。これにより、必要なインフラストラクチャと、それを Lambda 関数に接続する方法が定義されます。全体として「サーバーレス」。上記のテンプレートでは、API ゲートウェイを使用して HTTP リクエストを Lambda 関数にルーティングします。

「lambda」で始まるテンプレートはサーバーレスアプリケーションモデルを使用せず、他のインフラストラクチャをセットアップしないでください。他のインフラストラクチャが必要な場合は、自分でセットアップする必要があります。たとえば、Lambda.Kinesis プロジェクトテンプレートには、受信した Kinesis イベントの処理方法が示されていますが、Kinesis ストリームが自動的に作成されるわけではなく、Kinesis が Lambda 関数をトリガーするのに必要な関連権限も追加されていません。

Lambda.EmptyFunction テンプレートに基づいて新しいプロジェクトを作成するには、以下を実行します。

ツールはオープンソースで、GitHub で閲覧できます。

https://github.com/aws/aws-lambda-dotnet#dotnet-cli-templates

他のコマンドラインツールと同様、関連する GitHub ページをチェックして、新しいバージョンがいつリリースされるかを確認する必要があります。

.NET CLI 用の AWS 拡張機能をインストールするには、以下を実行します。

正しくインストールされていることを確認するには、以下を実行します。

これにより、使用できるコマンドの概要とバージョン番号が出力されます。

このツールはどのシェルからでも機能し、Visual Studio Code および Rider 内のターミナルから使用する場合に特に便利です。これにより、一般的な Lambda 関数関連のタスクを実行できます。

たとえば、すべての Lambda 関数を一覧表示するには、以下を使用できます。

もしくは、Lambda 関数の呼び出し:

Lambda 関数をデプロイすることもできます。dotnet Lambda テンプレート (上記参照) を使用して Lambda 関数を作成したら、次のコマンドを使用して関数を AWS にデプロイできます。

これにより、ビルドとガイド付きのデプロイプロセスが開始されます。ツールは、Lambda 関数名、関数に割り当てる (または新しいロールを作成する) ロールの入力を求めます。新しいロールを作成した場合、その新しいロールのアクセス権限ポリシーを選択するように求められます。その後、ツールは関数を AWS にデプロイし、数秒以内に呼び出せるようになります。

使用可能なコマンドラインオプションをすべて表示するには、-を使用してください

各コマンドの背後には多くの機能がある場合があるため、各コマンドラインが複数のオプションをサポートしていることを理解することが重要です。たとえば、更新関数構成では、Lambda 関数の URL を有効にして設定します。この機能は deployy-function コマンドでは使用できません。Lambda サービスに関する最新のリリースドキュメントと機能を常に把握しておくことは、最新の機能を理解して活用するのに役立つため、重要です。

このツールは、コードを開発したり AWS について学んだりする際に、Lambda 関数を管理するのに非常に便利で強力ですが、ある程度の成熟度に達したアプリケーションへのデプロイには、堅牢な CI/CD プロセスを使用することを強くお勧めします。AWS はすべての主要な CI/CD ツールをサポートしています。

Windows へのインストールについては、AWS Tools for PowerShell on Windows のインストールガイドを参照してください。

Linux または Mac にインストールする場合は、 AWS Tools for PowerShell on Linux or macOS のインストールガイドを参照してください。

AWS Tools for PowerShell で実行できるモジュール、そしてコマンドの数は非常に多いです。AWS Lambda では、ツールを使用して関数の一覧表示、表示、デプロイ、管理、呼び出しを行うことができます。

使用可能なコマンドをすべて表示するには、以下を実行します。

すべてのコマンドの完全なドキュメントは、AWS Tools for PowerShell コマンドレットリファレンスにあります。左側のバーの Lambda セクションに移動してください。

すべての Lambda 関数を一覧表示するには、以下を実行します。

Lambda 関数の呼び出し: