Software Update Process & Procedures

This page describes the major steps in updating your edge device software. Once you are set up with JFrog Connect, updating software on your devices becomes a simple and reliable process.

Prerequisites

To complete the update process described on this page, you will need the following:

• Your edge devices are registered in JFrog Connect as described in Register Devices at Scale.

• Docker and Docker Compose installed.

Process Overview

Connect has created a process for updating software in your devices that is simple and repeatable. The illustration below provides an overview of the process and the actors involved. The stages in the process are numbered to show the order of events, and each stage is described in detail. The example below is for the Deploy Docker Compose use case. Other deployment use cases will differ in some details.

Stages in Update Process

The stages described in detail below correspond to the stages indicated in the illustration.

1. Create Docker Images and Compose YAML File

You use Docker to create your container images. You will also use Docker Compose to create a compose.yaml file.

We recommend using Docker Compose, whether your device software requires one or multiple containers. With Docker Compose, you use a YAML file to configure your services. This enables you to easily manage the deployment of numerous microservices that may require numerous containers on the device. (Your specification in the YAML can include one or any number of Docker images to pull.)

2. Upload Docker Images and Compose YAML to Artifactory

You upload your container images and compose.yaml file to repositories in Artifactory. (You upload the compose.yaml file to a generic repository and the Docker image to a Docker registry.) For more information, see Docker Compose Best Practice.

Your Artifactory repositories will serve as your central point of truth for all of the binaries and artifacts that need to be included in a release. Files you keep here might include container images, software packages, installers, libraries, and configuration files. Over time you will accumulate additional versions of the binaries, and they will all be available to you in Artifactory.

3. Create Update Flow & Deployment

Build an Update Flow for Reuse

Using Connect, you create an Update Flow consisting of one or more actions. Use either Release Bundle or Deploy Docker as one of your actions. We recommend the following:

• Whether you use the Release Bundle or the Deploy Docker action block, choose Docker Compose in the configuration.

• Whether you deliver one or multiple containers, choose Docker Compose.

This will give you the consistency of using the same methodology and workflow all the time. For detailed procedures for building the Deploy Docker and Release Bundle actions, see Build an Update Flow.

We also recommend parameterizing any of the fields in the update flow that will likely be different from one deployment to the next. You will fill in the values when the deployment actually runs. This is another practice that enables reuse of the update flow.

Once you have created a good update flow, you can reuse it tens or hundreds of times for subsequent software deployments.

Create Deployment

After creating the update flow, you implement it by creating a Deployment. A deployment is an object that associates the update flow with a group of devices and defines the triggering for the update to take place.

When you create a deployment, you will be prompted to enter the values for the parameters you defined in the update flow. For example,

For a detailed example of building the deployment, see Deploy Software.

4. JFrog Connect Instructs Devices to pull Artifacts

By default, when you save the deployment or when Connect receives the Deploy Update API command, Connect instructs the device to request the update artifacts. However, you can also schedule a later time for the deployment to run. This is ideal for updating the software at times when usage is low or other risk factors are low.

5. Connect Agent pulls YAML from Artifactory

The Connect Agent in the device receives the Deployment and uses the path and filename of the Docker Compose YAML to pull the file from Artifactory.

6. Docker Compose pulls Images from Artifactory

The Docker Compose YAML file received in the device uses the filename(s) and path(s) of the Docker image(s) to pull one or multiple Docker images from Artifactory.

7. Compose Agent updates Images in Device

The Docker Compose in the device updates the Docker images on the device with the new ones it received from Artifactory.

Reuse the Update Flow

When you need to update the software again, you will repeat all the stages in the process above with one major exception: you will not need to create a new Update Flow. Once you have built a single, robust update workflow and run a successful deployment, you can use the same workflow to deliver:

• Later versions of the Docker images (i.e., in the new deployment, change the Artifactory path value for the Docker Compose YAML)

• Different Docker images containing different microservices (i.e., in the new deployment, use a different Docker Compose YAML and change the Artifactory path value to pull the new YAML)

• The same Docker images to different groups of devices (i.e., in the new deployment, change the Group(s) to which the updates are delivered)

What’s Next?

Learn how to Create an Update Flow that you will use over and over again.