Run Command

The Run Command step type enables you to run a bash command on your client device.

The Run Command step type is useful for performing a variety of tasks on the edge device. You may need the Run Command as a prerequisite to other tasks, for example, to create folders on the devices before delivering files or to stop a service before delivering an update.

You might also use Run Command after other steps, for example, to run a script that was delivered in a previous step or to delete artifacts no longer used.

A customer example below illustrates how you might use the Run Command step type in an update flow.

Example: Run Command in Update Flow

Steps (in order)	Task
Run Command	Safekeeping device-specific configuration files
Download Artifact	Pull your update binaries from Artifactory
Run Command	Unzip file with your binary artifacts
Run Command	Change user permissions for your application
Run Command	Restart service that runs your application

Pull Commands

A pull command used in the Run Command step type cannot be reverted. Therefore, for pulling artifacts, we recommend using one of the pull step types such as Artifacts, Deploy Container or Clone Git Repository.

Prerequisites

• JFrog Connect account and at least one device registered.

• 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 Command, give the step a Step Name, and create the step.

3. Enter the Command to run.

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

2. Save your step configuration.

You can run additional commands in the flow by adding more steps. You can also perform other tasks in the same flow by adding and configuring the relevant step types.

If you plan to run several commands and need to specify a logic that is more complex, you might consider using the Run Script step type.

What’s Next?

Learn more about using the Run Script step type to run a script on your client devices.