Deploying DCT on MicroK8s

This page provides steps for deploying Data Control Tower (DCT) on MicroK8s using Helm charts. The process involves adding the DCT Helm repository, configuring the deployment through values.yaml, and handling deployments in both online and offline environments.

Adding the DCT Helm repository

This command registers the DCT services repository with your Helm client, making the charts available for your deployment.

helm repo add dct-services https://dlpx-helm-dct.s3.amazonaws.com

Updating Helm repositories

After adding the DCT repository, update your local Helm charts metadata to ensure you have the latest versions available:

helm repo update

Downloading and preparing the DCT Helm chart

Pull the required version of the Helm chart for DCT using the Helm pull command. Replace x.0.0 with the specific version of DCT you intend to install:

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

Extract the downloaded chart with the following command:

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

Configuring the deployment

Navigate to the extracted folder and update the values.yaml file with necessary configurations:

• To automatically generate a bootstrap API key, set apiKeyCreate: true.

• Provide the Docker registry credentials (username and password) for pulling images. These credentials can be retrieved from the Delphix DCT Download page by logging in with your user login.

Deploying DCT

With the values.yaml file configured, deploy DCT using Helm with the following command:

helm install dct-services delphix-dct

Handling offline mode

For environments without direct access to the Delphix Helm and Docker repositories:

1. Download the delphix-dct-x.0.0.tar.gz package from the download site.

2. Extract the Helm chart and Docker images from the downloaded file.

3. Load the Docker images into your local Docker environment using:

   CODE

   for image in *tar; do sudo docker load --input $image; done

4. Re-tag and push the Docker images to your local registry. Follow the format for tagging images:

   CODE

   docker tag registry.delphix.com/delphix-dct:app-x.0.0 <local registry url>:app-x.0.0

5. Update the values.yaml with your local registry name and credentials.

Utilizing MicroK8s' built-in registry for DCT Docker images

MicroK8s includes a built-in Docker registry that allows you to store Docker images directly on your MicroK8s instance. This is particularly useful for single VM solutions, providing a more integrated and straightforward approach to managing Docker images for DCT deployment.

Process

1. MicroK8s comes with an add-on registry that can be enabled with:

   CODE

   microk8s enable registry

   1. This command sets up a Docker registry within MicroK8s, accessible on port 32000.

2. After loading your DCT Docker images into MicroK8s, they must be re-tagged to use them in the local MicroK8s registry. Use the following format for re-tagging your images:

   CODE

   docker tag registry.delphix.com/delphix-dct:app-x.0.0 localhost:32000/delphix-dct:app-x.0.0

3. Once re-tagged, push the images to the MicroK8s registry by running:

   CODE

   docker push localhost:32000/delphix-dct:app-x.0.0

   1. This command uploads the re-tagged DCT images to the built-in Docker registry of your MicroK8s instance.

4. With the images now hosted in the MicroK8s registry, update the values.yaml file to reference the local images. Change the image repository to use the MicroK8s registry URL:

   CODE

   registry: localhost:32000

   This will have Helm pull the Docker images from the MicroK8s internal registry during the deployment of DCT, to streamline deployment within a single VM solution.