diff --git a/13/umbraco-deploy/deploy-settings.md b/13/umbraco-deploy/deploy-settings.md index 24c59a820d4..529f9416a53 100644 --- a/13/umbraco-deploy/deploy-settings.md +++ b/13/umbraco-deploy/deploy-settings.md @@ -37,7 +37,6 @@ For illustration purposes, the following structure represents the full set of op "ApiKey": "", "ApiSecret": "", "Edition": "Default", - "DefaultTimeoutSeconds": 60, "ExcludedEntityTypes": [], "RelationTypes" : [], "ValueConnectors": [], @@ -60,13 +59,14 @@ For illustration purposes, the following structure represents the full set of op "ExportMemberGroups": true, "ReloadMemoryCacheFollowingDiskReadOperation": false, "AllowDomainsDeploymentOperations": "None", + "AllowWebhooksDeploymentOperations": "None", + "TrashedContentDeploymentOperations": "Import", "PreferLocalDbConnectionString": false, "MediaFileChecksumCalculationMethod": "PartialFileContents", "NumberOfSignaturesToUseAllRelationCache": 100, "ContinueOnMediaFilePathTooLongException": false, "SuppressCacheRefresherNotifications": false, - "HideConfigurationDetails": false, - "AllowWebhooksDeploymentOperations": "None" + "HideConfigurationDetails": false } } } @@ -98,7 +98,7 @@ However, we are aware that some customers prefer the option to use the backoffic This setting allows you to exclude a certain type of entity from being deployed. This is **not** recommended to set, but sometimes there may be issues with the way a custom media fileprovider works with your site and you will need to set it for media files. Here is an example: ```json -"ExcludedEntityTypes": ['media-file'], +"ExcludedEntityTypes": ["media-file"], ``` ### RelationTypes @@ -109,21 +109,6 @@ This setting allows you to manage how relations are deployed between environment * `Weak` - This causes the relation to be deployed if both content items are found on the target environment. * `Strong` - This requires the content item that is related is set as a dependency, so if anything is added as a relation it would also add it as a dependency. -```json -"RelationTypes": [ - { - "Alias": "relateParentDocumentOnDelete", - "Mode": "Weak", - }, - { - "Alias": "relateShopItemOnCreate", - "Mode": "Exclude", - } -], -``` - -As of Deploy 10.1.2 and 11.0.1, if this setting is left blank, the two relation types used for usage tracking are omitted. These are rebuilt by the CMS following a save of an item in the target environment and so don't need to be transferred. Unless you have specified otherwise, the effective default configuration is: - ```json "RelationTypes": { "relateParentDocumentOnDelete": "Weak", @@ -131,6 +116,8 @@ As of Deploy 10.1.2 and 11.0.1, if this setting is left blank, the two relation }, ``` +As of Deploy 10.1.2, 11.0.1 and higher, if this setting is left blank, the relation types used for usage tracking are omitted. These relations are rebuilt by the CMS following a save of an item in the target environment and so don't need to be transferred. + If a particular relation type is not listed, it's considered as a "weak" relation. ### ValueConnectors @@ -251,14 +238,14 @@ To configure the behavior you prefer, amend this value to either `None`, `Transf For example, using the following settings, you will have an installation that ignores broken dependencies when restoring from an upstream environment. It will however still prevent deployment and report any dependency issues when attempting a transfer to an upstream environment. ```json - "IgnoreBrokenDependenciesBehavior": "Restore", +"IgnoreBrokenDependenciesBehavior": "Restore", ``` When configuring for Deploy 9, an additional `IgnoreBrokenDependencies` setting existed that took a value of `true` or `false`. To achieve the same result as the example above, the following configuration was required: ```json - "IgnoreBrokenDependencies": true, - "IgnoreBrokenDependenciesBehavior": "Restore", +"IgnoreBrokenDependencies": true, +"IgnoreBrokenDependenciesBehavior": "Restore", ``` ### Memory cache reload @@ -266,7 +253,7 @@ When configuring for Deploy 9, an additional `IgnoreBrokenDependencies` setting Some customers have reported intermittent issues related to Umbraco's memory cache following deployments, which are resolved by a manual reload of the cache via the _Settings > Published Status > Caches_ dashboard. If you are running into such issues and are able to accommodate a cache clear after deployment, this workaround can be automated via the following setting: ```json - "ReloadMemoryCacheFollowingDiskReadOperation": true, +"ReloadMemoryCacheFollowingDiskReadOperation": true, ``` By upgrading to the most recent available version of the CMS major you are running, you'll be able to benefit from the latest bug fixes and optimizations in this area. That should be your first option if encountering cache related issues. Failing that, or if a CMS upgrade is not an option, then this workaround can be considered. @@ -276,14 +263,14 @@ By upgrading to the most recent available version of the CMS major you are runni Culture and hostname settings, defined per content item for culture invariant content, are not deployed between environments by default but can be opted into via configuration. ```json - "AllowDomainsDeploymentOperations": "None|Culture|AbsolutePath|Hostname|All", +"AllowDomainsDeploymentOperations": "None|Culture|AbsolutePath|Hostname|All", ``` To enable this, set the configuration value as appropriate for the types of domains you want to allow: -* _Culture_ - the language setting for the content, defined under "Culture" -* _AbsolutePath_ - values defined under "Domains" with an absolute path, e.g. "/en" -* _Hostname_ - values defined under "Domains" with a full host name, e.g. "en.mysite.com" +* `Culture` - the language setting for the content, defined under "Culture" +* `AbsolutePath` - values defined under "Domains" with an absolute path, e.g. "/en" +* `Hostname` - values defined under "Domains" with a full host name, e.g. "en.mysite.com" Combinations of settings can be applied, e.g. `Hostname,AbsolutePath`. @@ -292,13 +279,28 @@ Combinations of settings can be applied, e.g. `Hostname,AbsolutePath`. Webhooks may be considered environment specific or schema information that you would like to synchronize between environments. As such, by default, Umbraco Deploy does not include webhooks in schema deployment operations. ```json - "AllowWebhooksDeploymentOperations": "None|All", +"AllowWebhooksDeploymentOperations": "None|All", ``` If you would like you include them you can adjust this setting: -* _None_ - webhooks are not deployed and are expected to be managed independently in each environment. -* _All_ - webhooks included in schema deployments. +* `None` - webhooks are not deployed and are expected to be managed independently in each environment. +* `All` - webhooks included in schema deployments. + +## Deployment of trashed content + +Specifies options for handling trashed content (documents, media and members) on export or import: + +```json +"TrashedContentDeploymentOperations": "None|Export|Import|All" +``` + +You can amend this behavior using this setting: + +* `None` - trashed content will not be exported or imported +* `Export` - trashed content will be included in an export +* `Import` - trashed content will be processed and moved to the recycle bin on import +* `All` - trashed content will be included in an export, processed and moved to the recycle bin on import ### PreferLocalDbConnectionString @@ -309,13 +311,7 @@ For Umbraco 10, by default, a SQLite database is created. If you would prefer to use SQL Server LocalDb when it's available on your local machine, set this value to `true`. If LocalDB isn't reported as being available by Umbraco, it will fallback to using a SQLite database instead. ```json - "Umbraco": { - "Deploy": { - "Settings": { - "PreferLocalDbConnectionString": true - } - } - } +"PreferLocalDbConnectionString": true ``` ### MediaFileChecksumCalculationMethod @@ -358,7 +354,7 @@ If set to `true` the configuration details shown on the setting's dashboard will ### Webhook Events -Umbraco Deploy can optionally register events that you can use with Umbraco webhooks. You can add them via code, for which we provide an extension method. The following example shows how you can use this within a composer. +Umbraco Deploy can optionally register events that you can use with Umbraco webhooks. You can add them via code, for which we provide an extension method. The following example shows how you can use this within a composer. ```csharp using Umbraco.Cms.Core.Composing; @@ -366,7 +362,8 @@ using Umbraco.Deploy.Infrastructure.Extensions; public class RegisterDeployWebhooksComposer : IComposer { - public void Compose(IUmbracoBuilder builder) => builder.WebhookEvents().AddDeploy(deployBuilder => deployBuilder.AddTask()); + public void Compose(IUmbracoBuilder builder) + => builder.WebhookEvents().AddDeploy(deployBuilder => deployBuilder.AddTask()); } ``` diff --git a/13/umbraco-deploy/release-notes.md b/13/umbraco-deploy/release-notes.md index db8734aae79..71aeb82fed3 100644 --- a/13/umbraco-deploy/release-notes.md +++ b/13/umbraco-deploy/release-notes.md @@ -20,17 +20,41 @@ Under each major version, you can find details about minor and patch releases fo Version 13 -[**13.0.0-rc3**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) -(November 28th 2023) +[**13.0.1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.1) **(December 21th 2023)** + +* Fixes the display of the selected schedule date on queue for transfer. +* Fixes parsing property values within Nested Content and Block List that were previously saved by the Contrib value connectors. +* Fixed incorrectly including media files in export when 'Content files' wasn't selected. +* Add maximum file size validation to import file upload. + +[**13.0.0**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) **(December 14th 2023)** + +* All items from the 13.0.0 RCs and latest 12.2 features. + +[**13.0.0-rc5**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) **(December 12th 2023)** + +* Align with latest CMS RC. + +[**13.0.0-rc4**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) **(December 11th 2023)** + +* Add weight -100 to Deploy package migration (ensuring Deploy database tables are available before other package migrations are executed). +* Add fluent API for Deploy webhooks. + +[**13.0.0-rc3**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) **(November 29th 2023)** * Added optional deployment of webhooks as part of schema updates. * Added Deploy specific webhook events. -[**13.0.0-rc1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) -(November 6th 2023) +[**13.0.0-rc2**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) **(November 15th 2023)** -* Compatibility with Umbraco 13 +* Exclude automatic relation type aliases (used for reference tracking) from deployment. +* Fix cyclic dependency between configuring `DeploySettings` and `ConnectionStrings`. + +[**13.0.0-rc1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.0.0) **(November 6th 2023)** + +* Compatibility with Umbraco 13: * See full details of breaking changes under the [version specific upgrade guide](upgrades/version-specific.md). + * Update Richtext value connector to handle references in blocks. @@ -38,15 +62,29 @@ Under each major version, you can find details about minor and patch releases fo Version 12 -[**12.1.0**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.1.0) **(December 11th 2023)** +[**12.2.1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.2.1) **(December 21th 2023)** + +* Fixes the display of the selected schedule date on queue for transfer. +* Fixes parsing property values within Nested Content and Block List that were previously saved by the Contrib value connectors. +* Fixed incorrectly including media files in export when 'Content files' wasn't selected. +* Add maximum file size validation to import file upload. + +[**12.1.0**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.1.0) **(December 11th 2023)** * All items from 12.1.0-rc1. +* Fixed a regression in 12.1.0-rc1 where content restore/transfers didn't use the same JSON converters when deserializing Deploy artifacts. +* Fixed permissions not being correctly set for administrators on initial install. +* Moved permissions from the Content to a new Deploy category (only affecting the UI). +* Add support for migrating property values within Nested Content, Block List and Block Grid, and include Multi URL Picker value connector (an explicit value connector binding is used to override the ones provided in Deploy Contrib). +* Added new configuration option of `TrashedContentDeploymentOperations` to allow exporting/importing of trashed content, ensuring referenced content in the recycle bin isn't exported by default and otherwise imports back into the recycle bin. +* Changed the default value connector to use the property storage type, instead of using custom value prefixes to store the object type. -[**12.1.0-rc1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.1.0) **(November 27th 2023)** +[**12.1.0-rc1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.1.0) **(November 27th 2023)** * Added feature of [content import and export with migrations](./deployment-workflow/import-export.md). * Added a new configuration option of `ResolveUserInTargetEnvironment` to allow resolving of user accounts in target environments (see [Deploy Settings](./deploy-settings.md)). * Added a new configuration option of `AllowPublicAccessDeploymentOperations` to amend the behavior of public access rule transfer (see [Deploy Settings](./deploy-settings.md)). +* Improve performance of publishing multi-language content during restore/transfer and import. [**12.0.5**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F12.0.5) (**November 14th 2023**) @@ -188,15 +226,29 @@ Under each major version, you can find details about minor and patch releases fo Version 10 -[**10.3.0**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.3.0) **(December 11th 2023)** +[**10.3.1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.3.1) **(December 21th 2023)** + +* Fixes the display of the selected schedule date on queue for transfer. +* Fixes parsing property values within Nested Content and Block List that were previously saved by the Contrib value connectors. +* Fixed incorrectly including media files in export when 'Content files' wasn't selected. +* Add maximum file size validation to import file upload. + +[**10.3.0**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.3.0) **(December 11th 2023)** * All items from 10.3.0-rc1. +* Fixed a regression in 10.3.0-rc1 where content restore/transfers didn't use the same JSON converters when deserializing Deploy artifacts. +* Fixed permissions not being correctly set for administrators on initial install. +* Moved permissions from the Content to a new Deploy category (only affecting the UI). +* Add support for migrating property values within Nested Content, Block List and Block Grid, and include Multi URL Picker value connector (an explicit value connector binding is used to override the ones provided in Deploy Contrib). +* Added new configuration option of `TrashedContentDeploymentOperations` to allow exporting/importing of trashed content, ensuring referenced content in the recycle bin isn't exported by default and otherwise imports back into the recycle bin. +* Changed the default value connector to use the property storage type, instead of using custom value prefixes to store the object type. [**10.3.0-rc1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.3.0) **(November 27th 2023)** * Added feature of [content import and export with migrations](./deployment-workflow/import-export.md). * Added a new configuration option of `ResolveUserInTargetEnvironment` to allow resolving of user accounts in target environments (see [Deploy Settings](./deploy-settings.md)). * Added a new configuration option of `AllowPublicAccessDeploymentOperations` to amend the behavior of public access rule transfer (see [Deploy Settings](./deploy-settings.md)). +* Improve performance of publishing multi-language content during restore/transfer and import. [**10.2.7**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.2.7) (**November 14th 2023**) @@ -461,9 +513,22 @@ Under each major version, you can find details about minor and patch releases fo Version 4 +[**4.9.1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F4.9.1) **(December 21th 2023)** + +* Fixes the display of the selected schedule date on queue for transfer. +* Fixes parsing property values within Nested Content and Block List that were previously saved by the Contrib value connectors. +* Fixed incorrectly including media files in export when 'Content files' wasn't selected. +* Add maximum file size validation to import file upload. + [**4.9.0**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F4.9.0) **(December 11th 2023)** * All items from 4.9.0-rc1. +* Fixed a regression in 4.9.0-rc1 where content restore/transfers didn't use the same JSON converters when deserializing Deploy artifacts. +* Fixed permissions not being correctly set for administrators on initial install. +* Moved permissions from the Content to a new Deploy category (only affecting the UI). +* Add support for migrating property values within Nested Content and Block List, and include Multi URL Picker value connector (an explicit value connector binding is used to override the ones provided in Deploy Contrib). +* Added new configuration option of `TrashedContentDeploymentOperations` to allow exporting/importing of trashed content, ensuring referenced content in the recycle bin isn't exported by default and otherwise imports back into the recycle bin. +* Changed the default value connector to use the property storage type, instead of using custom value prefixes to store the object type. [**4.9.0-rc1**](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F4.9.0) **(November 27th 2023)**