Step 6: Deploy your component

With Amazon IoT Greengrass, you can deploy components to individual devices or groups of devices. When you deploy a component, Amazon IoT Greengrass installs and runs that component's software on each target device. You specify which components to deploy and the configuration update to deploy for each component. You can also control how the deployment rolls out to the devices that the deployment targets. For more information, see Deploy Amazon IoT Greengrass components to devices.

In this section, you deploy your Hello World component back to your Greengrass core device.

In the Amazon IoT Greengrass console navigation menu, choose Components.
On the Components page, on the My components tab, choose com.example.HelloWorld.
On the com.example.HelloWorld page, choose Deploy.
From Add to deployment, choose Create new deployment, then choose Next.
On the Specify target page, do the following:
1. In the Name box, enter Deployment for MyGreengrassCore.
2. For Deployment target, choose Core device, and the name of the Amazon IoT thing for your core device. The default value in this tutorial is MyGreengrassCore.
3. Choose Next.
On the Select components page, under My components, verify that the com.example.HelloWorld component is selected, and choose Next.
On the Configure components page, choose com.example.HelloWorld, and do the following:
1. Choose Configure component.
2. Under Configuration update, in Configuration to merge, enter the following configuration.
```
{
  "Message": "universe"
}
```
  This configuration update sets the Hello World Message parameter to universe for the device in this deployment.
3. Choose Confirm.
4. Choose Next.
On the Configure advanced settings page, keep the default configuration settings, and choose Next.
On the Review page, choose Deploy.
Verify that the deployment completes successfully. The deployment can take several minutes to complete. Check the Hello World log to verify the change. Run the following command on your Greengrass core device.
Linux or Unix
```
sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
```
Windows Command Prompt (CMD)
```
type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
```
PowerShell
```
gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait
```
You should see messages similar to the following example.
```
Hello, universe! Greetings from your first Greengrass component.
```
Note
If the log messages don't change, the deployment failed or didn't reach the core device. This can occur if your core device isn't connected to the internet or doesn't have permissions to retrieve artifacts from your S3 bucket. Run the following command on your core device to view the Amazon IoT Greengrass Core software log file. This file includes logs from the Greengrass core device's deployment service.
Linux or Unix

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

Windows Command Prompt (CMD)

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

The type command writes the file's contents to the terminal. Run this command multiple times to observe changes in the file.

PowerShell

gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait
For more information, see Troubleshooting Amazon IoT Greengrass V2.

To deploy your Hello World component

On your development computer, create a file called hello-world-deployment.json and copy the following JSON into the file. This file defines the components and configurations to deploy.
```
{
  "components": {
    "com.example.HelloWorld": {
      "componentVersion": "1.0.0",
      "configurationUpdate": {
        "merge": "{\"Message\":\"universe\"}"
      }
    }
  }
}
```
This configuration file specifies to deploy version 1.0.0 of the Hello World component that you developed and published in the previous procedure. The configurationUpdate specifies to merge the component configuration in a JSON-encoded string. This configuration update sets the Hello World Message parameter to universe for the device in this deployment.

Run the following command to deploy the component to your Greengrass core device. You can deploy to things, which are individual devices, or thing groups, which are groups of devices. Replace MyGreengrassCore with the name of the Amazon IoT thing for your core device.

The command outputs a response similar to the following example.


{
  "deploymentId": "deb69c37-314a-4369-a6a1-3dff9fce73a9",
  "iotJobId": "b5d92151-6348-4941-8603-bdbfb3e02b75",
  "iotJobArn": "arn:aws-cn:iot:region:account-id:job/b5d92151-6348-4941-8603-bdbfb3e02b75"
}

Verify that the deployment completes successfully. The deployment can take several minutes to complete. Check the Hello World log to verify the change. Run the following command on your Greengrass core device.
Linux or Unix
```
sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
```
Windows Command Prompt (CMD)
```
type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
```
PowerShell
```
gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait
```
You should see messages similar to the following example.
```
Hello, universe! Greetings from your first Greengrass component.
```
Note
If the log messages don't change, the deployment failed or didn't reach the core device. This can occur if your core device isn't connected to the internet or doesn't have permissions to retrieve artifacts from your S3 bucket. Run the following command on your core device to view the Amazon IoT Greengrass Core software log file. This file includes logs from the Greengrass core device's deployment service.
Linux or Unix

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

Windows Command Prompt (CMD)

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

The type command writes the file's contents to the terminal. Run this command multiple times to observe changes in the file.

PowerShell

gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait
For more information, see Troubleshooting Amazon IoT Greengrass V2.

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Step 5: Create your component in the Amazon IoT Greengrass service

Next steps

Step 6: Deploy your component

Note

To deploy your Hello World component

Note