Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 3 additions & 3 deletions 10/umbraco-deploy/getting-started/deploy-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,7 @@ In a similar way, Deploy can be configured to allow for backoffice transfers of

Please see the note above under _TransferFormsAsContent_ on the topic of removing any existing serialized files having changed this value to `true`.

### IgnoreMissingLanguagesForDictionaryItems
## IgnoreMissingLanguagesForDictionaryItems

When deploying dictionary items, an exception will be thrown if a translation is provided for a language that doesn't exist in the target environment.

Expand All @@ -201,7 +201,7 @@ If you have deleted languages that have already existing translations, you may w

When this is in place a translation for a language that doesn't exist in the target environment will be ignored. A warning message will be output to the log.

### SetEmptyDictionaryItemsOnTransfer
## SetEmptyDictionaryItemsOnTransfer

When deploying dictionary items, Umbraco Deploy follows the approach used for all content, emptying values that are transferred and set.

Expand Down Expand Up @@ -267,7 +267,7 @@ Some customers have reported intermittent issues related to Umbraco's memory cac

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.

### Deployment of culture & hostnames settings {#deployment-of-culture--hostnames-settings}
## Deployment of culture & hostnames settings {#deployment-of-culture--hostnames-settings}

Culture and hostname settings, defined per content item for culture invariant content, are not deployed between environments by default. They can be opted into via configuration.

Expand Down
7 changes: 7 additions & 0 deletions 10/umbraco-deploy/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,13 @@ 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 4 and 10 including all changes for these versions. For each major version, you can find the details about each release.

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

* Add `[DisableRequestSizeLimit]` attribute to `UploadForImport` endpoint to remove application request size limit (server/infrastructure restrictions may still apply)
* Fixed issue where content was not saved when transferring variant content with a release date
* Support flexible environments on Umbraco Cloud (remove requirement for environment types to be Development, Staging or Live)
* Update documentation links in management dashboard to include major version in the URL

#### [10.4.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F10.4.0) (March 19th 2024)

* All items from 10.4.0-rc1
Expand Down
14 changes: 7 additions & 7 deletions 13/umbraco-deploy/deployment-workflow/import-on-startup.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ internal sealed class DeployImportOnStartupComposer : IComposer
{
public void Compose(IUmbracoBuilder builder)
=> builder.DeployArtifactImportOnStartupProviders()
.Append<PhysicalDirectoryArtifactImportOnStartupProvider>();
.Append<PhysicalDirectoryArtifactImportOnStartupProvider>();

private sealed class PhysicalDirectoryArtifactImportOnStartupProvider : IArtifactImportOnStartupProvider
{
Expand All @@ -55,14 +55,14 @@ internal sealed class DeployImportOnStartupComposer : IComposer

_logger.LogInformation("Imported Umbraco content and/or schema import at startup from directory {FilePath} with status: {OperationStatus}.", _artifactsPath, attempt.Result);

return attempt;
}
if (attempt.Success)
{
Directory.Delete(_artifactsPath, true);

public Task OnImportCompletedAsync()
{
Directory.Delete(_artifactsPath, true);
_logger.LogInformation("Deleted physical directory after successful import on startup {FilePath}.", _artifactsPath);
}

return Task.CompletedTask;
return attempt;
}
}
}
Expand Down
4 changes: 2 additions & 2 deletions 13/umbraco-deploy/getting-started/deploy-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -294,7 +294,7 @@ To enable this, set the configuration value as appropriate for the types of doma

Combinations of settings can be applied, e.g. `Hostname,AbsolutePath`.

## Deployment of public access settings {#deployment-of-public-access-settings}
### Deployment of public access settings {#deployment-of-public-access-settings}

When deploying content items, public access rules based on member groups are transferred. You can amend this behavior using this setting.

Expand Down Expand Up @@ -322,7 +322,7 @@ 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

## Deployment of trashed content {#deployment-of-trashed-content}
### Deployment of trashed content {#deployment-of-trashed-content}

Specifies options for handling trashed content (documents, media and members) on export or import:

Expand Down
5 changes: 5 additions & 0 deletions 13/umbraco-deploy/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,11 @@ 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 13 including all changes for this version.

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

* Update documentation links in management dashboard to include major version in the URL
* Add `ValidateDependenciesOnImport` setting to management dashboard

#### [13.3.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.3.0) (November 21st 2024)

* All items from 13.3.0-rc1
Expand Down
14 changes: 7 additions & 7 deletions 14/umbraco-deploy/deployment-workflow/import-on-startup.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ internal sealed class DeployImportOnStartupComposer : IComposer
{
public void Compose(IUmbracoBuilder builder)
=> builder.DeployArtifactImportOnStartupProviders()
.Append<PhysicalDirectoryArtifactImportOnStartupProvider>();
.Append<PhysicalDirectoryArtifactImportOnStartupProvider>();

private sealed class PhysicalDirectoryArtifactImportOnStartupProvider : IArtifactImportOnStartupProvider
{
Expand All @@ -55,14 +55,14 @@ internal sealed class DeployImportOnStartupComposer : IComposer

_logger.LogInformation("Imported Umbraco content and/or schema import at startup from directory {FilePath} with status: {OperationStatus}.", _artifactsPath, attempt.Result);

return attempt;
}
if (attempt.Success)
{
Directory.Delete(_artifactsPath, true);

public Task OnImportCompletedAsync()
{
Directory.Delete(_artifactsPath, true);
_logger.LogInformation("Deleted physical directory after successful import on startup {FilePath}.", _artifactsPath);
}

return Task.CompletedTask;
return attempt;
}
}
}
Expand Down
7 changes: 3 additions & 4 deletions 14/umbraco-deploy/getting-started/deploy-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,6 @@ For illustration purposes, the following structure represents the full set of op
"SourceDeployBatchSize": null,
"PackageBatchSize": null,
"MaxRequestLength": null,

"IgnoreBrokenDependenciesBehavior": "Restore",
"AcceptInvalidCertificates": false,
"TransferFormsAsContent": true,
Expand Down Expand Up @@ -302,7 +301,7 @@ To enable this, set the configuration value as appropriate for the types of doma

Combinations of settings can be applied, e.g. `Hostname,AbsolutePath`.

## Deployment of public access settings {#deployment-of-public-access-settings}
### Deployment of public access settings {#deployment-of-public-access-settings}

When deploying content items, public access rules based on member groups are transferred. You can amend this behavior using this setting.

Expand Down Expand Up @@ -330,7 +329,7 @@ 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

## Deployment of trashed content {#deployment-of-trashed-content}
### Deployment of trashed content {#deployment-of-trashed-content}

Specifies options for handling trashed content (documents, media and members) on export or import:

Expand Down Expand Up @@ -389,7 +388,7 @@ In production this setting shouldn't be changed from it's default value of `fals

If attempting a one-off, large transfer operation, before a site is live, you could set this value to `true`. That would omit the firing and handling of these notifications and remove their performance overhead. Following which you would need to ensure to rebuild the cache and search index manually via the backoffice _Settings_ dashboards.

## ResolveUserInTargetEnvironment {#resolve-user-in-target-environment}
### ResolveUserInTargetEnvironment {#resolve-user-in-target-environment}

With this setting assigned a value of `true`, Umbraco Deploy will attempt to resolve users when transfers are made to new environments.

Expand Down
7 changes: 7 additions & 0 deletions 14/umbraco-deploy/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,13 @@ 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 14 including all changes for this version.

#### [14.2.1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.2.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)
* Disable import button when no file is selected

#### [14.2.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F14.2.0) (November 21st 2024)

* All items from 14.2.0-rc1
Expand Down
14 changes: 7 additions & 7 deletions 15/umbraco-deploy/deployment-workflow/import-on-startup.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ internal sealed class DeployImportOnStartupComposer : IComposer
{
public void Compose(IUmbracoBuilder builder)
=> builder.DeployArtifactImportOnStartupProviders()
.Append<PhysicalDirectoryArtifactImportOnStartupProvider>();
.Append<PhysicalDirectoryArtifactImportOnStartupProvider>();

private sealed class PhysicalDirectoryArtifactImportOnStartupProvider : IArtifactImportOnStartupProvider
{
Expand All @@ -55,14 +55,14 @@ internal sealed class DeployImportOnStartupComposer : IComposer

_logger.LogInformation("Imported Umbraco content and/or schema import at startup from directory {FilePath} with status: {OperationStatus}.", _artifactsPath, attempt.Result);

return attempt;
}
if (attempt.Success)
{
Directory.Delete(_artifactsPath, true);

public Task OnImportCompletedAsync()
{
Directory.Delete(_artifactsPath, true);
_logger.LogInformation("Deleted physical directory after successful import on startup {FilePath}.", _artifactsPath);
}

return Task.CompletedTask;
return attempt;
}
}
}
Expand Down
6 changes: 3 additions & 3 deletions 15/umbraco-deploy/getting-started/deploy-settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -301,7 +301,7 @@ To enable this, set the configuration value as appropriate for the types of doma

Combinations of settings can be applied, e.g. `Hostname,AbsolutePath`.

## Deployment of public access settings {#deployment-of-public-access-settings}
### Deployment of public access settings {#deployment-of-public-access-settings}

When deploying content items, public access rules based on member groups are transferred. You can amend this behavior using this setting.

Expand Down Expand Up @@ -329,7 +329,7 @@ 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

## Deployment of trashed content {#deployment-of-trashed-content}
### Deployment of trashed content {#deployment-of-trashed-content}

Specifies options for handling trashed content (documents, media and members) on export or import:

Expand Down Expand Up @@ -388,7 +388,7 @@ In production this setting shouldn't be changed from it's default value of `fals

If attempting a one-off, large transfer operation, before a site is live, you could set this value to `true`. That would omit the firing and handling of these notifications and remove their performance overhead. Following which you would need to ensure to rebuild the cache and search index manually via the backoffice _Settings_ dashboards.

## ResolveUserInTargetEnvironment {#resolve-user-in-target-environment}
### ResolveUserInTargetEnvironment {#resolve-user-in-target-environment}

With this setting assigned a value of `true`, Umbraco Deploy will attempt to resolve users when transfers are made to new environments.

Expand Down
8 changes: 8 additions & 0 deletions 15/umbraco-deploy/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,14 @@ 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.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
Expand Down