LogoLogo
What's New?Connect Agent ReleasesBook a DemoPricing
  • Documentation
  • Developers
  • Administration
  • OVERVIEW
    • JFrog Connect Overview
      • Architecture Overview
        • Connect Agent
        • Connect & JFrog Platform
      • Plan Your Update Strategy
        • Software Update Objectives & Concepts
        • Software Update Process & Procedures
  • Get Started
    • Create JFrog Connect Account
    • Log in to JFrog Connect
    • Network Requirements
    • Register Device
  • Manage your Fleet
    • Register Devices at Scale
      • Freeze Image on Device
      • Build Image with Agent
    • Register & Update Device at Once
    • Organize Your Fleet
      • Create Project
      • Move Device between Projects
      • Create Groups
        • Add Device to Group
        • Add Many Devices to Group
        • Change Group Name
        • Delete Group
      • Tag Devices
        • Remove a Tag
      • Remove Many Devices
  • Devices
    • Fleet Overview
      • Filter Devices
      • Locate Devices
    • Device Details
      • Delete a Device
      • Block Updates with Update Trigger
    • Update Connect Agent
    • Delete Many Devices
  • Deployment
    • Create Update Flow
      • Actions
        • Run Command
        • Run Script
        • Deploy File
        • Deploy Docker
          • Use Docker Image
          • Use Docker Compose
          • Get Artifactory Parameters
        • Clone Git Repository
        • Download Artifact
          • Get Artifactory Path
        • Download Release Bundle
          • Get Artifactory Parameters for Release Bundle
        • Update Image
        • Install Debian Package
          • Get Artifactory Parameters for Debian
      • Use Update Parameters
      • On Failure & Rollback
      • Vulnerability Scans
      • Sample Use Case: Build Update Flow for Reuse
    • Deploy Software
      • Set Application & Version
      • Set Alert upon Failure
      • Set Phased Rollout
      • View Deployment Progress
        • Detailed Deployment Information
        • Abort a Deployment
      • Deploy in Groups
      • Sample Use Case: Deploy Docker Images to Devices
  • Tools
    • Remote Tools
      • Use Terminal
      • Open Port Tunnel Session
        • Access with VNC
        • Connect with SSH
        • Access Device Web Applications
      • Run Commands Remotely
        • Run Command as Non-Root User
      • Get Device Files (Fetch Files)
    • Alerts
      • Create Channel
      • Set Webhook
    • Monitor
      • Resource Monitor
      • Process Monitor
  • Releases
    • What's New?
    • Connect Agent Release Notes
  • Troubleshooting
    • Connect Server Status
    • Troubleshoot Topics
      • Device Registration
      • Terminal Troubleshooting
Powered by GitBook
On this page
  • Download Release Bundle Action
  • Prerequisites
  • Drag the Action
  • Configure the Action
  • Artifactory Edge
  • On Failure and Rollback
  • Revert all Files
  • Free Memory Requirement
  • What’s Next?

Was this helpful?

Export as PDF
  1. Deployment
  2. Create Update Flow
  3. Actions

Download Release Bundle

The Download Release Bundle action utilizes JFrog’s packaged release cycle to deploy your entire application to your edge devices.

PreviousGet Artifactory PathNextGet Artifactory Parameters for Release Bundle

Last updated 28 days ago

Was this helpful?

A groups together the contents that make up your release and provides the bill of materials for the release. For example, you can group together the different build artifacts, such as Docker images, that make up your release. The group of files can then be deployed as a single unit to your IoT devices.

A release bundle plays a central role in the distribution flow. It specifies the different files, packages, and metadata that comprise a release, and is created and managed in. Since all the files specified in a release bundle are required in order to keep the release coherent, a release bundle is immutable.

JFrog Connect supports Release Bundles v1 and v2.

Download Release Bundle Action

The Download Release Bundle action enables you to deploy a versioned package of software artifacts to your edge devices. In addition, a release bundle has the ability to deploy Docker images using the Docker Compose engine.

Prerequisites

  • Connect Agent 6.0 or later and at least one device registered.

  • A release bundle that is ready for deployment.

Drag the Action

To include the Download Release Bundle action in your update flow, do the following:

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

  2. Drag the Download Release Bundle 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.

  1. Enter a Name for your release bundle and the Version of the release bundle that you used in Artifactory.

When you deploy the Download Release Bundle update flow with a v2 release bundle, Connect will automatically use the release bundle name and version as the App name and version.

  1. Enter the Device Destination Path. This is where the release bundle will be installed on the edge devices. The directory on the device must exist beforehand, otherwise, the update will fail. Connect does not automatically create directories when deploying updates. You may create a folder using the Run Command action in the General Section.

  2. (Optional) If you have one or more files in your release bundle that need to go to different paths on the edge device, mark Release Bundle Artifact Path. Then specify the Release Bundle Path and the Device Destination Path for each file.

  1. (Optional) If your release bundle includes Docker images, mark Docker Compose, then specify the Release Bundle Path and the Device Destination Path for the Docker Compose YAML file.

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

  2. Save your action configuration.

Artifactory Edge

On Failure and Rollback

  • Continue Update Flow: If the Download Release Bundle action fails, Connect will simply continue with the next action block in the update workflow.

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

  • Do Action: The action to do when this action is rolled back. In this case, the action is to revert all files.

Revert all Files

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

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

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

What’s Next?

Enter your JFrog Registry in the dropdown box. If the registry does not appear in the list, go to to add yours to the list. Then return to this configuration and the added registry will appear in the list.

Tip: If you need help finding the Name and Version in Artifactory, see .

Tip: If you need help finding the Artifactory Path in Artifactory, see

If you want the action to pull content from an account, complete the procedure in , and then choose that registry as your JFrog Registry in Step 2 above.

For your policy, choose the actions for Connect to do in case the Download Release Bundle action fails.

Learn more about and find out how they might be useful for your Release Bundles workflow.

Add JFrog Registry
Get Artifactory Parameter for Release Bundle
Get Artifactory Path.
Artifactory Edge
Add JFrog Registry
On Failure
Update Parameters
release bundle
JFrog Distribution