Add a Kubernetes cluster

PDS supports Vanilla Kubernetes, AWS EKS and Auzure AKS.

Prerequisites

• PDS account Admin privileges

• A supported Kubernetes cluster with Portworx Enterprise installed on it.

• Helm chart version 3.2.0 or newer

Prepare your cluster for installation

1. In the Settings → Deployment Targets page → select the Add Deployment Target button.

2. From the How to Add Deployment Targets window, copy the helm install command and paste it into a secure text editor.

   
   NOTE: Do not modify the helm install command.

Wait for the PDS agent to register the new deployment target in the control plane. Once successful, the status will show as a green check mark.

Prepare namespaces for deployment

After adding a target cluster to PDS, you must make any namespaces you intend to use with PDS available to it. Perform this task for each namespace you want to create and add:

1. Create a NAMESPACE environment variable with the namespace you want to create or add:

   export NAMESPACE=docs-test

2. Create the namespace, if it does not exist:

   kubectl create namespace $NAMESPACE

3. Label the namespace:

   kubectl label namespaces $NAMESPACE pds.portworx.com/available=true --overwrite=true

Once successful, the No namespaces available error message will disappear.

Disconnected deployment target

If a deployment target registration is unsuccessful, then the status will show as Disconnected. A deployment target becomes disconnected due to one or a combination of the following reasons:

• If Portworx is not installed, then the PDS agent fails to start.
• PDS agent fails to connect to the control plane.
• PDS agent fails to register the target cluster.
• Teleport agent fails to start.
• Teleport agent fails to connect to the control plane.
• Teleport agent fails to register the target cluster.
• Teleport agent fails to establish a secure reverse tunnel.

View the deployment target health

Run the following commands to learn more about the healthiness of a target cluster deployment:

Learn more about the PDS agent deployment

• Describe PDS Agent deployment:

  kubectl describe deployment/pds-agent -n pds-system

• Check logs of PDS agent:

  kubectl logs deployment/pds-agent -n pds-system

Learn more about the Teleport deployment

• Describe Teleport deployment:

  kubectl describe deployment/pds-teleport -n pds-system

• Check logs of Teleport:

  kubectl logs deployment/pds-teleport -n pds-system