Install Debian Package

The Install Debian Package action enables you to install Debian packages onto your edge devices. The action block can be used within an update flow to automate the installation process.

This document describes how to configure the Install Debian Package action and integrate it into your update flows.

Prerequisites

• At least one device registered with JFrog Connect.

• A local Artifactory repository. Connect does not support remote repositories.

• One or more Debian packages ready for deployment, signed, and stored in your Artifactory repository. To sign the Debian package, see Sign Debian Metadata.

• If you are using JFrog as your registry, Artifactory Project and Artifactory Environment must be set to All in the JFrog Registry Scope.

• The repository that you choose must have a signed key. For more information about signing, see Manage Signing Keys.

Drag the Action

To include the Install Debian Package action in your update flow, do the following:

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

2. Drag the Install Debian Package action and drop it in the workflow.

Configure the Action

To configure the action, click on it and do the following:

1. Enter a name for the action.

2. Choose the Registry where your artifacts are stored. If the registry does not appear in the list, go to Add JFrog Registry to add yours to the list. Then return to this configuration and the added registry will appear in the list.

1. Complete the following information:

   • Repository Name: The name of the Artifactory repository containing the Debian package you want to install. The repository that you choose must have a signed key. For more information about signing, see Manage Signing Keys.

   • Install GPG Package: If you do not already have the GPG Package installed on your device, mark this checkbox to install it when you run the software deployment.

   • Distribution: The appropriate Debian distribution for your target devices (e.g., Debian Buster, Debian Bullseye, Ubuntu Noble, Ubuntu Jammy).

   • Component: The component (e.g., main, universe, contrib) from which to install the package.

1. Set as Persistent Repository: Mark this box to add the JFrog Repository to the device system's list of available sources. When unmarked, the JFrog Repository will be removed right after the package installation.

2. Packages: Enter the Name and Version of the package. If you leave Version blank, the latest version of the package will be installed. If you want to install more than one package, click Add (+). Add an additional row for each additional package.

1. Update Command Options: The apt or apt-get command will be run on the device according to the Linux version. You can add options to tailor the update command to your needs.

2. Fix Broken: Check this box to run the apt or apt-get command with the --fix-broken option. This can be useful for resolving dependency issues during package installation.

3. Install Command Options: The apt or apt-get command will be run on the device according to the Linux version. You can add options to tailor the install command to your needs. The -y option (equivalent to --yes or --assume-yes) is set automatically. You can use any of the options supported by the apt package installer.

4. Command (View Only): This section displays the final command that will be executed on the target device. The command is generated based on the configuration options you have provided. Review this command to ensure it is correct before deploying the update flow.

Configure On Failure Policy

1. Configure your On Failure policy and instructions for rolling back, should a rollback be necessary.

2. Save your action configuration.

What’s Next?

Learn how to configure your On Failure policy in the workflow.