Run Script

The Run Script action enables you to run a bash script on your edge device.

You might have several reasons to use the Run Script step type, such as preparing the edge devices for installing a new software version or doing some special tasks after a version has been received. You may also have scripts that help to resolve issues in a software version that is running on the device.

Example: Update Binaries on Device

Actions (in order)	Task
Run Command	Copy and save device-specific configuration files
Download Artifacts	Pull your update binaries from Artifactory
Run Command	Unzip file with your binary artifacts
Run Command	Change user permissions for your application
Run Script	Verifies configuration and runs tests. If failed, rollback entire update (i.e., runs general rollback)
Run Command	Restart service that runs your application

Prerequisites

• JFrog Connect account and at least one device registered.

• A script file ready for deployment.

• In the Create Update Flow procedure, completed through Step 3.

Add a Step and Configure the Step Type

To add a step and configure the step type you have chosen, do the following:

1. In the Create New Flow page, click Add Step.

2. In the Step Type dropdown list, choose Run Script, give the step a Step Name, and create the step. You can change the step name afterwards if you need to.

3. Enter the following information:

   • Script File: Enter (drag and drop, or browse) the script file in the script box.

   • Binary Path: The path on the device where the script should run.

   • Script Arguments: The values required for script arguments.

1. (Optional) Configure your On Failure policy and instructions for rolling back.

2. Save your step configuration.

You can add more steps to the workflow.

What’s Next?

Learn how to deliver one or more files to your client devices using the Deploy Files step type.