Manually run Extractions on your Cloud Environments
If you are running Deploy 4+, we recommend you run extractions from the Deploy Dashboard instead of KUDU. For more information, see the Deploy Dashboard article.
When you deploy from one environment to another on your Umbraco Cloud project, the files from the Git repository are merged into the files used on the site. The Deploy engine then runs an extraction. What this means is that the files on the disk will be deserialized into the database on the Cloud environment.
Run an extraction following these steps:
- Access Kudu.
- Navigate to CMD under the Debug console menu.
- In the file structure, navigate to
Revisionfolder containing all your projects UDA files
- deploy-marker indicating the state of the latest extraction (
deploy.logcontaining logs from the latest extraction
- While in this folder, type the following command in the CMD console:
echo > deploy- this will initiate an extraction on the environment
- While the extraction is running, the deploy-marker will change name to
- The extraction will end in one of two possible outcomes:
deploy-complete: The extraction succeeded and your environment is in good shape!
deploy-failed: The extraction failed - open the file, to see the error message (the same error message will be shown on your environment in the Umbraco Cloud Portal)
Sometimes you might encounter a deploy-marker called
deploy. This usually means that an extraction cannot run, and you need to restart your environment for the extraction to be able to run.
Sometimes you might also need to run this extraction locally. This can be done by following the above steps using CMD (command prompt) on your local machine, and navigating to the
/data folder in your local project folder.
Find general information about Kudu and how to access the tool in the Power tools article.