Apply hotfix by manually moving files

    In this article, you'll find a step-by-step guide on how to apply a hotfix to a Live environment by manually moving the changed, updated and/or new files from one local clone to another.

    The following tools have been used to create this guide:

    • Visual Studio Code
    • GitKraken

    In GitKraken version 6.5.3, it is no longer possible to open private repositories with the free version - This affects all Umbraco Cloud repositories as well.

    The Scenario

    You have an Umbraco Cloud project with two environments, Development and Live.

    You have been working on building the site on a local clone of the Development environment, and now you want to send some but not all changes to the Live environment.

    Three commits have been pushed from your local clone to the Development environment. Out of these three commits, you only need the changes from one of the commits in the Live environment.


    Apply selected changes to the Live environment

    Here are the steps to follow in order to apply selected changes to the Live environment without deploying from Development to Live.

    For the sake of simplicity here's an explanation of the names I'll be using in this guide:

    • The cloned Development environment: Development repository
    • The cloned Live environment: Live repository

    Move the files

    1. Clone down the Live environment

      • The clone URL for the Live environment can be found in the Umbraco Cloud Portal:

        Live Clone URL

    2. Locate the files from the Development repository that you want to move to Live

      • Check the commits in the Git history for the Development repository to verify which files you need

        Files changes or added

      • The new files can be moved from the Development repository to the Live repository

      • The same goes for changed files. You can also edit the files, and only move the code snippets you need on the Live environment

    3. Copy and paste the new and/or updated files from your Development repository to your Live repository

    4. You can now Stage and Commit these changes to the Live repository in Git

    One of the benefits of having the Live environment cloned down, is that you can test the new changes locally before sending it to the Live environment.

    Test changes locally

    1. Run the Live repository through IIS
    2. Open CMD and navigate to the /data/revision folder in your Live repository
    3. Create a deploy marker by typing the following: echo > deploy - learn more about this command in the Power Tools articles
    4. The changes will now be reflected in the backoffice of your local Live environment

    Once you've checked that everything works locally, you are ready to push to the Live environment

    Push to Live

    1. Push the committed changes to the Live environment using Git
    2. Note that when changes are pushed directly to a Live environment and you have more than one environment, the changes are not automatically extracted to the site
    3. Find a guide on how to extract the files, in the Manual Extraction article

    You have now applied a hotfix to the Live environment.

    When you are done with development on your Development environment, follow the normal workflow of Cloud to deploy the changes to the Live environment. The hotfix, which now exists in both environments, should automatically be merged upon deployment.

    Important notes

    • Once you've applied the hotfix, we recommend that you delete the local clone of the Live environment. If you need to apply another hotfix at some point, clone the environment down again.
    • Make sure that the changes you push directly to your Live environment are also pushed to the Development environment. This will ensure that your environments are kept in sync.
    • This guide can also be used for applying a hotfix to a Staging environment.