How to upgrade

1. Sync with new chart. This can be done with kpt or meld: kpt pkg update chart/@{TAG} --strategy alpha-git-patch or kpt pkg update chart/@{TAG} --strategy force-delete-replace or Meld UI
2. Move minio.min.io_tenants.yaml to minio-operator-crds/templates/
3. Update minio-operator-crds/Chart.yaml with new version
4. Update chart/Chart.yaml dependency version
5. Rebuild dependency .tgz: export HELM_EXPERIMENTAL_OCI=1 helm dependency update chart

How to test the upgrade

Local install: 1. Clean install: install minio-operator and minio from your branch. 1. Upgrade: install current versions of minio-operator and minio, and upgrade to your branch. Ensure both minio-operator and minio have upgraded to the newer versions.

Pipeline: modify MinIO package dependency to point to your branch/version and create an MR

Modifications made to upstream chart

This is a high-level list of modifitations that Big Bang has made to the upstream helm chart. You can use this as as cross-check to make sure that no modifications were lost during the upgrade process.

When performing the helm update the following items should be maintained.

1. In chart/templates/_helpers.tpl; maintain the folowing function:

   Create a default fully qualified app name.
   We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
   If release name contains chart name it will be used as a full name.
   */}}
   {{- define "minio-operator.fullname" -}}
   {{- if .Values.fullnameOverride }}
   {{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
   {{- else }}
   {{- $name := default .Chart.Name .Values.nameOverride }}
   {{- if contains $name .Release.Name }}
   {{- .Release.Name | trunc 63 | trimSuffix "-" }}
   {{- else }}
   {{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
   {{- end }}
   {{- end }}
   {{- end }}
   

2. in chart/templates/console-deployment.yaml: keep the condiitonal

   {{- if .Values.console.enabled }}
   

3. in chart/templates/consolde-ingress.yaml: keep the conditional deployment

   {{- if .Values.console.enabled }}
   

4. in chart/template/console-ui.yaml: keep the conditional

   {{- if .Values.console.enabled }}
   

5. if there is a version of minio.min.io_tenants.yaml in the chart/templates, this file should be moved to the minio package if the kpt update does not do it automatically.
6. in chart/templates/serviceaccount.yaml: maintain the conditionals around the service account creation.
7. in chart/templates/operator-deployment.yaml: keep the line 18 annotions section below:

        annotations:
           {{- toYaml .Values.annotations | nindent 8 }}
         {{- end }}
   

chart/values.yaml

• Bigbang additions at the end of the file
• images to ironbank

chart/templates/bigbang/*

• networkpolicies/*
• minio-operaotor-exception.yaml
• peer-authentication.yaml
• tenant-patch-job.yaml

chart/minio-operator-crds/*

• Bigbang moves the operator crd to this location to build the tgz

chart/charts/*.tgz

• run helm dependency update ./chart and commit the downloaded archives

• commit the tar archives that were downloaded from the helm dependency update command. And also commit the requirements.lock that was generated.

---

Last update: 2023-03-21 by Lynn Still