Building changelog for 3.9.0

[noissue]

Author: David Davis

CHANGES.rst

@@ -17,6 +17,143 @@ Changelog
 
 .. towncrier release notes start
 
+3.9.0 (2020-12-07)
+==================
+REST API
+--------
+
+Features
+~~~~~~~~
+
+- Made uploaded chunks to be stored as separate files in the default storage. This feature removes
+  the need for a share storage of pulp api nodes, as the chunks are now stored individually in the
+  shared storage and are therefore accessible by all nodes.
+  `#4498 <https://pulp.plan.io/issues/4498>`_
+- Add support for logging messages with a correlation id that can either be autogenerated or passed in
+  with a ``Correlation-ID`` header. This feature is provided as a tech preview in pulpcore 3.9.
+  `#4689 <https://pulp.plan.io/issues/4689>`_
+- Added progress reporting for pulp imports.
+  `#6559 <https://pulp.plan.io/issues/6559>`_
+- Exposed ``aiohttp.ClientTimeout`` fields in ``Remote`` as ``connect_timeout``,
+  ``sock_connect_timeout``, ``sock_read_timeout``, and ``total_timeout``.
+
+  This replaces the previous hard-coded 600 second timeout for sock_connect and sock_read,
+  giving per-``Remote`` control of all four ``ClientTimeout`` fields to the user.
+  `#7201 <https://pulp.plan.io/issues/7201>`_
+- Enabled users to add checksums to ALLOWED_CONTENT_CHECKSUMS by allowing them to populate checksums
+  with handle-artifact-checksums command.
+  `#7561 <https://pulp.plan.io/issues/7561>`_
+- Added version information to api docs.
+  `#7569 <https://pulp.plan.io/issues/7569>`_
+- Made signing services to be immutable. This requires content signers to create a new signing
+  service explicitly when a change occurs.
+  `#7701 <https://pulp.plan.io/issues/7701>`_
+- Added support for repairing Pulp by detecting and redownloading missing or corrupted artifact files. Sending a POST request to ``/pulp/api/v3/repair/`` will trigger a task that scans all artifacts for missing and corrupted files in Pulp storage, and will attempt to redownload them from the original remote. Specifying ``verify_checksums=False`` when POSTing to the same endpoint will skip checking the hashes of the files (corruption detection) and will instead just look for missing files.
+
+  The ``verify_checksums`` POST parameter was added to the existing "repository version repair" endpoint as well.
+  `#7755 <https://pulp.plan.io/issues/7755>`_
+- Added check to prevent Pulp to start if there are Artifacts with forbidden checksums.
+  `#7914 <https://pulp.plan.io/issues/7914>`_
+
+
+Bugfixes
+~~~~~~~~
+
+- Fixed a serious bug data integrity bug where some Artifact files could be silently deleted from storage in specific circumstances.
+  `#7676 <https://pulp.plan.io/issues/7676>`_
+- Moved the initial creation of access_policies to post_migrate signal.
+  This enforces their existance both with migrate and flush.
+  `#7710 <https://pulp.plan.io/issues/7710>`_
+- Fixed incremental export to happen if start_version provided, even if last_export is null.
+  `#7716 <https://pulp.plan.io/issues/7716>`_
+- Fixed a file descriptor leak during repository version repair operations.
+  `#7735 <https://pulp.plan.io/issues/7735>`_
+- Fixed bug where exporter directory existed and was writable but not owned by worker process and thus
+  not chmod-able.
+  `#7829 <https://pulp.plan.io/issues/7829>`_
+- Properly namespaced the `viewset_name` in `AccessPolicy` to avoid naming conflicts in plugins.
+  `#7845 <https://pulp.plan.io/issues/7845>`_
+- Update jquery version from 3.3.1 to 3.5.1 in API.html template. It is the version provided by djangorestframework~=3.12.2
+  `#7850 <https://pulp.plan.io/issues/7850>`_
+- Prevented a Redis failure scenario from causing the tasking system to back up due to "tasking system
+  locks" not being released, even on worker restart.
+  `#7907 <https://pulp.plan.io/issues/7907>`_
+- Use subclassed plugin downloaders during the pulp repair.
+  `#7909 <https://pulp.plan.io/issues/7909>`_
+
+
+Improved Documentation
+~~~~~~~~~~~~~~~~~~~~~~
+
+- Added requirement to record a demo with PRs of substantial change.
+  `#7703 <https://pulp.plan.io/issues/7703>`_
+- Removed outdated reference stating Pulp did not have an SELinux policy.
+  `#7793 <https://pulp.plan.io/issues/7793>`_
+
+
+Removals
+~~~~~~~~
+
+- The local file system directory used for uploaded chunks is specified by the setting
+  CHUNKED_UPLOAD_DIR. Users are encouraged to remove all uncommitted uploaded files before
+  applying this change.
+  `#4498 <https://pulp.plan.io/issues/4498>`_
+
+
+Misc
+~~~~
+
+- `#7690 <https://pulp.plan.io/issues/7690>`_, `#7753 <https://pulp.plan.io/issues/7753>`_, `#7902 <https://pulp.plan.io/issues/7902>`_
+
+
+Plugin API
+----------
+
+Features
+~~~~~~~~
+
+- Added pre_save hook to Artifact to enforce checksum rules implied by ALLOWED_CONTENT_CHECKSUMS.
+  `#7696 <https://pulp.plan.io/issues/7696>`_
+- Enabled plugin writers to retrieve a request object from a serializer when look ups are
+  performed from within the task serializer.
+  `#7718 <https://pulp.plan.io/issues/7718>`_
+- Expose ProgressReportSerializer through `pulpcore.plugin`
+  `#7759 <https://pulp.plan.io/issues/7759>`_
+- Allowed plugin writers to access the models Upload and UploadChunk
+  `#7833 <https://pulp.plan.io/issues/7833>`_
+- Exposed ``pulpcore.plugin.constants.ALL_KNOWN_CONTENT_CHECKSUMS``.
+  `#7897 <https://pulp.plan.io/issues/7897>`_
+- Added ``UnsupportedDigestValidationError`` to ``pulpcore.plugins.exceptions``. Going
+  forward, plugin authors can expect to find all unique exceptions under
+  ``pulpcore.plugin.exceptions``.
+  `#7908 <https://pulp.plan.io/issues/7908>`_
+
+
+Deprecations
+~~~~~~~~~~~~
+
+- Plugins are encouraged to define a ``version`` attribute on their subclass of
+  ``PulpPluginAppConfig``. If undefined while Pulp loads a warning is now shown to encourage plugin
+  writers to implement this attribute, which will be required starting in pulpcore==3.10.
+  `#6671 <https://pulp.plan.io/issues/6671>`_
+- Using the ViewSet's classname to identify its AccessPolicy has been deprecated and is slated for removal in 3.10.
+  Instead the urlpattern is supposed to be used.
+
+  Plugins with existing AccessPolicies should add a data migration to rename their AccessPolicies:
+
+  ::
+      access_policy = AccessPolicy.get(viewset_name="MyViewSet")
+      access_policy.viewset_name = "objectclass/myplugin/myclass"
+      access_policy.save()
+  `#7845 <https://pulp.plan.io/issues/7845>`_
+- The ``pulpcore.plugin.models.UnsupportedDigestValidationError`` is being deprecated and
+  will be removed in 3.10.
+
+  It can now be found at ``pulpcore.plugin.exceptions.UnsupportedDigestValidationError``
+  instead; please change any code that imports it to access it from its new location.
+  `#7908 <https://pulp.plan.io/issues/7908>`_
+
+
 3.8.1 (2020-10-30)
 ==================
 REST API