Greengrass CLI

The Greengrass CLI component (aws.greengrass.Cli) provides a local command-line interface that you can use on core devices to develop and debug components locally. The Greengrass CLI lets you create local deployments and restart components on the core device, for example.

You can install this component when you install the AWS IoT Greengrass Core software. For more information, see Tutorial: Getting started with AWS IoT Greengrass V2.

After you install this component, run the following command to view its help documentation. When this component installs, it adds a symbolic link to greengrass-cli in the /greengrass/v2/bin folder. You can run the Greengrass CLI from this path or add it to your PATH environment variable to run greengrass-cli without its absolute path.

Linux or Unix

/greengrass/v2/bin/greengrass-cli help

Windows

C:\greengrass\v2\bin\greengrass-cli help

The following command restarts a component named com.example.HelloWorld, for example.

Linux or Unix

sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"

Windows

C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"

For more information, see Greengrass Command Line Interface.

Versions

This component has the following versions:

Type

This component is a plugin component (aws.greengrass.plugin). The Greengrass nucleus runs this component in the same Java Virtual Machine (JVM) as the nucleus. The nucleus restarts when you change this component's version on the core device.

This component uses the same log file as the Greengrass nucleus. For more information, see Monitor AWS IoT Greengrass logs.

For more information, see Component types.

Operating system

Requirements

This component has the following 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.12.0 – 2.12.4

The following table lists the dependencies for version 2.12.0 through 2.12.4 of this component.

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.12.0 <2.13.0	Soft

2.11.0 – 2.11.3

The following table lists the dependencies for versions 2.11.0 through 2.11.3 of this component.

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.11.0 <2.12.0	Soft

2.10.0 – 2.10.3

The following table lists the dependencies for versions 2.10.0 through 2.10.3 of this component.

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.5.0 <2.11.0	Soft

2.9.0 – 2.9.6

The following table lists the dependencies for versions 2.9.0 through 2.9.6 of this component.

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.5.0 <2.10.0	Soft

2.8.0 – 2.8.1

The following table lists the dependencies for version 2.8.0 and 2.8.1 of this component.

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.5.0 <2.9.0	Soft

2.7.0

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.5.0 <2.8.0	Soft

2.6.0

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.5.0 <2.7.0	Soft

2.5.0 – 2.5.6

The following table lists the dependencies for versions 2.5.0 through 2.5.6 of this component.

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.5.0 <2.6.0	Soft

2.4.0

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.1.0 <2.5.0	Soft

2.3.0

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.1.0 <2.4.0	Soft

2.2.0

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.1.0 <2.3.0	Soft

2.1.0

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.1.0 <2.2.0	Soft

2.0.x

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

Dependency	Compatible versions	Dependency type
Greengrass nucleus	>=2.0.0 <2.1.0	Soft

Note

The minimum compatible version of the Greengrass nucleus corresponds to the patch version of the Greengrass CLI component.

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

Configuration

This component provides the following configuration parameters that you can customize when you deploy the component.

2.5.x

AuthorizedPosixGroups

(Optional) A string that contains a comma-separated list of system groups. You authorize these system groups to use the Greengrass CLI to interact with the AWS IoT Greengrass Core software. You can specify group names or group IDs. For example, group1,1002,group3 authorizes three system groups (group1, 1002, and group3) to use the Greengrass CLI.

If you don't specify any groups to authorize, you can use the Greengrass CLI as the root user (sudo) or as the system user that runs the AWS IoT Greengrass Core software.

AuthorizedWindowsGroups

(Optional) A string that contains a comma-separated list of system groups. You authorize these system groups to use the Greengrass CLI to interact with the AWS IoT Greengrass Core software. You can specify group names or group IDs. For example, group1,1002,group3 authorizes three system groups (group1, 1002, and group3) to use the Greengrass CLI.

If you don't specify any groups to authorize, you can use the Greengrass CLI as an administrator or as the system user that runs the AWS IoT Greengrass Core software.

Example: Configuration merge update

The following example configuration specifies to authorize three POSIX system groups (group1, 1002, and group3) and two Windows user groups (Device Operators and QA Engineers) to use the Greengrass CLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}

2.4.x - 2.0.x

AuthorizedPosixGroups

(Optional) A string that contains a comma-separated list of system groups. You authorize these system groups to use the Greengrass CLI to interact with the AWS IoT Greengrass Core software. You can specify group names or group IDs. For example, group1,1002,group3 authorizes three system groups (group1, 1002, and group3) to use the Greengrass CLI.

If you don't specify any groups to authorize, you can use the Greengrass CLI as the root user (sudo) or as the system user that runs the AWS IoT Greengrass Core software.

Example: Configuration merge update

The following example configuration specifies to authorize three system groups (group1, 1002, and group3) to use the Greengrass CLI.

{
  "AuthorizedPosixGroups": "group1,1002,group3"
}

Local log file

This component uses the same log file as the Greengrass nucleus component.

Linux

/greengrass/v2/logs/greengrass.log

Windows

C:\greengrass\v2\logs\greengrass.log

Changelog

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