Lambda launcher - AWS IoT Greengrass

Lambda launcher

The Lambda launcher component (aws.greengrass.LambdaLauncher) starts and stops AWS Lambda functions on AWS IoT Greengrass core devices. This component also sets up any containerization and runs processes as the users that you specify.

Note

When you deploy a Lambda function component to a core device, the deployment also includes this component. For more information, see Run AWS Lambda functions.

Versions

This component has the following versions:

  • 2.0.x

Type

This component is a generic component (aws.greengrass.generic). The Greengrass nucleus runs the component's lifecycle scripts.

For more information, see Component types.

Operating system

This component can be installed on Linux core devices only.

Requirements

This component has the following requirements:

  • Your core device must meet the requirements to run Lambda functions. If you want the core device to run containerized Lambda functions, the device must meet the requirements to do so. For more information, see Lambda function requirements.

Dependencies

When you deploy a component, AWS IoT Greengrass also deploys compatible versions of its dependencies. This means that you must meet the requirements for the component and all of its dependencies to successfully deploy the component. This section lists the dependencies for the released versions of this component and the semantic version constraints that define the component versions for each dependency. You can also view the dependencies for each version of the component in the AWS IoT Greengrass console. On the component details page, look for the Dependencies list.

2.0.9

The following table lists the dependencies for version 2.0.9 of this component.

Dependency Compatible versions Dependency type
Lambda manager >=2.0.0 <2.3.0 Hard
2.0.4 - 2.0.8

The following table lists the dependencies for versions 2.0.4 to 2.0.8 of this component.

Dependency Compatible versions Dependency type
Lambda manager >=2.0.0 <2.2.0 Hard
2.0.3

The following table lists the dependencies for version 2.0.3 of this component.

Dependency Compatible versions Dependency type
Lambda manager >=2.0.3 <2.1.0 Hard

For more information about component dependencies, see the component recipe reference.

Configuration

This component doesn't have any configuration parameters.

Local log file

This component uses the following log file.

/greengrass/v2/logs/lambdaFunctionComponentName.log

To view this component's logs

  • Run the following command on the core device to view this component's log file in real time. Replace /greengrass/v2 with the path to the AWS IoT Greengrass root folder, and replace lambdaFunctionComponentName with the name of the Lambda function component that this component launches.

    sudo tail -f /greengrass/v2/logs/lambdaFunctionComponentName.log

Changelog

The following table describes the changes in each version of the component.

Version

Changes

2.0.9

Version updated for Greengrass nucleus version 2.5.0 release.

2.0.8

Version updated for Greengrass nucleus version 2.4.0 release.

2.0.7

Version updated for Greengrass nucleus version 2.3.0 release.

2.0.6

General performance improvements and bug fixes.

2.0.4

Bug fixes and improvements
  • Fixes an issue where the component doesn't correctly pass AddGroupOwner to the Lambda function container.

2.0.3

Initial version.