Skip to content

Conversation

@ronaldbarendse
Copy link
Contributor

@ronaldbarendse ronaldbarendse commented Jul 11, 2024

Description

Add release notes for Deploy 13.1.1 and 14.0.2.

Type of suggestion

  • Typo/grammar fix
  • Updated outdated content
  • New content
  • Updates related to a new version
  • Other

Product & version (if relevant)

Deploy 13.1.1 and 14.0.2.

Deadline (if relevant)

Thursday July 11th (the patches are already released to NuGet)


When Deploy transfers files between environments that can't connect to each other (like a local environment that isn't exposed publicly), it falls back from fetching/downloading the files to uploading them. This is done in fixed-sized chunks, so multiple files can be combined in a single request or a large file into multiple requests. This setting can specify the size of these chuncks **(in bytes)**.

If no value is set, Deploy will create 16MB chunks, unless the [CMS `MaxRequestLength` setting](../../umbraco-cms/reference/configuration/runtimesettings.md) is set to a lower value (note that the CMS setting is configured in kilobytes). Setting this to a value higher than the CMS `MaxRequestLength` (multiplied by 1024) will cause a validation error. Similarly, configuring a value that is higher than the [server or infrastructure allows](../../umbraco-cms/reference/configuration/maximumuploadsizesettings.md) will result in file transfers failing.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IIRC these relative links across "sites" within the documentation won't work, and instead you'll need to create an absolute HTML link to the published page on the docs site when linking to CMS documentation.

* `SourceDeployBatchSize` - applies a batch setting for the transfer of multiple selected items to an upstream environment (such as a media folder with many images).
* `PackageBatchSize` - applies a batch setting to the processing of a Deploy "package", which contains all the items selected for a Deploy operation, plus all the determined dependencies and relations.

### MaxRequestLength
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like you haven't added this to the 13 version of this page. Assuming it's still valid for that version, it should be added there too.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This setting is only introduced in v14 after refactoring the endpoints, so would require backporting first. Might be something to consider, although it's not been something users have requested or caused any issues in the past.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then leave it - that's fine. I just thought you'd missed documenting it.

@eshanrnh
Copy link
Contributor

Thanks, @ronaldbarendse for the PR 🙌 We will review it as soon as we can. 💪

Copy link
Contributor

@eshanrnh eshanrnh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've added some suggestions to shorten the sentences and fix the vale errors. Can you take a look and see that it doesn't change the sentence completely🙂

I'll incorporate the minor suggestions in the PR 💪

eshanrnh and others added 2 commits July 12, 2024 10:42
Co-authored-by: Esha Noronha <82437098+eshanrnh@users.noreply.github.com>
@eshanrnh
Copy link
Contributor

Looks like this PR is good to be merged in 🙌

@eshanrnh eshanrnh merged commit 018102c into umbraco:main Jul 12, 2024
@ronaldbarendse ronaldbarendse deleted the deploy/release-notes-13.1.1-14.0.2 branch July 13, 2024 08:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants