Advanced Setup: Deployment options

Here you will learn how to use the deployment options available with the v2 endpoints for CI/CD.

This provides control over the CI/CD deployment process within the isolated instance before your code is pushed to the Cloud environment.

Option: skipVersionCheck

During deployment, the system automatically checks for downgrades of Cloud dependencies. This prevents accidental downgrades of packages that may have been automatically upgraded on Umbraco Cloud.

Enabling skipVersionCheck will bypass that safeguard and allow deployments that include downgraded packages.

This option increases risk and is not recommended for normal workflows. Only enable it when you understand the package differences and accept the potential consequences.

Option: noBuildAndRestore

The Umbraco CI/CD flow runs the deployment in an isolated instance and performs dotnet restore and dotnet build to catch obvious build issues before deploying to Cloud. Enabling noBuildAndRestore skips the restore and build steps in that isolated instance, which can shorten deployment time by a few minutes.

Keep in mind the final Kudu deployment on the Cloud environment will still run restore, build, and publish; those steps cannot be skipped.

How to enable the options

All pipeline scripts generally follow the same structure, but there are a few small details to be aware of.

Azure DevOps Bash

Locate the main entry pipeline file. It will usually be this one: azure-release-pipeline.yaml.

  # Deploy to Umbraco Cloud
  # ####
  # you can edit the variables noBuildAndRestore and skipVersionCheck    
  # use booleans but as strings
  - stage: CloudDeploymentStage
    displayName: Deploy To Cloud
    dependsOn: cloudPrepareArtifact
    condition: in(dependencies.cloudPrepareArtifact.result, 'Succeeded')
    variables:
      artifactId: $[ stageDependencies.cloudPrepareArtifact.PrepareAndUploadArtifact.outputs['uploadArtifact.artifactId'] ]
    jobs: 
      - template: cloud-deployment.yml
        parameters:
          artifactId: $(artifactId)
          noBuildAndRestore: 'false'
          skipVersionCheck: 'false'

The fields: noBuildAndRestore and skipVersionCheck can be marked with a true.

Azure DevOps PowerShell

GitHub Actions Bash

GitHub Actions PowerShell