Comment on page
The Release Bundle action block utilizes JFrog’s packaged release cycle to deploy your entire application to your edge devices.
A release bundle 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 JFrog Distribution. Since all the files specified in a release bundle are required in order to keep the release coherent, a release bundle is immutable.
The release bundle action block 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.
Deployments using the release bundle action block overwrite the entirety of the files in the device folder. Therefore, a release bundle must include all of your released software, including all dependencies.
As release bundles are a complete version of your software release, it is important to follow the best practices described below in order to properly version your releases and keep control over your artifacts.
When a bundle is created in Artifactory, your files get signed and become immutable. Therefore, it is important to organize your software into versioned folders in your Artifactory repository.
The versioned structure is a user-created hierarchy of folder and sub-folders. The hierarchy you create should not not impact your application dependencies, as this is an Artifactory-only configuration. For example, an application that is stored inside the
app-filesrepository will be organized into version folders as follows:
Before creating the Release Bundle, create a folder under app-files that includes all of your applications and name it with a version that represents the entire application as a whole.
By using this structure, you may create a Release Bundle over your v2 application that makes the contents of the v1 folder immutable.
When a binary needs to be updated, you will create a new version folder, e.g., v2, to store the new files that will eventually be bound together as another Release Bundle.
The device will contain only the latest deployed version of the release bundle. Any previous versions are deleted upon deployment.
In order to ensure your application reliability on your edge devices, keep in mind the following when you deploy a release bundle:
This behavior allows the device to be unaware of the repository, version, and dependencies of your software. For example, when deploying
app-files/v1hierarchy will be removed and the application will be stored as follows:
By removing the previous versions together with the Repository and V1 folders, the device will always run the latest release bundle version without relying on a dependency such as the version folder name.
- JFrog Connect and JFrog Artifactory
- Connect Agent 6.0 or later and at least one device registered.
- A release bundle in Artifactory that is ready for deployment.
To include the Release Bundle action block in your update flow, do the following:
- 1.Go to Updates in the left sidebar and click Create Update Flow.
- 2.Drag the Deploy Files action block and drop it in the workflow.
Click the action block to open and configure it.
- 1.Enter a name for the action block.
- 2.Enter your JFrog account in the dropdown box. If your account name does not appear in the list, click Add Account to add yours to the list.
- 3.If you have one or more files in your release bundle that need to go to different paths on the edge device, mark Custom Paths. Then specify the Release Bundle Path and the Destination Path on Device for each file.
- 4.If your Release Bundle includes Docker images, mark Docker Compose, then specify the Release Bundle Path and the Destination Path on Device for the Docker Compose YAML file.
- 5.Enter the Destination Path on Device. 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 block in the General Section.
- 6.Configure your On Failure policy and instructions for rolling back, if necessary.
- 7.Save your action block configuration.
- Continue Update Flow: If the Git Repository action block fails, Connect will simply continue with the next action block in the update workflow.
- Run General Rollback: The action block and the entire update workflow are rolled back.
- Do Action: The action to do when this action block is rolled back. In this case, the action is to 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.
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