diff --git a/umbraco-cloud/troubleshooting/cloud-errors.md b/umbraco-cloud/troubleshooting/cloud-errors.md index d5c27b3177c..c23fc3a7b90 100644 --- a/umbraco-cloud/troubleshooting/cloud-errors.md +++ b/umbraco-cloud/troubleshooting/cloud-errors.md @@ -32,7 +32,7 @@ Each error code is accompanied by a clear description of the issue it represents ### Deployment Update and SiteExtension Errors -
| Error name | Description | Extended Explanation |
|---|---|---|
| DeploymentUpdateUnableToInitializeUpdateInSiteExtension | Some preflight checks failed from the Deployment Update service. | This error occurs when preflight checks from the Deployment update service fail, preventing the initialization of the update process. Retry the operation after verifying configurations and permissions. |
| DeploymentUpdateSourceSiteExtensionNotFound | We were unable to reach the source SiteExtension - either 404 or BadRequest. | This error occurs when the system cannot locate or access the source SiteExtension required for the deployment update process. Verify source SiteExtension settings and retry the deployment update. |
| DeploymentUpdateTargetSiteExtensionNotFound | We were unable to reach the target SiteExtension - either 404 or BadRequest. | This error occurs when the system cannot locate or access the target SiteExtension required for the deployment update process. Verify target SiteExtension settings and retry the deployment update. |
| DeploymentUpdateDeploymentTimedOut | We never got a completed or failed answer from the SiteExtension within our timeout. | This error occurs when the deployment update process does not receive a response (completed or failed) from the SiteExtension within the expected time frame. Adjust timeout settings and retry the deployment update. |
| DeploymentUpdateSiteExtensionCantConnectToRemoteRepository | SiteExtension preflight, can't reach the remote repository. | This error occurs when the SiteExtension encounters difficulties connecting to the remote repository during preflight checks. Verify network settings, repository permissions, or firewall configurations and retry the operation. |
| DeploymentUpdateSiteExtensionIsSourceBusy | SiteExtension preflight, the source is busy. | This error occurs when the SiteExtension detects that the source environment or repository is currently busy and unavailable for updates. Retry the operation later when the source environment is less busy. |
| DeploymentUpdateSiteExtensionIsTargetBusy | SiteExtension preflight, the target is busy. | This error occurs when the SiteExtension detects that the target environment or repository is currently busy and unavailable for updates. Retry the operation later when the target environment is less busy. |
| DeploymentUpdateSiteExtensionIsConfiguredForUmbracoDeploy | SiteExtension preflight, UmbracoDeploy API key not found or configured. | This error occurs during preflight checks when the SiteExtension is not properly configured with the necessary UmbracoDeploy API key. Verify and configure the API key correctly in the SiteExtension settings to resolve the issue. |
| DeploymentUpdateSiteExtensionGitPullFailed | Unable to do a Git pull, if it was required. | This error occurs when the SiteExtension fails to perform a Git pull operation as part of the deployment update process. Verify repository settings, permissions, or authentication and retry the operation. |
| DeploymentUpdateSiteExtensionGitPushFailed | This also hides a build error - it's the Kudu process that kicks in, so it's a combined Git push + Kudu deploy. | This error occurs when the Git push and subsequent Kudu deployment process fails during the deployment update. Review Kudu logs for detailed error messages and retry the operation. |
| DeploymentUpdateSiteExtensionExtractionFailed | Umbraco Deploy tried to extract changes but encountered a problem. Please review the CMS log files for detailed information. | This error occurs when Umbraco Deploy encounters difficulties while extracting changes during deployment updates. Review CMS log files for detailed error messages and take corrective actions as necessary. |
| DeploymentUpdateSiteExtensionExtractionTimedOut | Umbraco Deploy extraction timed out. | This error occurs when the Umbraco Deploy extraction process exceeds the expected time limit during the deployment update. Adjust timeout settings and retry the deployment update. |
| Error name | Description | Extended Explanation |
|---|---|---|
| DeploymentUpdateUnableToInitializeUpdateInSiteExtension | Some preflight checks failed from the Deployment Update service. | This error occurs when preflight checks from the Deployment update service fail, preventing the initialization of the update process. Retry the operation after verifying configurations and permissions. |
| DeploymentUpdateSourceSiteExtensionNotFound | We were unable to reach the source SiteExtension - either 404 or BadRequest. | This error occurs when the system cannot locate or access the source SiteExtension required for the deployment update process. Verify source SiteExtension settings and retry the deployment update. |
| DeploymentUpdateTargetSiteExtensionNotFound | We were unable to reach the target SiteExtension - either 404 or BadRequest. | This error occurs when the system cannot locate or access the target SiteExtension required for the deployment update process. Verify target SiteExtension settings and retry the deployment update. |
| DeploymentUpdateDeploymentTimedOut | We never got a completed or failed answer from the SiteExtension within our timeout. | This error occurs when the deployment update process does not receive a response (completed or failed) from the SiteExtension within the expected time frame. Adjust timeout settings and retry the deployment update. |
| DeploymentUpdateSiteExtensionCantConnectToRemoteRepository | SiteExtension preflight, can't reach the remote repository. | This error occurs when the SiteExtension encounters difficulties connecting to the remote repository during preflight checks. Verify network settings, repository permissions, or firewall configurations and retry the operation. |
| DeploymentUpdateSiteExtensionIsSourceBusy | SiteExtension preflight, the source is busy. | This error occurs when the SiteExtension detects that the source environment or repository is currently busy and unavailable for updates. Retry the operation later when the source environment is less busy. |
| DeploymentUpdateSiteExtensionIsTargetBusy | SiteExtension preflight, the target is busy. | This error occurs when the SiteExtension detects that the target environment or repository is currently busy and unavailable for updates. Retry the operation later when the target environment is less busy. |
| DeploymentUpdateSiteExtensionIsConfiguredForUmbracoDeploy | SiteExtension preflight, UmbracoDeploy API key not found or configured. | This error occurs during preflight checks when the SiteExtension is not properly configured with the necessary UmbracoDeploy API key. Verify and configure the API key correctly in the SiteExtension settings to resolve the issue. |
| DeploymentUpdateSiteExtensionGitPullFailed | Unable to do a Git pull, if it was required. | This error occurs when the SiteExtension fails to perform a Git pull operation as part of the deployment update process. Verify repository settings, permissions, or authentication and retry the operation. |
| DeploymentUpdateSiteExtensionGitPushFailed | This also hides a build error - it's the Kudu process that kicks in, so it's a combined Git push + Kudu deploy. | This error occurs when the Git push and subsequent Kudu deployment process fails during the deployment update. Review Kudu logs for detailed error messages and retry the operation. |
| DeploymentUpdateSiteExtensionExtractionFailed | Umbraco Deploy tried to extract changes but encountered a problem. Please review the CMS log files for detailed information. | This error occurs when Umbraco Deploy encounters difficulties while extracting changes during deployment updates. Review CMS log files for detailed error messages and take corrective actions as necessary. |
| DeploymentUpdateSiteExtensionExtractionTimedOut | Umbraco Deploy extraction timed out. | This error occurs when the Umbraco Deploy extraction process exceeds the expected time limit during the deployment update. Adjust timeout settings and retry the deployment update. |
| DeploymentUpdateSiteExtensionTargetUnavailable | The SiteExtension went down and was unable start up again. | This error occurs when the SiteExtension shuts itself down on the target environment and is unable start up again. Restart the target environment and retry the deployment. |