Manage Bridges

📘

Subscription Information

This feature is supported with the Enterprise+ license.

A Bridge establishes a secure data link between a JPD in the SaaS cloud (the Bridge Server) and a Self-managed JPD (the Bridge Client). You define and manage Bridges in the JFrog Platform interface of these JPDs, or with API requests to the JPDs. The Bridge Server and Bridge Client each expose a different set of management tools.

To view and manage Bridges:

In JFrog Platform go to Administration > Topology > Bridges.

• On a SaaS JPD, the Bridge Server tab is active. The JPD is the Server for the Bridges in the table.

  In the In the Actions column, click ... and select one of the following:

  • Test Connection: The JPD attempts to connect to the Bridge Client.
  • Block/Unblock: The JPD terminates connections to the Bridge Client, and declines new connections. The Bridge is not removed. Unblock to accept new connections.

  To Add a JFrog Bridge click Generate Pairing Token to begin.

• On a Self-Hosted JPD, the Bridge Client tab is active. The JPD is the Client for the Bridges in the table.

  In the Actions column, click ... and select one of the following:

  • Edit: modify basic and Advanced Bridge Parameters.
  • Delete: permanently remove the Bridge.
  • Stop: Suspend the connection without removing the Bridge. Active TCP nodes and tunnels are terminated.
  • Restart: Restart the bridge connection. Active TCP nodes and tunnels are terminated, and new sessions are established after restart.

Click on a row to view additional status and performance information. For example, if a Bridge has the status Offline, click it to view troubleshooting information.

📘

Block/Unblock and Stop/Restart are independent actions

When you Block a bridge at the Bridge Server, the Bridge Client is not aware of the action. Similarly, when you Stop a bridge at the Bridge Client, the Bridge Server is not aware of the action. When you click on a Bridge that is offline, the troubleshooting information reflects the status observed by the Server or Client JPD you are in.

You can also use the Bridge REST APIs to create and manage Bridges.

For monitoring and troubleshooting, the Bridge service maintains standard JFrog service logs, and provides APIs for troubleshooting,.

📘

Bridges in YAML

Bridges that you define directly in system.yaml appear in the Bridges table of the JFrog Platform interface, but they cannot be managed using the Platform interface or the Bridge APIs. Use only the jFrog Platform interface or the Bridge APIs to create and manage Bridges.