This article addresses why a Release Bundle V2 (RB) distributed from a centralized source to an Edge node may not appear when the "Show Release Bundle V2" filter is enabled on the Edge node's Distribution → Received tab.
Symptom: When the "Show Release Bundle V2" toggle is ON, the list of received bundles appears empty, even though the bundle was successfully distributed. When the toggle is OFF, the bundle is visible alongside older V1 bundles.
Initial Screenshot from the Tab(In Edge node, Navigate to Distribution -> Received -> Enable the Show Release Bundle V2 option):-
If we disable, we see all RBV1 and RBV2:-
Why this occurs (Technical Explanation):
This behavior occurs because of a design choice related to backward compatibility in the distribution process:
-
Default Behavior: By default, the Distribution service converts the Release Bundle V2 payload into the V1 infrastructure format when sending it to the Edge node. This ensures compatibility with older Edge instances and systems.
-
Edge Node Interpretation: Because the payload arrives in the V1 format, the Edge node correctly identifies the bundle as a V1 bundle, and thus, it is hidden when the "Show Release Bundle V2" filter is applied.
Solution: Enabling Full V2 End-to-End Distribution
To ensure that the Release Bundle is recognized as a native V2 bundle on the Edge node, you must enable a specific configuration parameter on the Distribution server.
Configuratio Parameter:-
rbv2:
enable-all-the-way: true
Step-by-Step Implementation Guide
Follow these steps on the Distribution server to bootstrap the configuration change:
-
Locate Configuration Directory: Navigate to the Distribution service configuration directory:
cd /opt/jfrog/distribution/var/etc/distribution
-
Prepare Import File: Copy the latest configuration file to the import filename:
cp distribution.config.latest.yml distribution.config.import.yml
-
Add Configuration: Edit the distribution.config.import.yml file and add the rbv2 block with the parameter shown above.
-
Restart Distribution: Perform a full restart of the Distribution service to apply the new setting:
-
Once the Distribution is up, create a new RBV2 and distribute it to the edge node. Now, in the edge node, we will observe that once the toggle option is enabled, the RBV2 is displayed.
Screenshot from the Edge node:-
Note:
Please note that once a specific bundle was distributed via the v1 infrastructure, it will continue using this infrastructure for all next distributions for this bundle (version). Hence, once the flag is enabled, please create a new bundle and distribute it. The new RBV2 will be displayed under the Tab.
For more details on the Distribution configuration file, please refer to the following articles:-
-
How to Bootstrap Distribution Configuration
-
Distribution Configuration YAML File