Upgrade an Organization integration from Classic Broker to Universal Broker
Migrating a single Organization
To upgrade existing Classic Broker integrations to Universal Broker for one Organization at a time:
Create the Universal Broker connection you want to use. For details, see Basic steps to install and configure Universal Broker.
Run the Universal Broker client. For details, see Running your Universal Broker client.
Use a test Organization to test the Universal Broker connection. Run
snyk-broker-config workflows connections integrate
and enter the test Organization ID, using the same credentials as were used for the Classic Broker connection. The objective is to have the same access as the Classic BrokerWhen you are ready, run
snyk-broker-config workflows connections migrate
.Select the deployment and connection you want to upgrade to.
Enter the Organization ID for the connection you want to upgrade to the Universal Broker.
Confirm your choice. When the command completes, the connection to the Organization has been upgraded.
Repeat the procedure for all the relevant connections integrated with each Organization.
When you have migrated all of the integrations to the Universal Broker client, delete or remove the Classic Broker container.
If you run into issues, you can roll back to the Classic Broker client as long as you have not terminated the Classic Broker client. To roll back:
Disconnect the Universal Broker connection that you migrated to previously.
IF any other Classic Broker Organization is left with the same Broker token, after you disconnect the Universal Broker token, use the API endpoint Clone an integration (with settings and credentials) to copy the integration settings from another Organization and reuse the previously used Classic Broker token through the API.
IF there is no Classic Broker Organization left with the old Broker token, then after you disconnect the Universal Broker connection, set up a new Classic Brokered connection. Copy the Broker token from the new Brokered connection as a parameter and restart the Broker container.
Migrating multiple Organizations
The bulk migration workflow allows you to migrate multiple Organizations at the same time. To do this:
Create a test connection and integrate it. See steps 1-3 from Migrating a single Organization.
Run
snyk-broker-config workflows bulk-migration list
to see a list of all the Organizations that can be migrated.Run
snyk-broker-config workflows bulk-migration apply
to migrate all the Organizations listed in the previous step. Select the deployment and connection you want to upgrade to and confirm your choice.
This command is asynchronous, which means migration happens in the background. If you are migrating several Organizations, the migration process can take some time to complete.
You can run snyk-broker-config workflows connections get
to list the connections and confirm they have been migrated.
Last updated
Was this helpful?