Skip to content

Commit d177cdb

Browse files
authored
Merge pull request #7131 from ronaldbarendse/deploy/release-notes-20250602
Add Deploy 16 RC release notes and update version specific upgrade notes
2 parents 57716e1 + 65d2096 commit d177cdb

File tree

6 files changed

+20
-253
lines changed

6 files changed

+20
-253
lines changed

13/umbraco-deploy/test-the-release-candidate.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

14/umbraco-deploy/test-the-release-candidate.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

15/umbraco-deploy/test-the-release-candidate.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

16/umbraco-deploy/release-notes.md

Lines changed: 10 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -16,93 +16,26 @@ If you are upgrading to a new major version you can find the details about the b
1616

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

19-
### [15.1.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.1.0) (February 6th 2025)
19+
### [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)
2020

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

24-
### [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)
24+
### [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)
2525

26-
* Schema cleanup and item actions triggered from Deploy's management dashboard (create or delete UDA files and Umbraco items)
27-
* Allow ignoring dependencies in transfer/restore operations
28-
* Ignore `Dependencies` artifact property when calculating the checksum and fix schema comparison [#246](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/246)
29-
* Add 'Hide up to date' toggle to schema comparison [#245](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/245)
30-
* Fix parsing dictionary item root UDI range from node ID
31-
* Ensure work item references/action results are deallocated (reduces overall memory usage in Deploy)
32-
* Allow disabling warnings as errors on import
33-
* Schema deployment of user groups
34-
35-
### [15.0.2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.2) (December 23rd 2024)
36-
37-
* 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)
38-
* 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)
39-
40-
### [15.0.1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.1) (November 29th 2024)
41-
42-
* Update documentation links in management dashboard to include major version in the URL
43-
* Add `ValidateDependenciesOnImport` setting to management dashboard
44-
* Fix tree restore for custom entities [#241](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/241)
45-
* Fix import complete heading and description (was using export complete localization keys)
46-
* Disable import button when no file is selected
47-
48-
### [15.0.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F15.0.0) (November 14th 2024)
49-
50-
* Update CMS dependency to 15.0.0
51-
52-
### [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)
53-
54-
* Update CMS dependency to 15.0.0-rc4
55-
* Preview of features and bug fixes due in 13.3 and 14.2:
56-
* Import on startup
57-
* Added `ValidateDependenciesOnImport` setting to disable dependency validation on import
58-
* Support flexible environments on Umbraco Cloud (remove requirement for environment types to be Development, Staging or Live)
59-
60-
### [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)
61-
62-
* Update CMS dependency to 15.0.0-rc3
63-
64-
### [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)
65-
66-
* Update CMS dependency to 15.0.0-rc2
67-
* Preview of features and bug fixes due in 13.3 and 14.2:
68-
* Add option to include all schema in a workspace export
69-
* Add option to export from transfer queue
70-
* Fix `BlockValue` obsoleted properties (set GUID keys instead of UDIs and support block level variants)
71-
* Combine migrated grid editor with default Block Grid block configuration (set `RowMinSpan` and `RowMaxSpan` to `1` and `EditorSize` to `medium`)
72-
* Restructure keys and add new UI localizations
73-
74-
### [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)
75-
76-
* Compatibility with Umbraco 15
26+
* Compatibility with Umbraco 16.0.0-rc2
7727
* See full details of breaking changes under the [Version-specific Upgrade Guide](upgrades/version-specific.md)
78-
* Removed `AcceptInvalidCertificates` setting (configure `DeployHttpClient` typed client instead)
79-
* Removed `RemoteTreeNode` model (use `RemoteTreeEntity` instead) and `TryParseEntityIdFromNodeIdDelegate` (use `TryParseUdiRangeFromNodeIdDelegate` instead) in `DeployTransferRegisteredEntityTypeDetail`
80-
* Added `MigrateAsync(...)` method to `IPropertyTypeMigrator` and updated `PropertyTypeMigratorBase` and implementations to use async instead
8128

8229
## Umbraco.Deploy.Contrib
8330

84-
### [15.0.0](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0) (November 14th 2024)
85-
86-
* Update CMS and Deploy dependencies to 15.0.0
87-
88-
### [15.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc4) (November 13th 2024)
89-
90-
* Update CMS and Deploy dependencies to 15.0.0-rc4
91-
92-
### [15.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc3) (November 7th 2024)
93-
94-
* Update CMS and Deploy dependencies to 15.0.0-rc3
95-
96-
### [15.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-15.0.0-rc2) (October 24th 2024)
31+
### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc2) (May 30th 2025)
9732

98-
* Update CMS and Deploy dependencies to 15.0.0-rc2
33+
* Compatibility with Umbraco 16.0.0-rc3 and Deploy 16.0.0-rc2
9934

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

102-
* Compatibility with Umbraco 15 and Deploy 15
103-
* 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))
104-
* Removed `MediaPickerDataTypeArtifactMigrator`, as it is replaced with `ReplaceMediaPickerDataTypeArtifactMigrator` and `DefaultLegacyDataTypeConfigurationArtifactMigrator`
105-
* Removed `MultiNodeTreePickerDataTypeArtifactMigrator`, as it is replaced with `DefaultLegacyDataTypeConfigurationArtifactMigrator`
37+
* Compatibility with Umbraco 16.0.0-rc2 and Deploy 16.0.0-rc1
38+
* Update `TinyMCEv3DataTypeArtifactMigrator` to migrate legacy (v7) Umbraco.TinyMCEv3 to Umbraco.RichText with Tiptap UI editor
10639

10740
## Legacy release notes
10841

16/umbraco-deploy/test-the-release-candidate.md

Lines changed: 0 additions & 38 deletions
This file was deleted.

16/umbraco-deploy/upgrades/version-specific.md

Lines changed: 10 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -5,48 +5,34 @@ description: >-
55

66
# Version Specific Upgrade Details
77

8-
This article provides specific upgrade documentation for migrating to Umbraco Deploy version 15.
8+
This article provides specific upgrade documentation for migrating to Umbraco Deploy version 16.
99

1010
{% hint style="info" %}
1111
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.
1212
{% endhint %}
1313

1414
## Version Specific Upgrade Notes History
1515

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

1818
### Breaking changes
1919

20-
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:
20+
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:
2121

22-
#### Async methods
22+
#### Entity type registration
2323

24-
Asynchronous methods have been added to the following interfaces:
25-
- `IPropertyTypeMigrator`:
26-
- `MigrateAsync(...)`
24+
Entity type registration is simplified by removing client-side concerns from the server and aligning built-in and custom Umbraco CMS entities (like Forms and Commerce).
2725

28-
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.
26+
* `IDiskEntityService.RegisterDiskEntityType(...)` - This now only requires the entity type, removing the `name`, `isUmbracoEntity` and `installedUdisGetter` parameters.
27+
* `ITransferEntityService.RegisterTransferEntityType(...)` - This is also simplified, removing the `name`, `isUmbracoEntity`, `treeAlias`, `matchesRoutePath`, `matchesNodeId` and `entitiesGetter` parameters.
2928

30-
- `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()`);
31-
- All property type migrator implementations inheriting from the above base classes have been updated to use the asynchronous methods as well.
29+
The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type.
3230

33-
#### Removed `AcceptInvalidCertificates` setting
34-
35-
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).
36-
37-
Deploy uses a type of client to make HTTP requests between environments and this client can be configured to accept any certificate:
38-
39-
```csharp
40-
builder.Services.AddHttpClient<DeployHttpClient>().ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler
41-
{
42-
// 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)
43-
ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousAcceptAnyServerCertificateValidator
44-
});
45-
```
31+
The `isUmbracoEntity` flag was used in the schema comparison dashboard and for setting signatures to fetch entities differently from custom ones. Making `installedUdisGetter` and `entitiesGetter` mandatory could fetch these items, but this is already possible via service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`).
4632

4733
### Dependencies
4834

49-
* Umbraco CMS dependency was updated to `15.0.0`.
35+
* Umbraco CMS dependency was updated to `16.0.0`.
5036

5137
## Legacy version-specific upgrade notes
5238

0 commit comments

Comments
 (0)