This article has not yet been verified against Umbraco 8.
The concepts and code examples might not work if you are running Umbraco 8.0 or a later version. If you are using Umbraco 7, this article is perfect for you!
You are more than welcome to report any issues found on the Documentation Issue Tracker.
Moving from Courier to Deploy
As of Umbraco 7.6, sites running on Umbraco Cloud will need to be running Umbraco Deploy, and not Umbraco Courier. Courier has been replaced by Deploy, and Deploy is highly specialized to be working on Umbraco Cloud.
In normal circumstances, the move from Courier to Deploy will happen automatically when you click the button in the portal for upgrading to Umbraco 7.6. If for some reason your Umbraco project was upgraded, but not switched to Deploy. i.e. if you did the upgrade manually.
This is a guide for moving from Courier to Deploy. First step is to acquire the latest Umbraco Deploy package and a valid Deploy Key from the support heroes. Use the in-app chat in the Umbraco Cloud portal to get this.
Prerequisites for using the guide is that you have a running site, that contains all metadata, like document types, data types and templates.
1 Removing Umbraco Courier
First you need to remove all Courier related files and folders.
Finally these 3rd party dlls has been part of Courier. If you are not using them in your custom code, you should ensure that they get deleted as well.
.courier files found in
/data/Revision needs to be deleted as well, as they will no longer be used. NOTE: Do not remove the
/data/Revision folder itself, only the contents inside the
/data/Revision folder - you will need this folder for Deploy as well.
2 Adding Umbraco Deploy
Adding Umbraco Deploy will be simple, all content from the package received, except
/config/UmbracoDeploy.config needs to be copied into the webroot.
Next you need to update the web.config to letting it know about Umbraco Deploy.
First add the following section to the
<sectionGroup name="umbraco.deploy"> <section name="environments" type="Umbraco.Deploy.Configuration.DeployEnvironmentsSection, Umbraco.Deploy" requirePermission="false"/> <section name="settings" type="Umbraco.Deploy.Configuration.DeploySettingsSection, Umbraco.Deploy" requirePermission="false"/> </sectionGroup>
Secondly add the
umbraco.deploy element to the web.config in
<umbraco.deploy> <environments configSource="config\UmbracoDeploy.config"/> <settings configSource="config\UmbracoDeploy.Settings.config"/> </umbraco.deploy>
By now Umbraco Deploy has been setup for the site, and what is still needed is to generate new metadata files. These are files called .courier previously, and in deploy they are named .uda files.
To generate the files, start the site in IIS, and open a command prompt in the
/data folder, here you need to create a marker file called
deploy-export. The file is generated by typing
echo > deploy-export. If you watch the folder, the file will change into a
deploy-process and finally a
deploy-success. You should notice that the
/data/Revision folder will be filled with .uda files.
Modify Workspace Dashboard
When using Umbraco Courier the entry in the
/Config/Dashboard.config should contain the following:
<section alias="UmbracoDeploy"> <areas> <area>content</area> </areas> <tab caption="Your workspace"> <control>/app_plugins/deploy/views/deploy.html</control> </tab> </section>
When switching to Umbraco Deploy this needs to be modified as the location to the deploy dashboard has changed. Make sure the entry looks like this:
<section alias="Deploy"> <areas> <area>content</area> </areas> <tab caption="Your workspace"> <control>/App_Plugins/Deploy/views/dashboards/dashboard.html</control> </tab> </section>
Setup Deploy Api Key
Final step is to setup a valid deploy key. You need to get this from Support as well. Once you have it, add it as an appsetting in the web.config file.
<add key="Umbraco.Deploy.ApiKey" value="[UniqueKey]" />
Everything is now ready to be committed to the site, and pushed.