Deployment upgrade for Kubernetes

This page covers the upgrade process for DCT deployments on Kubernetes.

Starting from DCT 12.0.0 we have introduced one new service(container) named Masking.

Memory and CPU requirement for this newly added service(container) is 512Mi and 500m respectively.

This container creates a new persistent volume of 1GB dynamically, if you are using pre-existing static persistent volumes for other existing pods(i.e. gateway and database) then similar to these pods, please create a new persistent volume claim for masking pod too and update the maskingPvcName property in the values.yaml with the name of static persistent volume claim.

For customising masking service resources(request and limits) and properties please refer values.yaml file in the helm chart of current release.

Create a new folder called dct-x.0.0, where x.0.0 should be changed to the version of DCT being installed (e.g. if on 5.0.2, it would be 6.0.0).

NONE

mkdir dct-x.0.0

Update the added repos with the following, which will update the local HELM charts metadata (index.yaml).

CODE

helm repo update

Pull the HELM charts with the following:

This command will download a file named delphix-dct-x.0.0.tgz in the folder dct-x.0.0.

NONE

cd dct-x.0.0
helm pull dct-services/delphix-dct --version x.0.0

The downloaded file is then extracted using the following command (where x.0.0 should be changed to the version of DCT being installed):

NONE

tar -xvf delphix-dct-x.0.0.tgz

Which will extract into the following directory structure:

NONE

delphix-dct
	|- values.yaml
	|- README.md
	|- Chart.yaml
	|- templates
		|-<all templates files>

Create a new values.yaml inside to the dct-x.0.0 folder (e.g. parallel to delphix-dct folder), use sample values.yaml given below. Copy the configured properties from previous version to this newly created values.yaml.

values.yaml

This values.yaml file should only contain the modified values from the previous version of deployment and not the entire values.yaml file as it is.

Update the username and password in values.yaml. It can be obtained from https://download.delphix.com. Here are some notes in regards to this step in the process:

This username and password update in values.yaml is only required if the user using DCT provided a Docker Registry directly in the deployment (i.e. values.yaml).

Username and password update is required only if username AWS and temporary password is used.

OFFLINE MODE

If you do not have direct access to Delphix HELM and Docker repositories, download the HELM charts and Docker images packages as delphix-dct-x.0.0.tar.gz, which is uploaded on the download site.

Extract the downloaded .tgz file to get the HELM chart and Docker images.
Load extracted Docker images using following:
- for image in *tar; do sudo docker load --input $image; done
RE-tag and push Docker images in your local repository, tag images in the following format:
- e.g., docker tag registry.delphix.com/delphix-dct:app-x.0.0 <local registry url>:app-x.0.0
  - Note: Re-tag all remaining DCT images in the same format.
Update values.yaml for registry name and image credentials:
- registry: <local registry url>
- username: <local registry username>
- password: <local registry password>

Run the HELM upgrade command:

NONE

helm upgrade -f values.yaml dct-services delphix-dct