Clone Git Repository

The Clone Git Repository action enables you to pull your latest software version from a Git repository directly to your edge devices.

Connect's Update Flow enables your edge devices to clone from a Git repository whether you are using a public Git repository or your own private repository for your code.

When you use the Clone Git Repository action, the edge devices will use the git clone command to pull your Git repo.

Prerequisites

• JFrog Connect account.

• GitHub account

Drag the Action

To include the Clone Git Repository action in your update flow, do the following:

1. Go to Deployment in the left menu and click Create Update Flow.

2. Drag the Clone Git Repository action and drop it in the workflow.

Configure the Action

Click the action to open and configure it.

1. Enter a name for the action.

2. Private Git: Mark this checkbox only if you are using a private Git repository. Choose the account where your repository exists. If the account is not in the list, you can add it according to the procedure in Add Private Git.

1. Git Repository URL: Enter the URL of the Git, for example, https://github.com/jfrog-connect/app-repo.git.

2. Device Destination Path: Enter the path where the Git will be installed on the device, for example, /home/user/App.

Tip: The folder on the device must exist beforehand. Otherwise, the update will fail. Connect does not automatically create folders when deploying updates. You can create a folder using the Run Command action.

1. Configure your On Failure policy and instructions for rolling back, if necessary.

2. Save your action configuration.

On Failure and Rollback

For your On Failure policy, choose one of the actions for Connect to do in case the Clone Git Repository action fails.

• Continue Update Flow: If the Clone Git Repository action fails, Connect will simply continue with the next action in the update workflow.

• Run General Rollback: The action and the entire update workflow are rolled back.

As a general precaution, Connect Agent creates a backup of the relevant device folder in a temporary location. If a rollback is required, the agent restores the folder to its initial state.

Free Memory Requirement

To enable Rollback functionality, your device's free memory must be greater than the update size. Use the relationship below to calculate the amount of free memory required.

Free Memory Required > Current Folder Size + Update Size + 10MB

What’s Next?

Learn more about configuring your On Failure policy and instructions for rolling back.