AWS Lambda LocalStack をサポートする - AWS Toolkit for VS Code
前提条件 LocalStack のインストール LocalStack のセットアップ VS Code での LocalStack の開始 サンプルサーバーレスアプリケーションの構築LocalStack を使用した Lambda 関数のテストとデバッグ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Lambda LocalStack をサポートする

の LocalStack サポートを使用して、サーバーレスアプリケーションを構築、テスト、デバッグします AWS Toolkit for Visual Studio Code。LocalStack は、サーバーレスアプリケーションのローカルテストを可能にする AWS クラウドエミュレータです。

詳細については AWS Lambda、「 AWS Lambdaデベロッパーガイド」を参照してください。LocalStack の詳細については、そのウェブサイト LocalStack を参照してください。

前提条件

以下は、VS Code で LocalStack を使用するための前提条件です。

注記

LocalStack CLI はセットアッププロセス中にインストールされますが、別のバージョンの LocalStack CLI を使用する場合は、必要な最小バージョンは 4.8.0 です。

  • LocalStack ウェブアプリケーションアカウントは、無料および有料の LocalStack 階層で使用できるすべての機能にアクセスするために必要です。LocalStack コミュニティエディションは、 アカウントなしで使用できます。

  • Docker は、VS Code で LocalStack を操作するために必要です。Docker の LocalStack 要件の詳細については、LocalStack ドキュメントのLocalStack Docker イメージ」トピックを参照してください。

  • 推奨： AWS Command Line Interface （AWS CLI) は、シミュレートされたクラウド環境でのサービスの使用を支援します。

LocalStack のインストール

LocalStack の無料および有料階層バージョンをインストールするには、次の手順を実行します。

注記

LocalStack Community Edition を設定する方法については、このトピックのLocalStack のセットアップ」セクションの「LocalStack Community コンテンツ」を参照してください。 LocalStack

  1. Toolkit から AWS 、APPLICATION BUILDER エクスプローラーを展開します。

  2. Open Walkthrough ボタンを選択して、VS Code エディタの「Get started building your application walkthrough」タブを開きます。

  3. チュートリアルから LocalStack のインストールを選択して、VS Code で LocalStack のインストールプロセスを開始します。

LocalStack のセットアップ

VS Code の LocalStack 拡張機能をインストールすると、セットアップが必要な場合に次のいずれかのインジケータが表示されることがあります。

  • デフォルトでは IDE の左下隅にある VS Code Status Bar では、LocalStack のステータスが赤になります。

  • VS Code は LocalStack の設定を求めます。

LocalStack のセットアップと設定には、使用している LocalStack のバージョンに応じて 2 種類あります。以下のタブ付きセクションでは、各 LocalStack セットアッププロセスについて説明します。

注記

LocalStack の無料および有料階層バージョンには、LocalStack 認証トークンが必要です。LocalStack の料金の詳細については、「プラン料金の選択」ガイドを参照してください。

LocalStack をセットアップする方法は 2 つあります。

  • VS Code Setup LocalStack で開始プロンプトが表示されたら、Setup ボタンを選択します。

  • VS Code ステータスバーから、LocalStack ステータスアイコンを選択してセットアップ LocalStack を開いてプロンプトを表示し、セットアップボタンを選択します。

セットアップ中、システムは次のステップを実行します。

  1. LocalStack CLI をインストールします。

  2. LocalStack アカウントがあるかどうかをチェックします。

  3. LocalStack アカウントをお持ちの場合、システムはデフォルトのウェブブラウザで認証プロセスをガイドします。同様に、LocalStack アカウントがない場合、認証プロセスの前にシステムはアカウントのセットアップをガイドします。

LocalStack が設定されると、VS Code ステータスバーの LocalStack ステータスが更新されます。

注記

LocalStack のプロファイルを作成していない場合は、LocalStack のセットアッププロセスの一環として新しい AWS プロファイルが自動的に作成されます。

LocalStack のコミュニティエディションは無料で使用でき、アカウントにサインアップする必要はありません。ライセンスを必要としない Docker イメージから実行されます。LocalStack Community Edition の詳細については、LocalStack Community イメージドキュメントを参照してください。以下のセクションでは、VS Code で LocalStack コミュニティエディションを使用するために必要な前提条件と基本的なセットアップについて説明します。

新しいインスタンスの起動

LocalStack Community の新しいインスタンスを起動するには、次の手順を実行します。

注記

次の の例では、ポート 4566 で LocalStack のコンテナインスタンスを起動します。異なるポート値を指定する場合は、「 AWS CLI と AWS Toolkit の設定」セクションにある手順で指定されたポート値を更新する必要があります。

  1. VS Code から、 を押して VS Code ターミナルを開きますctrl + `(backtick)。

  2. ターミナルに以下を入力します。

    Mac:

    docker run -d --name localstack_main \
>> -p 4566:4566 \
>> -v /var/run/docker.sock:/var/run/docker.sock \
>> localstack/localstack

    Windows ：

    docker run -d --name localstack_main `
>> -p 4566:4566 `
>> -v /var/run/docker.sock:/var/run/docker.sock `
>> localstack/localstack

  3. プロセスが完了すると、ターミナルは Docker インスタンスのステータスで更新されます。

LocalStack のこのコンテナ化されたインスタンスでは、ダウンロードプロセス中に指定した AWS サービスにアクセスできます。

LocalStack と Docker の CLI の設定。

Docker で LocalStack と連携するように AWS CLI と AWS Toolkit を設定するには、次の手順を実行して新しいプロファイルを設定します。

  1. VS Code から、 を押して VS Code ターミナルを開きますctrl + `(backtick)。

  2. ターミナルに以下を入力します。

    ~/.aws/credentials
[localstack]
aws_access_key_id = test
aws_secret_access_key = test
~/.aws/config
[profile localstack]
region = us-east-1
output = json
endpoint_url = http://localhost:4566 [default localstack endpoint]

  3. AWS Toolkit は LocalStack プロファイルを検出し、接続ステータスメニューを更新します。

セットアップ後、ステータスバーのプロファイルセクションから LocalStack AWS プロファイルを選択すると、LocalStack リソースが AWS エクスプローラーに表示されます。さらに、VS Code ターミナルの出力タブで LocalStack ログを表示できます。

VS Code での LocalStack の開始

LocalStack は、次のいずれかの方法を使用して起動できます。

VS Code Status Bar からの LocalStack の開始

  1. VS Code からステータスバーに移動し、LocalStackの開始ボタンを選択して LocalStack を起動します。

  2. LocalStack が正常に起動すると、VS Code Status Bar が更新されます。

VS Code コマンドパレットからの LocalStack の開始

  1. VS Code から、 (Mac) または Cmd + Shift + P (Control + Shift + PWindows) を押して コマンドパレットを開きます。

  2. コマンドパレットから、検索バーStart LocalStackに と入力し、結果に入力するときにリストから選択します。

  3. LocalStack が正常に起動すると、VS Code Status Bar が更新されます。

VS Code ターミナルから LocalStack を起動する

  1. VS Code から、 を押して VS Code ターミナルを開きますctrl + `(backtick)。

  2. VS Code ターミナルから、localstack startCLI コマンドを入力します。

  3. LocalStack が正常に起動すると、VS Code Status Bar が更新されます。

サンプルサーバーレスアプリケーションの構築

VS Code で LocalStack の使用を開始するには、サンプルサーバーレスアプリケーションが必要です。 AWS アカウントに既存のアプリケーションがある場合は、LocalStack を使用してローカルにデプロイすることも、 AWS Serverless Land を使用して新しいアプリケーションを作成することもできます。

Toolkit で AWS Serverless Land を使用してアプリケーションを作成する方法の詳細については、このユーザーガイドのAWS 「Serverless Land の使用」トピックを参照してください。Serverless Land の詳細については、Serverless Land ウェブアプリケーションのメインランディングページを参照してください。

LocalStack を使用した Lambda 関数のテストとデバッグ

LocalStack VS Code 拡張機能での Lambda 関数のテストとデバッグは、 AWS クラウドにデプロイされた関数の操作に似ています。主な違いは、LocalStack を使用して関数をデプロイおよびデバッグするために、 AWS Toolkit インスタンスを LocalStack アカウントで認証する必要があることです。

注記

このセクションで説明するテストおよびデバッグ機能は、LocalStack Community Edition では使用できません。

VS Code で LocalStack を使用するには、 Toolkit の AWS LocalStack プロファイルに接続します。LocalStack プロファイルがアクティブな場合、VS Code ステータスバーには AWS: profile:localstack (カスタムエンドポイント） とチェックマークが表示されます。

AWS Toolkit での Lambda 関数の使用の詳細については、このユーザーガイドのAWS Lambda 関数の使用トピックを参照してください。