A Hello World Java Lambda function demonstrating interactive breakpoint debugging using LocalStack Lambda Remote Debugging. LocalStack automatically configures debugging and adjusts relevant timeouts. The recommended setup uses the AWS Toolkit for VS Code for one-click debugging.

• A valid LocalStack for AWS license. Your license provides a LOCALSTACK_AUTH_TOKEN to activate LocalStack.
• Docker
• VS Code with the LocalStack Toolkit ≥ 1.2 and AWS Toolkit ≥ 3.74
• Java and Maven
• AWS CLI v2 or AWS SAM CLI

make check

make install

1. Execute the VS Code command "LocalStack: Run Setup Wizard" using the LocalStack Toolkit
2. Start LocalStack by clicking on the LocalStack Toolkit status bar

1. Run make build
2. Run make deploy

1. Open the Remote invoke configuration in the AWS Toolkit
   1. Open the AWS Toolkit extension
   2. Expand the AWS Explorer and Lambda node
   3. Navigate to the function you want to debug, then choose the Invoke remotely icon ▶️ from the context menu
2. Select the Remote debugging check box to display the remote debugging properties
3. Specify the Local Root Path to your local handler file.
4. Set a breakpoint in your handler file by clicking in the gutter-margin
5. Click the Remote invoke button to invoke the Lambda function

1. Start LocalStack with the following configuration:

   LOCALSTACK_AUTH_TOKEN=<your-auth-token> \
   LOCALSTACK_LAMBDA_DEBUG_MODE=1 \
   LOCALSTACK_LAMBDA_DEBUG_MODE_CONFIG_PATH=/tmp/lambda_debug_mode_config.yaml \
   localstack start --volume $PWD/lambda_debug_mode_config.yaml:/tmp/lambda_debug_mode_config.yaml

   • LOCALSTACK_AUTH_TOKEN=<your-auth-token> is the authentication token for LocalStack
   • LOCALSTACK_LAMBDA_DEBUG_MODE=1 adjusts timeouts
   • LOCALSTACK_LAMBDA_DEBUG_MODE_CONFIG_PATH=/tmp/lambda_debug_mode_config.yaml points to the config file for Lambda debug mode allowing for advanced configuration. It maps the Lambda function arn:aws:lambda:us-east-1:000000000000:function:HelloWorldFunctionJava to port 5050.
   • --volume $PWD/lambda_debug_mode_config.yaml:/tmp/lambda_debug_mode_config.yaml maps the Lambda debug configuration from the host into the LocalStack Docker container for hot-reloading configuration updates.

1. Run make build to build the Lambda ZIP package
2. Run make deploy to deploy the Lambda function

1. Open the sample folder in VS Code to auto-detect .vscode/launch.json
2. Set a breakpoint in the handler file HelloWorldFunction/src/main/java/helloworld/App.java by clicking in the gutter-margin
3. Open the Run and Debug view in VS Code
4. Run the Java: Remote Attach task
5. Run make invoke to invoke the Lambda function

• Concurrent invokes are currently rejected with a ResourceConflictException. Upvote this GitHub issue if this affects you.

The code in this sample is available under the Apache 2.0 license.