From 8d8e6bca297656f410bdfa03a3df8b80a3bb209c Mon Sep 17 00:00:00 2001
From: Ravind Kumar <ravind@min.io>
Date: Wed, 12 Oct 2022 12:08:30 -0400
Subject: [PATCH] Procedure for updating Operator (#608)

Build out Operator Upgrade Procedure

Co-authored-by: Lenin Alevski <alevsk.8772@gmail.com>
---
 source/_static/scss/includes/_reset.scss      |  13 +-
 ...tor-manage-tenant-update-minio-version.png | Bin 0 -> 35516 bytes
 source/includes/k8s/deploy-operator.rst       |  10 +-
 .../k8s/install-minio-kubectl-plugin.rst      |   2 +-
 .../upgrade-minio-operator.rst                | 320 +++++++++++++++++-
 .../kubectl-minio-init.rst                    |  15 +-
 6 files changed, 340 insertions(+), 20 deletions(-)
 create mode 100644 source/images/k8s/operator-manage-tenant-update-minio-version.png

diff --git a/source/_static/scss/includes/_reset.scss b/source/_static/scss/includes/_reset.scss
index fc01fdee..66c28507 100644
--- a/source/_static/scss/includes/_reset.scss
+++ b/source/_static/scss/includes/_reset.scss
@@ -299,7 +299,6 @@ ul {
     list-style-type: disc;
 }
 
-
 // ----------------------
 // Misc
 // ----------------------
@@ -316,4 +315,16 @@ abbr, acronym {
 dt:target,
 span.highlighted {
     background-color: transparent;
+}
+
+// ----------------------
+// Container - Procedure
+// ----------------------
+
+.container.procedure {
+   padding: 0px;
+
+   > ol > li > p:first-of-type {
+      font-weight: bold;
+   }
 }
\ No newline at end of file
diff --git a/source/images/k8s/operator-manage-tenant-update-minio-version.png b/source/images/k8s/operator-manage-tenant-update-minio-version.png
new file mode 100644
index 0000000000000000000000000000000000000000..bb3b3b12cc0f5600f7d1b9c3311f78e490db3171
GIT binary patch
literal 35516
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
F{ukb77t8<v

literal 0
HcmV?d00001

diff --git a/source/includes/k8s/deploy-operator.rst b/source/includes/k8s/deploy-operator.rst
index 7e0eb64c..9919f847 100644
--- a/source/includes/k8s/deploy-operator.rst
+++ b/source/includes/k8s/deploy-operator.rst
@@ -216,10 +216,8 @@ Operator Console.
 You can deploy a new :ref:`MinIO Tenant <minio-k8s-deploy-minio-tenant>` from
 the Operator Dashboard.
 
-.. uncomment this block when upgrade operator procedure is complete
+.. toctree::
+   :titlesonly:
+   :hidden:
 
-   .. toctree::
-      :titlesonly:
-      :hidden:
-
-      /operations/install-deploy-manage/upgrade-minio-operator
\ No newline at end of file
+   /operations/install-deploy-manage/upgrade-minio-operator
\ No newline at end of file
diff --git a/source/includes/k8s/install-minio-kubectl-plugin.rst b/source/includes/k8s/install-minio-kubectl-plugin.rst
index b20d1762..aa908e34 100644
--- a/source/includes/k8s/install-minio-kubectl-plugin.rst
+++ b/source/includes/k8s/install-minio-kubectl-plugin.rst
@@ -36,7 +36,7 @@ You can install the MinIO plugin using either the Kubernetes Krew plugin manager
          :substitutions:
          :class: copyable
 
-         curl https://github.com/minio/operator/releases/download/|operator-version-stable|/kubectl-minio_|operator-version-stable|_linux_amd64 -o kubectl-minio
+         curl https://github.com/minio/operator/releases/download/v|operator-version-stable|/kubectl-minio_|operator-version-stable|_linux_amd64 -o kubectl-minio
          chmod +x kubectl-minio
          mv kubectl-minio /usr/local/bin/
 
diff --git a/source/operations/install-deploy-manage/upgrade-minio-operator.rst b/source/operations/install-deploy-manage/upgrade-minio-operator.rst
index 68763092..26320d23 100644
--- a/source/operations/install-deploy-manage/upgrade-minio-operator.rst
+++ b/source/operations/install-deploy-manage/upgrade-minio-operator.rst
@@ -1,4 +1,3 @@
-:orphan:
 .. _minio-k8s-upgrade-minio-operator:
 
 ======================
@@ -11,6 +10,321 @@ Upgrade MinIO Operator
    :local:
    :depth: 1
 
+You can upgrade the MinIO Operator at any time without impacting your managed MinIO Tenants.
 
-This page is currently under active redevelopment.
-We will restore it to the TOC once that work is complete.
\ No newline at end of file
+As part of the upgrade process, the Operator may update and restart Tenants to support changes to the MinIO Custom Resource Definition (CRD). 
+These changes require no action on the part of any operator or administrator, and do not impact Tenant operations.
+
+The following table lists the upgrade paths from previous versions of the MinIO Operator:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 40 40
+   :width: 100%
+
+   * - Current Version
+     - Supported Upgrade Target
+
+   * - 4.2.3 and Later
+     - |operator-version-stable|
+   
+   * - 4.0.0 through 4.2.2
+     - 4.2.3
+
+   * - 3.X.X
+     - 4.2.2
+
+.. _minio-k8s-upgrade-minio-operator-procedure:
+
+Upgrade MinIO Operator 4.2.3 and Later to |operator-version-stable|
+-------------------------------------------------------------------
+
+.. admonition:: Prerequisites
+   :class: note
+
+   This procedure requires the following:
+
+   - You have an existing MinIO Operator deployment running 4.2.3 or later
+   - Your Kubernetes cluster runs 1.19.0 or later
+   - Your local host has ``kubectl`` installed and configured with access to the Kubernetes cluster
+
+This procedure upgrades the MinIO Operator from any 4.2.3 or later release to |operator-version-stable|.
+
+.. container:: procedure
+
+   1. *(Optional)* Update each MinIO Tenant to the latest stable MinIO Version.
+
+      Upgrading MinIO regularly ensures your Tenants have the latest features and performance improvements.
+
+      Test upgrades in a lower environment such as a Dev or QA Tenant, before applying to your production Tenants.
+
+      See :ref:`minio-k8s-upgrade-minio-tenant` for a procedure on upgrading MinIO Tenants.
+
+   #. Verify the existing Operator installation.
+
+      Use ``kubectl get all -n minio-operator`` to verify the health and status of all Operator pods and services.
+      
+      If you installed the Operator to a custom namespace, specify that namespace as ``-n <NAMESPACE>``.
+
+      You can verify the currently installed Operator version by retrieving the object specification for an operator pod in the namespace.
+      The following example uses the ``jq`` tool to filter the necessary information from ``kubectl``:
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl get pod -l 'name=minio-operator' -n minio-operator -o json | jq '.items[0].spec.containers'
+
+      The output resembles the following:
+
+      .. code-block:: json
+         :emphasize-lines: 8-10
+
+         {
+            "env": [
+               {
+                  "name": "CLUSTER_DOMAIN",
+                  "value": "cluster.local"
+               }
+            ],
+            "image": "minio/operator:v4.5.1",
+            "imagePullPolicy": "IfNotPresent",
+            "name": "minio-operator"
+         }
+
+   #. Download the Latest Stable Version of the MinIO Kubernetes Plugin
+
+      .. include:: /includes/k8s/install-minio-kubectl-plugin.rst
+
+   #. Run the initialization command to upgrade the Operator
+
+      Use the :mc-cmd:`kubectl minio init` command to upgrade the existing MinIO Operator installation
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl minio init
+
+   #. Validate the Operator upgrade
+
+      You can check the Operator version by reviewing the object specification for an Operator Pod using a previous step.
+
+      Use :mc-cmd:`kubectl minio proxy` to access the Operator Console and confirm the status of managed Tenants:
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl minio proxy
+
+.. _minio-k8s-upgrade-minio-operator-4.2.2-procedure:
+
+Upgrade MinIO Operator 4.0.0 through 4.2.2 to 4.2.3
+---------------------------------------------------
+
+.. admonition:: Prerequisites
+   :class: note
+
+   This procedure assumes that:
+
+   - You have an existing MinIO Operator deployment running any release from 4.0.0 through 4.2.2
+   - Your Kubernetes cluster runs 1.19.0 or later
+   - Your local host has ``kubectl`` installed and configured with access to the Kubernetes cluster
+
+This procedure covers the necessary steps to upgrade a MinIO Operator deployment running any release from 4.0.0 through 4.2.2 to 4.2.3.
+You can then perform :ref:`minio-k8s-upgrade-minio-operator-procedure` to complete the upgrade to |operator-version-stable|.
+
+There is no direct upgrade path for 4.0.0 - 4.2.2 installations to |operator-version-stable|.
+
+.. container:: procedure
+
+   1. *(Optional)* Update each MinIO Tenant to the latest stable MinIO Version.
+
+      Upgrading MinIO regularly ensures your Tenants have the latest features and performance improvements.
+
+      Test upgrades in a lower environment such as a Dev or QA Tenant, before applying to your production Tenants.
+
+      See :ref:`minio-k8s-upgrade-minio-tenant` for a procedure on upgrading MinIO Tenants.
+
+   #. Check the Security Context for each Tenant Pool
+
+      Use the following command to validate the specification for each managed MinIO Tenant:
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl get tenants <TENANT-NAME> -n <TENANT-NAMESPACE> -o yaml
+      
+      If the ``spec.pools.securityContext`` field does not exist for a Tenant, the tenant pods likely run as root.
+      
+      As part of the 4.2.3 and later series, pods run with a limited permission set enforced as part of the Operator upgrade.
+      However, Tenants running pods as root may fail to start due to the security context mismatch.
+      You can set an explicit Security Context that allows pods to run as root for those Tenants:
+
+      .. code-block:: shell
+         :class: copyable
+
+         securityContext:
+           runAsUser: 0
+           runAsGroup: 0
+           runAsNonRoot: false
+           fsGroup: 0
+
+      You can use the following command to edit the tenant and apply the changes:
+
+      .. code-block:: shell
+
+         kubectl edit tenants <TENANT-NAME> -n <TENANT-NAMESPACE>
+         # Modify the securityContext as needed
+
+      See :kube-docs:`Pod Security Standards <concepts/security/pod-security-standards/>` for more information on Kubernetes Security Contexts.
+
+   #. Upgrade to Operator 4.2.3
+
+      Download the MinIO Kubernetes Plugin 4.2.3 and use it to upgrade the Operator.
+      Open https://github.com/minio/operator/releases/tag/v4.2.3 in a browser and download the binary that corresponds to your local host OS.
+      For example, Linux hosts running an Intel or AMD processor can run the following commands:
+
+      .. code-block:: shell
+         :class: copyable
+
+         wget https://github.com/minio/operator/releases/download/v4.2.3/kubectl-minio_4.2.3_linux_amd64 -o kubectl-minio_4.2.3
+         chmod +x kubectl-minio_4.2.3
+
+         ./kubectl-minio_4.2.3 init
+
+   #. Validate all Tenants and Operator pods
+
+      Check the Operator and MinIO Tenant namespaces to ensure all pods and services started successfully.
+
+      For example:
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl get all -n minio-operator
+
+         kubectl get pods -l "v1.min.io/tenant" --all-namespaces
+
+   #. Upgrade to |operator-version-stable|
+
+      Follow the :ref:`minio-k8s-upgrade-minio-operator-procedure` procedure to upgrade to the latest stable Operator version.
+
+Upgrade MinIO Operator 3.0.0 through 3.0.29 to 4.2.2
+----------------------------------------------------
+
+.. admonition:: Prerequisites
+   :class: note
+
+   This procedure assumes that:
+
+   - You have an existing MinIO Operator deployment running 3.X.X
+   - Your Kubernetes cluster runs 1.19.0 or later
+   - Your local host has ``kubectl`` installed and configured with access to the Kubernetes cluster
+
+This procedure covers the necessary steps to upgrade a MinIO Operator deployment running any release from 3.0.0 through 3.2.9 to 4.2.2.
+You can then perform :ref:`minio-k8s-upgrade-minio-operator-4.2.2-procedure`, followed by :ref:`minio-k8s-upgrade-minio-operator-procedure`.
+
+There is no direct upgrade path from a 3.X.X series installation to |operator-version-stable|.
+
+.. container:: procedure
+
+   1. (Optional) Update each MinIO Tenant to the latest stable MinIO Version.
+
+      Upgrading MinIO regularly ensures your Tenants have the latest features and performance improvements.
+
+      Test upgrades in a lower environment such as a Dev or QA Tenant, before applying to your production Tenants.
+
+      See :ref:`minio-k8s-upgrade-minio-tenant` for a procedure on upgrading MinIO Tenants.
+
+   #. Validate the Tenant ``tenant.spec.zones`` values
+
+      Use the following command to validate the specification for each managed MinIO Tenant:
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl get tenants <TENANT-NAME> -n <TENANT-NAMESPACE> -o yaml
+
+      - Ensure each ``tenant.spec.zones`` element has a ``name`` field set to the name for that zone.
+        Each zone must have a unique name for that Tenant, such as ``zone-0`` and ``zone-1`` for the first and second zones respectively.
+
+      - Ensure each ``tenant.spec.zones`` has an explicit ``securityContext`` describing the permission set with which pods run in the cluster.
+
+      The following example tenant YAML fragment sets the specified fields:
+
+      .. code-block:: yaml
+
+         image: "minio/minio:$(LATEST-VERSION)"
+         ...
+         zones:
+         - servers: 4
+           name: "zone-0"
+           volumesPerServer: 4
+           volumeClaimTemplate:
+              metadata:
+              name: data
+              spec:
+              accessModes:
+                 - ReadWriteOnce
+              resources:
+                 requests:
+                    storage: 1Ti
+           securityContext:
+              runAsUser: 0
+              runAsGroup: 0
+              runAsNonRoot: false
+              fsGroup: 0
+         - servers: 4
+           name: "zone-1"
+           volumesPerServer: 4
+           volumeClaimTemplate:
+              metadata:
+              name: data
+              spec:
+              accessModes:
+                 - ReadWriteOnce
+              resources:
+                 requests:
+                    storage: 1Ti
+           securityContext:
+              runAsUser: 0
+              runAsGroup: 0
+              runAsNonRoot: false
+              fsGroup: 0
+
+      You can use the following command to edit the tenant and apply the changes:
+
+      .. code-block:: shell
+
+         kubectl edit tenants <TENANT-NAME> -n <TENANT-NAMESPACE>
+
+   #. Upgrade to Operator 4.2.2
+
+      Download the MinIO Kubernetes Plugin 4.2.2 and use it to upgrade the Operator.
+      Open https://github.com/minio/operator/releases/tag/v4.2.2 in a browser and download the binary that corresponds to your local host OS.
+      For example, Linux hosts running an Intel or AMD processor can run the following commands:
+
+      .. code-block:: shell
+         :class: copyable
+
+         wget https://github.com/minio/operator/releases/download/v4.2.3/kubectl-minio_4.2.2_linux_amd64 -o kubectl-minio_4.2.2
+         chmod +x kubectl-minio_4.2.2
+
+         ./kubectl-minio_4.2.2 init
+
+   #. Validate all Tenants and Operator pods
+
+      Check the Operator and MinIO Tenant namespaces to ensure all pods and services started successfully.
+
+      For example:
+
+      .. code-block:: shell
+         :class: copyable
+
+         kubectl get all -n minio-operator
+
+         kubectl get pods -l "v1.min.io/tenant" --all-namespaces
+
+   #. Upgrade to 4.2.3
+
+      Follow the :ref:`minio-k8s-upgrade-minio-operator-4.2.2-procedure` procedure to upgrade to Operator 4.2.3.
+      You can then upgrade to |operator-version-stable|.
diff --git a/source/reference/kubectl-minio-plugin/kubectl-minio-init.rst b/source/reference/kubectl-minio-plugin/kubectl-minio-init.rst
index 5f955f6e..873598a8 100644
--- a/source/reference/kubectl-minio-plugin/kubectl-minio-init.rst
+++ b/source/reference/kubectl-minio-plugin/kubectl-minio-init.rst
@@ -18,11 +18,13 @@ Description
 
 .. start-kubectl-minio-init-desc
 
-The :mc:`kubectl minio init` command initializes the MinIO Operator. 
-:mc:`kubectl minio init` requires the operator for core functionality.
+The :mc:`kubectl minio init` command initialize the MinIO Operator.
 
 .. end-kubectl-minio-init-desc
 
+If the Kubernetes cluster has an existing MinIO Operator installation, this command upgrades the Operator to match the MinIO plugin version.
+For more information on upgrading the MinIO Operator, see :ref:`minio-k8s-upgrade-minio-operator`.
+
 Syntax
 ------
 
@@ -30,17 +32,12 @@ Syntax
 
    .. tab-item:: EXAMPLE
 
-      The following command initializes a new MinIO Operator deployment using operator v4.4.22, on the ``minio-operator`` namespace, using the cluster domain of ``cluster.local`` and watching the default namespace.:
+      The following command initializes a new MinIO Operator deployment running |operator-version-stable|.
 
       .. code-block:: shell
          :class: copyable
 
-         kubectl minio init                      \
-             --image=minio/operator:v4.4.22      \
-             --namespace=minio-operator          \
-             --cluster-domain=cluster.local      \
-             --namespace-to-watch=default        \
-             --image-pull-secret=  
+         kubectl minio init
 
    .. tab-item:: SYNTAX