Skip to main content

Resolve deployment failures on Umbraco Cloud caused by SSL issues or CPU constraints

Joana Knobbe avatar
Written by Joana Knobbe
Updated over 3 weeks ago

Resolving Deployment Failures on Umbraco Cloud: SSL and CPU Issues

Introduction

Deployment issues on Umbraco Cloud can stem from various causes, including SSL certificate problems during package restoration or resource constraints during deployment processes. This article outlines common symptoms, causes, and actionable solutions to prevent and resolve these failures effectively.

Common Deployment Issues and Their Solutions

1. SSL Certificate Problems During Package Restoration

Symptoms

When running package restore in Azure Pipelines, you might encounter the error: Unable to load the service index for source due to an SSL certificate validation failure.

Cause

This issue is often caused by:

  • A reference to a feed (e.g., nightly build or a custom NuGet feed) in the nuget.config file, which is either misconfigured or unnecessarily included.

  • Invalid or missing credentials for the feed.

Solution

  1. Review and locate unnecessary feed references in your nuget.config file.

  2. Remove any feeds that are not required for your project.

  3. Save the changes and push them to your repository.

  4. Redeploy using Azure Pipelines to verify that the issue is resolved.

This method has proven effective for resolving errors related to package restoration during deployments in Umbraco Cloud. For instance, removing an irrelevant feed reference corrected this error in a CMS deployment scenario.

2. Deployment Stalls or Failures Due to High CPU Usage

Symptoms

Deployments may fail or stall during staging or live migration due to:

  • High CPU utilization in your app service plan.

  • Excessive processing of a large number of files.

Cause

Excessive file processing can overwhelm the system, leading to resource exhaustion during deployment.

Solution

To reduce processing overhead and improve deployment efficiency:

  1. Open your .csproj file.

  2. Add the following property to disable compression during deployment:

    <PropertyGroup>
       <CompressionEnabled>false</CompressionEnabled>
   </PropertyGroup>

  3. Save and push the changes to your Cloud project.

  4. Deploy in the following order: 1) Development to staging. 2) Staging to live.

This adjustment decreases the number of files processed and ensures smoother deployments.

Preventative Measures

  • Regularly review and update project configuration files (nuget.config, .csproj) to ensure unused or unnecessary references are removed.

  • Monitor resource usage during deployments to identify and address system bottlenecks.

  • Test deployments in staging environments before pushing to live to catch potential failures early.

Conclusion

By addressing SSL certificate issues and optimizing system resource utilization, you can resolve common deployment failures on Umbraco Cloud. Implementing the solutions outlined above enables smoother and more reliable deployment processes for your applications. For more detailed assistance on related topics, please refer to Umbraco’s official support documentation.

Did this answer your question?