Manual upgrade of Umbraco Deploy

Learn how to manually upgrade the Umbraco Deploy version used on your Umbraco Cloud project.

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.

Prepare for the upgrade

When upgrading an Umbraco Cloud project manually, the 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 is important that you check that everything works correctly after the upgrade. To achieve this, you need to have a clone locally that resembles the Cloud environment as much as possible.

Get the latest version of Umbraco

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.

1. Run the dotnet add package Umbraco.Deploy.Cloud command in the directory that contains your project files. If you want a specific package version, run these commands:

• dotnet add package Umbraco.Deploy.Cloud --version <VERSION>

• dotnet add package Umbraco.Deploy.Forms --version <VERSION>

1. Run dotnet restore to install the packages.

2. Open your .csproj file to make sure the package reference is updated:

<ItemGroup>
  <PackageReference Include="Umbraco.Deploy.Cloud" Version="9.0.1" />
  <PackageReference Include="Umbraco.Deploy.Forms" Version="9.0.1" />
</ItemGroup>

Alternatively, you can also update Umbraco Deploy via the NuGet Package Manager in Visual studio:

NuGet Package Manager

Make sure that everything works on the local clone and that you can run the project without any errors.

Manually Upgrade Umbraco Deploy Legacy Version 7 and 8

If you are on Umbraco 7 or Umbraco 8, follow these steps to manually upgrade Umbraco Deploy to a later version of your project

1. Download Storage Explorer here: https://azure.microsoft.com/en-us/products/storage/storage-explorer and install it.

2. Click the "Plug" Button (Open Connect Dialog):

3. Choose "Blob container or directory":

4. Choose "Anonymously" when prompted on how you will connect to the blob container.

5. Enter https://umbraconightlies.blob.core.windows.net/umbraco-deploy-release in the Blob container or directory URL.

1. You will then get a list of files available to download:

1. Download the latest version of Umbraco Deploy. Check Product Dependencies to be sure you download the correct version of Deploy.

2. Download the to your computer

3. Unzip the file on your computer

4. Copy/Paste the files from the unzipped folder to your local project folder You should not overwrite the following files:

       Config/UmbracoDeploy.config
       Config/UmbracoDeploy.Settings.config

5. Run the project locally - make sure it runs without any errors

6. Commit and deploy the changes to the Cloud environment

7. Again, make sure everything runs without errors before deploying to the next Cloud environment

Push upgrade to Cloud

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