Note
This feature requires Artifactory 7.104.2 or later and the Artifactory Federation Service must be installed.
The Federation Comparison tool is a validation mechanism for Federated repositories. Instead of actively synchronizing artifacts, this tool compares the state of a Federated repository with one or more remote members to detect missing artifacts in those remote members.
The Federation Comparison tool enables you to verify that all necessary artifacts are properly synced between Federation members, helping to identify any discrepancies due to event loss or system issues.
To use the tool, set the isDry query parameter in the Full Sync REST API to true, as shown below:
curl -X POST "https://<your-artifactory-instance>/api/federation/fullSync/testDryFullSyncRepo?mirror=https://mirror-instance/artifactory/my-repo&isDry=true" \
-H "Authorization: Bearer <your-token>" \
-H "Content-Type: application/json"The JSON report generated by the operation lists all the files that are present in the local member but missing from the remote members. The report is stored in the jfrog-full-sync-info system repository. The API response provides the path to the report.
Sample response:
{
"message": "Dry full sync completed successfully.",
"resultPaths": [
"jfrog-full-sync-info/comparison-results/testDryFullSyncRepo-mirror-comparison-2025-02-04.json"
]
}Sample report contents:
{
"results": [
{
"name": "testDryFullSyncFile_1.txt",
"type": "file",
"fullPath": "folder/testDryFullSyncFile_1.txt"
},
{
"name": "testDryFullSyncFile_2.txt",
"type": "file",
"fullPath": "folder/testDryFullSyncFile_2.txt"
}
]
}For complete details about the REST API, see Federated Repository Full Sync.