Documentation
Book a demo

Package actions

Package resynchronization

What is package synchronization?

Synchronization is where we extract the metadata and files withing a package, process them and make the package available for download.

Why would I need to resynchronize?

You would usually try a resync if a package has failed, and you want to manually try again.
Resynchronization is, at its core, a retry mechanism. A resynchronization is equivalent to delete and add again for the same package.

Also, if we enhance support or add new functionality for a package format (e.g. better/improved metadata processing on a package), any packages of that format may require a resync.

Resync via Cloudsmith CLI

Identify a package

To resync a package using the Cloudsmith CLI, you first need to identify the package. See Package Identification for instructions to do this.

Resync a package

Once you have identified the package, you use the cloudsmith resync command to resync it:

shell
cloudsmith resync OWNER/REPO/UNIQUE_ID

For example:

shell
cloudsmith resync demo/examples-repo/7jvagMH9vk7u

In this example, we identified that the package we want to resync has the Unique ID "7jvagMH9vk7u" and is in the "examples-repo" repository:

Resync via Cloudsmith web app

You can resync a package via the Cloudsmith web app:

  • Via the repository packages list
  • Via the package detail page

Resync via repository packages list

To resync a package via the repository packages list, click the Action menu to the right of the package name, then select "Resynchronize":

Resync via the package detail page

To resync a package via the package detail page, click the Action menu to the right of the "Use Package" button and select "Resynchronize":

After clicking a "Resync" button, you will then be presented with a confirmation form. Click "Resync" again to confirm resynchronization of the package:

You will then get an on-screen message confirming that the package has been scheduled for resynchronization.