AWS Lambda リモートデバッグ

AWS エクスプローラーからの Lambda リモートデバッグへのアクセス

1. VS Code から Toolkit AWS 拡張機能を開きます。

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

3. エクスプローラーから、[Lambda] ノードを展開します。

4. デバッグする関数に移動し、コンテキストメニューから [リモート呼び出し] アイコンを選択して [リモート呼び出し設定] 画面を開きます。

アプリケーションビルダーエクスプローラーからの Lambda リモートデバッグへのアクセス。

1. VS Code から Toolkit AWS 拡張機能を開きます。

2. AWS Toolkit から、Application Builder Explorer を展開します。

3. エクスプローラーから、デバッグする Lambda プロジェクトを含む AWS SAM プロジェクトを展開します。

4. デバッグする、デプロイされた Lambda 関数を展開します。

5. リモート関数に移動し、コンテキストメニューから [リモート呼び出し] アイコンを選択して [リモート呼び出し設定] 画面を開きます。

1. AWS エクスプローラーからの Lambda リモートデバッグへのアクセスまたは前のセクションにある Application Builder エクスプローラーからの Lambda リモートデバッグへのアクセスの手順を完了して、リモート呼び出し設定メニューを開きます。

2. [リモート呼び出し設定] メニューから、[リモートデバッグ] チェックボックスを選択してリモートデバッグプロパティを表示します。

3. ローカルハンドラーファイルへのローカルルートパスを指定します。

   注記

   ローカルルートパスは、デプロイされた Lambda 関数に一致するソースコードの場所です。アプリケーションビルダーエクスプローラーでデプロイされた関数から作業している場合、ローカルルートパスが自動的に検出されます。

   ローカルに保存されたソースコードがない場合は、[リモートコードのダウンロード] ボタンを選択して Lambda 関数のソースコードを取得します。これにより、VS Code エディタで handler file が開きます。

4. [Payload] セクションで、テストイベントデータを取得する場所を指定します。

1. VS Code エディタの handler file から、余白部分をクリックして、デバッグを一時停止する行番号にブレークポイントを設定します。

2. ブレークポイントに問題がなければ、[リモート呼び出し設定] メニューに戻り、設定が正しく構成されていることを確認します。次に [リモート呼び出し] ボタンを選択してデバッグを開始します。

3. AWS Toolkit は Lambda 関数をデバッグ機能で更新し、デバッグセッションのセキュアトンネルを確立し、指定されたペイロードで関数を呼び出し、ブレークポイントに達するとプロセスを一時停止します。

4. ブレークポイントの一時停止時に、[実行およびデバッグ] ペインを使用して [変数]、[呼び出しスタック]、[ブレークポイント] を表示します。

1. デバッグセッションをアクティブにした状態で、VS Code エディタで handler file を変更します。

2. 変更内容を保存します (Command+S on macOS、Ctrl+S on Windows)。

3. プロンプトが表示されたら、変更をデプロイすることに同意します。Toolkit AWS は、変更されたコードで Lambda 関数を更新します。

4. 新しいブレークポイントを設定し、[リモート呼び出し] ボタンを再度選択して、変更のデバッグとテストを続行します。

   注記

   または、VS Code デバッグコントロールで [Attach debugger] オプションの選択を解除し、[リモート呼び出し] ボタンを選択してデバッグなしで関数を実行できます。

1. Toolkit の Lambda リモートデバッグから AWS 、リモートデバッグの追加設定セクションを展開します。

2. [リモートデバッグの追加設定] セクションで、[レイヤーオーバーライド] フィールドからリージョンレイヤー ARN をコピーします。

3. から AWS CLI、次のコマンドを使用してレイヤーバージョン をダウンロードしaws lambda get-layer-version-by-arn --arn layer-arn、 Layer-arn をレイヤー ARN に置き換えます。署名付きデバッグレイヤーをダウンロードする詳細な手順については、「AWS CLI コマンドリファレンス」の get-layer-version-by-arn リファレンスを参照してください。

4. コード署名設定でレイヤーに署名し、アカウントに公開します。署名と公開のガイダンスについては、「 AWS Serverless Application Model デベロッパーガイド」のAWS SAM 「アプリケーションへのコード署名の設定」トピックを参照してください。

5. レイヤーに署名してアカウントに公開したら、Lambda リモートデバッグの [リモートデバッグの追加設定] セクションに戻り、新しいレイヤー ARN を [レイヤーオーバーライド] フィールドに入力します。プロセスが完了すると、Lambda リモートデバッグはデフォルトのレイヤーの代わりに署名付きレイヤーを使用します。

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

2. エクスプローラーから、[Lambda] ノードを展開します。

3. TypeScript を設定する関数に移動し、コンテキストメニューから [リモート呼び出し] アイコンを選択して [リモート呼び出し設定] 画面を開きます。

4. リモートデバッグを有効にするには、[リモートデバッグ] チェックボックスをオンにします。

5. TypeScript handler file ディレクトリを指すように、ローカルルートパスを設定します。

   注記

   TypeScript handler file は、デバッグブレークポイントを設定する場所です。

6. [リモートデバッグの追加設定] を展開します。

7. [ソースマップ] チェックボックスをオンにして、ソースマッピングを有効にします。

8. [Out files] フィールドを Lambda 関数のコピーのローカルディレクトリに設定します。

   app.js と app.map が .aws-sam/build/HelloWorldFunction にある場合は、[Out files] の場所を /Users/user/project/aws-sam/build/HelloWorldFunction/* にします。

   注記

   Out file パスは絶対パスである必要があります。

9. 設定に問題がなければ、[リモート呼び出し] ボタンを選択して TypeScript 関数のデバッグを開始します。