Skip to content

Add Deploy 16 RC release notes and update version specific upgrade notes #7131

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Jun 2, 2025
Merged

Add Deploy 16 RC release notes and update version specific upgrade notes #7131

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
5d575f6
Remove outdated/unused 'Test the Release Candidate' page
ronaldbarendse Jun 2, 2025
493a415
Add Deploy 16 RC release notes and update version specific upgrade notes
ronaldbarendse Jun 2, 2025
b2ddc14
Merge branch 'main' into deploy/release-notes-20250602
ronaldbarendse Jun 2, 2025
9b30bdd
Update 16/umbraco-deploy/upgrades/version-specific.md
eshanrnh Jun 2, 2025
ae3953a
Update 16/umbraco-deploy/upgrades/version-specific.md
eshanrnh Jun 2, 2025
65d2096
Update 16/umbraco-deploy/upgrades/version-specific.md
eshanrnh Jun 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 0 additions & 38 deletions 13/umbraco-deploy/test-the-release-candidate.md
View file
Open in desktop

This file was deleted.

38 changes: 0 additions & 38 deletions 14/umbraco-deploy/test-the-release-candidate.md
View file
Open in desktop

This file was deleted.

38 changes: 0 additions & 38 deletions 15/umbraco-deploy/test-the-release-candidate.md
View file
Open in desktop

This file was deleted.

87 changes: 10 additions & 77 deletions 16/umbraco-deploy/release-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,93 +16,26 @@ If you are upgrading to a new major version you can find the details about the b

This section contains the release notes for Umbraco Deploy 15 including all changes for this version.

### [15.1.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.1.0) (February 6th 2025)
### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 30th 2025)

* All items from 15.1.0-rc1
* Add user groups to schema comparison
* Compatibility with Umbraco 16.0.0-rc3
* Rename/add `CancellationToken` parameters and add `ConfigureAwait(false)` to awaits

### [15.1.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.1.0) (January 30th 2025)
### [16.0.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 16th 2025)

* Schema cleanup and item actions triggered from Deploy's management dashboard (create or delete UDA files and Umbraco items)
* Allow ignoring dependencies in transfer/restore operations
* Ignore `Dependencies` artifact property when calculating the checksum and fix schema comparison [#246](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/246)
* Add 'Hide up to date' toggle to schema comparison [#245](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/245)
* Fix parsing dictionary item root UDI range from node ID
* Ensure work item references/action results are deallocated (reduces overall memory usage in Deploy)
* Allow disabling warnings as errors on import
* Schema deployment of user groups

### [15.0.2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.2) (December 23rd 2024)

* Ensure environment-to-environment actions are executed asynchronously on background job (fixes timeout issues on large deployments) [#179](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/179)
* Only require default, allowed and master templates and their associated files to exist (avoids schema mismatches on template changes) [156](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/156)

### [15.0.1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.1) (November 29th 2024)

* Update documentation links in management dashboard to include major version in the URL
* Add `ValidateDependenciesOnImport` setting to management dashboard
* Fix tree restore for custom entities [#241](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/241)
* Fix import complete heading and description (was using export complete localization keys)
* Disable import button when no file is selected

### [15.0.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) (November 14th 2024)

* Update CMS dependency to 15.0.0

### [15.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) (November 13th 2024)

* Update CMS dependency to 15.0.0-rc4
* Preview of features and bug fixes due in 13.3 and 14.2:
* Import on startup
* Added `ValidateDependenciesOnImport` setting to disable dependency validation on import
* Support flexible environments on Umbraco Cloud (remove requirement for environment types to be Development, Staging or Live)

### [15.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) (November 7th 2024)

* Update CMS dependency to 15.0.0-rc3

### [15.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) (October 24th 2024)

* Update CMS dependency to 15.0.0-rc2
* Preview of features and bug fixes due in 13.3 and 14.2:
* Add option to include all schema in a workspace export
* Add option to export from transfer queue
* Fix `BlockValue` obsoleted properties (set GUID keys instead of UDIs and support block level variants)
* Combine migrated grid editor with default Block Grid block configuration (set `RowMinSpan` and `RowMaxSpan` to `1` and `EditorSize` to `medium`)
* Restructure keys and add new UI localizations

### [15.0.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) (October 11th 2024)

* Compatibility with Umbraco 15
* Compatibility with Umbraco 16.0.0-rc2
* See full details of breaking changes under the [Version-specific Upgrade Guide](upgrades/version-specific.md)
* Removed `AcceptInvalidCertificates` setting (configure `DeployHttpClient` typed client instead)
* Removed `RemoteTreeNode` model (use `RemoteTreeEntity` instead) and `TryParseEntityIdFromNodeIdDelegate` (use `TryParseUdiRangeFromNodeIdDelegate` instead) in `DeployTransferRegisteredEntityTypeDetail`
* Added `MigrateAsync(...)` method to `IPropertyTypeMigrator` and updated `PropertyTypeMigratorBase` and implementations to use async instead

## Umbraco.Deploy.Contrib

### [15.0.0](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0) (November 14th 2024)

* Update CMS and Deploy dependencies to 15.0.0

### [15.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc4) (November 13th 2024)

* Update CMS and Deploy dependencies to 15.0.0-rc4

### [15.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc3) (November 7th 2024)

* Update CMS and Deploy dependencies to 15.0.0-rc3

### [15.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc2) (October 24th 2024)
### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc2) (May 30th 2025)

* Update CMS and Deploy dependencies to 15.0.0-rc2
* Compatibility with Umbraco 16.0.0-rc3 and Deploy 16.0.0-rc2

### [15.0.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc1) (October 14th 2024)
### [16.0.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc1) (May 20th 2025)

* Compatibility with Umbraco 15 and Deploy 15
* Removed obsolete (and unused) legacy `PrevaluePropertyValueArtifactMigratorBase`, `CheckBoxListPropertyValueArtifactMigrator` `DropDownListFlexiblePropertyValueArtifactMigrator` and `RadioButtonListPropertyValueArtifactMigrator` migrators, as they are replaced with `PrevalueArtifactMigrator` and property type migrators that support nested/recursive properties (see PR [#71](https://github.com/umbraco/Umbraco.Deploy.Contrib/pull/71))
* Removed `MediaPickerDataTypeArtifactMigrator`, as it is replaced with `ReplaceMediaPickerDataTypeArtifactMigrator` and `DefaultLegacyDataTypeConfigurationArtifactMigrator`
* Removed `MultiNodeTreePickerDataTypeArtifactMigrator`, as it is replaced with `DefaultLegacyDataTypeConfigurationArtifactMigrator`
* Compatibility with Umbraco 16.0.0-rc2 and Deploy 16.0.0-rc1
* Update `TinyMCEv3DataTypeArtifactMigrator` to migrate legacy (v7) Umbraco.TinyMCEv3 to Umbraco.RichText with Tiptap UI editor

## Legacy release notes

Expand Down
38 changes: 0 additions & 38 deletions 16/umbraco-deploy/test-the-release-candidate.md
View file
Open in desktop

This file was deleted.

34 changes: 10 additions & 24 deletions 16/umbraco-deploy/upgrades/version-specific.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,48 +5,34 @@

# Version Specific Upgrade Details

This article provides specific upgrade documentation for migrating to Umbraco Deploy version 15.
This article provides specific upgrade documentation for migrating to Umbraco Deploy version 16.

{% hint style="info" %}
If you are upgrading to a minor or patch version, you can find the details about the changes in the [Release Notes](../release-notes.md) article.
{% endhint %}

## Version Specific Upgrade Notes History

Version 15 of Umbraco Deploy has a minimum dependency on Umbraco CMS core of `15.0.0`. It runs on .NET 9.
Version 16 of Umbraco Deploy has a minimum dependency on Umbraco CMS core of `16.0.0`. It runs on .NET 9.

### Breaking changes

Version 15 contains breaking changes. The breaking changes appear in areas related to extending Deploy to support additional entities and property editors. For reference though, the full details are listed here:
Version 16 contains breaking changes. The breaking changes appear in areas related to extending Deploy to support additional entities. For reference though, the full details are listed here:

#### Async methods
#### Entity type registration

Asynchronous methods have been added to the following interfaces:
- `IPropertyTypeMigrator`:
- `MigrateAsync(...)`
The entity type registration has been simplified, removing client-side concerns from the server-side and align behavior between built-in Umbraco CMS entities and custom ones (like Forms and Commerce).

Check warning on line 24 in 16/umbraco-deploy/upgrades/version-specific.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).

Raw Output:
{"message": "[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).", "location": {"path": "16/umbraco-deploy/upgrades/version-specific.md", "range": {"start": {"line": 24, "column": 1}}}, "severity": "WARNING"}

These methods all have a default implementation that forwards the calls to the synchronous methods (to maintain backwards compatibility). The synchronous methods have been obsoleted and Deploy will now always call the new asynchronous methods. Implementations should be updated to start using those instead.
* `IDiskEntityService.RegisterDiskEntityType(...)` - This now only requires the entity type, removing the `name`, `isUmbracoEntity` and `installedUdisGetter` parameters.
* `ITransferEntityService.RegisterTransferEntityType(...)` - This is also simplified, removing the `name`, `isUmbracoEntity`, `treeAlias`, `matchesRoutePath`, `matchesNodeId` and `entitiesGetter` parameters.

- `PropertyTypeMigratorBase` and `GridPropertyTypeMigratorBase`: the synchronous `Migrate(...)` method is obsoleted and causes a compiler error when directly invoked (to avoid potential deadlocks, because it forwards to the asynchronous method using `GetAwaiter().GetResult()`);
- All property type migrator implementations inheriting from the above base classes have been updated to use the asynchronous methods as well.
The name was only used in the backoffice (as friendly entity type name, e.g. to group items in the transfer queue and the schema comparison dashboard), so this is now using localizations (using `deploy_entityTypes_{entityType}` or `general_{entityType}`, falling back to the plain entity type).

Check warning on line 29 in 16/umbraco-deploy/upgrades/version-specific.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.Terms] We prefer 'for example' over 'e.g. .'

Raw Output:
{"message": "[UmbracoDocs.Terms] We prefer 'for example' over 'e.g. .'", "location": {"path": "16/umbraco-deploy/upgrades/version-specific.md", "range": {"start": {"line": 29, "column": 73}}}, "severity": "WARNING"}

Check warning on line 29 in 16/umbraco-deploy/upgrades/version-specific.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).

Raw Output:
{"message": "[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).", "location": {"path": "16/umbraco-deploy/upgrades/version-specific.md", "range": {"start": {"line": 29, "column": 1}}}, "severity": "WARNING"}

#### Removed `AcceptInvalidCertificates` setting

The `AcceptInvalidCertificates` setting previously configured the `ServicePointManager` to accept all certificates. However, this class is [obsoleted in .NET 9 and no longer affects `HttpClient`](https://learn.microsoft.com/en-us/dotnet/api/system.net.servicepointmanager?view=net-9.0).

Deploy uses a type of client to make HTTP requests between environments and this client can be configured to accept any certificate:

```csharp
builder.Services.AddHttpClient<DeployHttpClient>().ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler
{
// Only use this for testing purposes or if you have other security in place (e.g. only allow environments to connect over an internal network)
ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
});
```
The `isUmbracoEntity` flag was used in the schema comparison dashboard and when setting signatures to get all entities in a different way compared to custom entities. Although we could make the `installedUdisGetter` and `entitiesGetter` parameters mandatory and use those to fetch the required items, this is already possible using the service connectors (using `IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`).

Check warning on line 31 in 16/umbraco-deploy/upgrades/version-specific.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).

Raw Output:
{"message": "[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).", "location": {"path": "16/umbraco-deploy/upgrades/version-specific.md", "range": {"start": {"line": 31, "column": 168}}}, "severity": "WARNING"}

### Dependencies

* Umbraco CMS dependency was updated to `15.0.0`.
* Umbraco CMS dependency was updated to `16.0.0`.

## Legacy version-specific upgrade notes

Expand Down
Loading