DOCS-1190: RELEASE.2024-04-18T19-09-19Z (#1215)

Partially addresses #1190 

No staged build unless someone requests it.

# Summary

After some thinking, we've leaned towards just making a note of the
upgrade step and calling it done. We do not typically make extended
discussion of backward-breaking changes at this time, and have no where
to keep that sort of guidance.

Maybe in the future or as part of a larger re-arch we can consider where
we would best keep that kind of guidance.

As far as the rest:

- We are not covering s3zip today, so that's a no-op. We should leave
the ticket open in the event we have bandwidth to document the feature
later
- No changes to Console that need documentation at this time
- Added a quick callout on the warning behavior to the Versioning page
- Metrics v3 is also still In progress, come back to this once the
project is fully baked.

source/administration/object-management/object-versioning.rst

@@ -132,6 +132,10 @@ following commands:
 - :mc-cmd:`mc rm --versions --older-than <mc rm --older-than>` -
    Removes all versions of an object older than the specified calendar date.
 
+.. versionadded:: RELEASE.2024-04-18T19-09-19Z
+
+   MinIO emits a warning if the cumulative size of versions for any single object exceeds 1TiB.
+
 .. _minio-bucket-versioning-id:
 
 Version ID Generation

source/default-conf.py

@@ -61,7 +61,7 @@ extlinks = {
     's3-docs'         : ('https://docs.aws.amazon.com/AmazonS3/latest/userguide/%s', None),
     's3-api'          : ('https://docs.aws.amazon.com/AmazonS3/latest/API/%s', None),
     'iam-docs'        : ('https://docs.aws.amazon.com/IAM/latest/UserGuide/%s', None),
-    'minio-release'   : ('https://github.com/minio/minio/releases/tag/%s', None),
+    'minio-release'   : ('https://github.com/minio/minio/releases/tag/%s', '%s'),
     'mc-release'      : ('https://github.com/minio/mc/releases/tag/%s', None),
     'prometheus-docs' : ('https://prometheus.io/docs/%s', None),
     'podman-docs'     : ('https://docs.podman.io/en/latest/%s', None),

source/includes/linux/common-installation.rst

@@ -198,7 +198,7 @@ operating systems using RPM, DEB, or binary:
 
          wget https://dl.min.io/server/minio/release/linux-amd64/minio
          chmod +x minio
-         sudo mv minio /usr/local/bin/
+         sudo mv -f ./minio /usr/local/bin/minio
 
       Replace ``/usr/local/bin`` with the location of the existing MinIO
       binary. Run ``which minio`` to identify the path if not already known.

source/includes/linux/steps-upgrade-minio-deployment.rst

@@ -63,17 +63,20 @@ Update ``systemctl``-Managed MinIO Deployments
 
 Use these steps to upgrade a MinIO deployment where the MinIO server process is managed by ``systemctl``, such as those created using the MinIO :ref:`DEB/RPM packages <deploy-minio-distributed-baremetal>`.
 
+This procedure assumes you have the :envvar:`MINIO_CONFIG_ENV_FILE` variable set on all MinIO nodes.
+
 1. Update the MinIO Binary on Each Node
 
    .. include:: /includes/linux/common-installation.rst
       :start-after: start-upgrade-minio-binary-desc
       :end-before: end-upgrade-minio-binary-desc
 
+   Run ``minio --version`` on each node to validate that you successfully upgraded all binaries to the same version.
+   Do **not** proceed unless all nodes use the same MinIO binary version.
+
 2. Restart the Deployment
 
    Run the :mc-cmd:`mc admin service restart` command to restart all MinIO server processes in the deployment simultaneously.
-   
-   The restart process typically completes within a few seconds and is *non-disruptive* to ongoing operations.
 
    .. code-block:: shell
       :class: copyable
@@ -82,6 +85,8 @@ Use these steps to upgrade a MinIO deployment where the MinIO server process is
 
    Replace :ref:`alias <alias>` of the MinIO deployment to restart.
 
+   S3-compatible SDKs and applications should retry operations automatically, such that the restart process is typically *non-disruptive* to ongoing operations.
+
 3. Validate the Upgrade
 
    Use the :mc:`mc admin info` command to check that all MinIO servers are online, operational, and reflect the installed MinIO version.
@@ -150,7 +155,7 @@ The command overwrites the existing ``minio`` binary at that path.
 
    wget https://dl.min.io/server/minio/release/linux-amd64/minio
    chmod +x ./minio
-   sudo mv -f ./minio /usr/local/bin/
+   sudo mv -f ./minio /usr/local/bin/minio
 
 Once you have replaced the binary on all MinIO hosts in the deployment, you must restart all nodes simultaneously.
 

source/operations/install-deploy-manage/upgrade-minio-deployment.rst

@@ -10,6 +10,10 @@ Upgrade a MinIO Deployment
    :local:
    :depth: 2
 
+.. important::
+
+   For deployments older than :minio-release:`RELEASE.2024-03-30T09-41-56Z` running with :ref:`AD/LDAP <minio-ldap-config-settings>` enabled, you **must** read through the release notes for :minio-release:`RELEASE.2024-04-18T19-09-19Z` before starting this procedure.
+   You must take the extra steps documented in the linked release as part of the upgrade.
 
 .. cond:: linux
 

source/operations/install-deploy-manage/upgrade-minio-tenant.rst

@@ -10,6 +10,11 @@ Upgrade a MinIO Tenant
    :local:
    :depth: 1
 
+.. important::
+
+   For Tenants using a MinIO Image older than :minio-release:`RELEASE.2024-03-30T09-41-56Z` running with :ref:`AD/LDAP <minio-ldap-config-settings>` enabled, you **must** read through the release notes for :minio-release:`RELEASE.2024-04-18T19-09-19Z` before starting this procedure.
+   You must take the extra steps documented in the linked release as part of the upgrade procedure.
+
 .. _minio-upgrade-tenant-plugin:
 
 Upgrade the Tenant using the MinIO Kubernetes Plugin

source/url-excludes.yaml

@@ -9,6 +9,7 @@ excludes:
 - 'operations/install-deploy-manage/delete-minio-tenant.rst'
 - 'operations/install-deploy-manage/minio-operator-console.rst'
 - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst'
+- 'operations/install-deploy-manage/deploy-operator-kustomize.rst'
 - 'operations/deploy-manage-tenants.rst'
 - 'developers/sts-for-operator.rst'
 - 'reference/kubectl-minio-plugin.rst'
@@ -43,6 +44,7 @@ excludes:
 - 'operations/install-deploy-manage/delete-minio-tenant.rst'
 - 'operations/install-deploy-manage/minio-operator-console.rst'
 - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst'
+- 'operations/install-deploy-manage/deploy-operator-kustomize.rst'
 - 'operations/deploy-manage-tenants.rst'
 - 'reference/kubectl-minio-plugin*'
 - 'reference/minio-server*'
@@ -75,6 +77,7 @@ excludes:
 - 'operations/install-deploy-manage/delete-minio-tenant.rst'
 - 'operations/install-deploy-manage/minio-operator-console.rst'
 - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst'
+- 'operations/install-deploy-manage/deploy-operator-kustomize.rst'
 - 'operations/deploy-manage-tenants.rst'
 - 'reference/kubectl-minio-plugin*'
 - 'reference/minio-server*'
@@ -104,6 +107,7 @@ excludes:
 - 'operations/install-deploy-manage/expand-minio-deployment.rst'
 - 'operations/deploy-manage-tenants.rst'
 - 'operations/install-deploy-manage/deploy-minio-tenant-helm.rst'
+- 'operations/install-deploy-manage/deploy-operator-kustomize.rst'
 - 'reference/kubectl-minio-plugin*'
 - 'reference/minio-server*'
 - 'reference/minio-mc*'