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:
cloudsmith resync OWNER/REPO/UNIQUE_ID
For example:
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 Website UI
You can resync a package via the Website UI:
- 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 orange "Tool" button to the right of the package name, then click "Resync":
Resync via the Package Detail page
To resync a package via the package detail page, click the orange "Resync" button to the right of the package name:
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.
Bulk Package Resync
To resync more than one package in a repository, use the checkboxes beside the package names and then click the orange "resync package" button that appears at the top of the package list:
If you have selected a checkbox beside a package name, then package operations under the orange 'tool' button will be disabled as you are now in bulk operation mode.
Updated 2 months ago