title | description | ms.date | ms.topic | ms.reviewer |
---|---|---|---|---|
Blockchain app versioning - Azure Blockchain Workbench |
How to use application versions in Azure Blockchain Workbench Preview. |
02/18/2022 |
how-to |
brendal |
[!INCLUDE Retirement note]
You can create and use multiple versions of an Azure Blockchain Workbench Preview app. If multiple versions of the same application are uploaded, a version history is available and users can choose which version they want to use.
[!INCLUDE quickstarts-free-trial-note]
- A Blockchain Workbench deployment. For more information, see Azure Blockchain Workbench deployment for details on deployment
- A deployed blockchain application in Blockchain Workbench. See Create a blockchain application in Azure Blockchain Workbench
To add a new version, upload the new configuration and smart contract files to Blockchain Workbench.
-
In a web browser, navigate to the Blockchain Workbench web address. For example,
https://{workbench URL}.azurewebsites.net/
For information on how to find your Blockchain Workbench web address, see Blockchain Workbench Web URL -
Sign in as a Blockchain Workbench administrator.
-
Select the blockchain application you want to update with another version.
-
Select Add version. The Add version pane is displayed.
-
Choose the new version contract configuration and contract code files to upload. The configuration file is automatically validated. Fix any validation errors before you deploy the application.
-
Select Add version to add the new blockchain application version.
Deployment of the blockchain application can take a few minutes. When deployment is finished, refresh the application page. Choosing the application and selecting the Version history button, displays the version history of the application.
Important
Previous versions of the application are disabled. You can individually re-enable past versions.
You may need to re-add members to application roles if changes were made to the application roles in the new version.
By default, the latest enabled version of the application is used in Blockchain Workbench. If you want to use a previous version of an application, you need to choose the version from the application page first.
-
In Blockchain Workbench application section, select the application checkbox that contains the contract you want to use. If previous versions are enabled, the version history button is available.
-
Select the Version history button.
-
In the version history pane, choose the version of the application by selecting the link in the Date modified column.
You can create new contracts or take actions on previous version contracts. The version of the application is displayed following the application name and a warning is displayed about the older version.