Lambda launcher - Amazon IoT Greengrass
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Lambda launcher

The Lambda launcher component (aws.greengrass.LambdaLauncher) starts and stops Amazon Lambda functions on Amazon 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 Amazon 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.

  • The Lambda launcher component is supported to run in a VPC.

Dependencies

When you deploy a component, Amazon 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 Amazon IoT Greengrass console. On the component details page, look for the Dependencies list.

2.0.11 – 2.0.13

The following table lists the dependencies for versions 2.0.11 to 2.0.13 of this component.

Dependency Compatible versions Dependency type
Lambda manager >=2.0.0 <2.4.0 Hard
2.0.9 – 2.0.10

The following table lists the dependencies for versions 2.0.9 to 2.0.10 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 Amazon 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.13

Bug fixes and improvements

General bug fixes and improvements.

2.0.12

Bug fixes and improvements

Fixes an issue where the Lambda launcher could throw an error if the previous process was not stopped properly.

2.0.11

Support for Lambda manager 2.3.0.

2.0.10

Bug fixes and improvements
  • General bug fixes and improvements.

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.