Manual upgrade of Umbraco Deploy
Learn how to manually upgrade the Umbraco Deploy version used on your Umbraco Cloud project.
Last updated
Learn how to manually upgrade the Umbraco Deploy version used on your Umbraco Cloud project.
Last updated
Deploy on Cloud will either be automatically upgraded with patch releases or it can be done through the portal when new minors are available.
In rare cases, Deploy might not be on the latest patch or minor and you will need to upgrade Deploy manually.
This article will give you a step-by-step on how to manually upgrade the deployment engine used on your Umbraco Cloud project.
When upgrading an Umbraco Cloud project manually, the very first step is to clone down your Cloud Development environment to your local machine.
Make sure you can run your Cloud project locally and restore content and media. It's important that you check that everything works once the upgrade has been applied and for this, you need to have a clone locally that resembles the Cloud environment as much as possible.
To get the latest version of Umbraco Deploy you will need to upgrade the site using NuGet. The main package to install is Umbraco.Deploy.Cloud. This has dependencies on other components of Umbraco Deploy that will be imported automatically.
If using Umbraco Forms in your installation, you should also update the Umbraco.Deploy.Forms package reference,
NuGet installs the latest version of the package when you use the dotnet add package command unless you specify a package version:
dotnet add package Umbraco.Deploy.Cloud --version <VERSION> dotnet add package Umbraco.Deploy.Forms --version <VERSION>
After you have added a package reference to your project by executing the commands above in the directory that contains your project file, run dotnet restore to install the packages.
You can also update the Umbraco Deploy through the NuGet Package Manager in Visual studio:
When the command completes, open the .csproj file to make sure the package reference was updated:
Make sure that everything works on the local clone and that you can run the project without any errors.
When you've upgraded everything locally, and made sure that everything runs without any errors, you are ready to deploy the upgrade to Umbraco Cloud.
Stage and commit all changes in Git
Push the changes to the Cloud environment
When everything is pushed, head on over to the Umbraco Cloud Portal
Make sure everything runs without errors before deploying to the next Cloud environment
Click the "Plug" Button (Open Connect Dialog):
Choose "Blob container or directory":
Choose "Anonymously" when prompted on how you will connect to the blob container.
