OTA Connect Developer Guide

Remove a software version

To remove a software version, you need to delete a target in the Targets metadata file. Target is a term from Uptane. Each Target corresponds to a software version available in your OTA Connect software repository.

Once you delete a target, you can no longer install it on devices.

To delete a target:

  1. Make sure you have the latest version of the garage-sign tool.

  2. Get the .zip file with your provisioning credentials.

    For instructions, see the related section in this guide.

  3. Initialize a local repository.

    garage-sign init \
      --repo <localreponame> \
      --credentials </path/to/credentials.zip>
  4. Pull the latest version of the targets.json file.

    garage-sign targets pull \
      --repo <localreponame>
  5. To delete the target, depending on the type of image, specify the target name and version in one of the following forms:

    • For OSTree images, <name>_<version>

    • For binary images, <name>-<version>

      garage-sign targets delete \
        --filename <name>-<version>
  6. Sign the new targets.json file with your Targets key.

    garage-sign targets sign \
      --repo <localreponame> \
      --key-name mytargets
  7. Push the new targets.json file to OTA Connect.

    garage-sign targets push \
      --repo <localreponame>

You can no longer see the deleted software version in your portal software repository.

To learn more about the garage-sign commands and options, see its reference documentation.