Untethering projects from the Cloud Pak for Data control plane

If you remove the service instances and workloads that are running in a tethered project (namespace), you can untether the project from the IBM Cloud Pak® for Data control plane. When you untether the project from the control plane, Cloud Pak for Data resources are removed from the project, the control plane no longer monitors the content of the project, and you cannot provision service instances into the project.

Who needs to complete this task?
A cluster administrator must complete this task.
When do you need to complete this task?
Complete this task if the following statements are true:
  • You removed any service instances from the tethered project.
  • You plan to uninstall Cloud Pak for Data or you no longer need to run any Cloud Pak for Data software in the tethered project.

Before you begin

Best practice: You can run the commands in this task exactly as written if you set up environment variables. For instructions, see Setting up installation environment variables.

Ensure that you source the environment variables before you run the commands in this task.

To complete this task, your

Procedure

  1. Run the cpd-cli manage login-to-ocp command to log in to the cluster as a user with sufficient permissions to complete this task. For example:
    cpd-cli manage login-to-ocp \
    --username=${OCP_USERNAME} \
    --password=${OCP_PASSWORD} \
    --server=${OCP_URL}
    Tip: The login-to-ocp command takes the same input as the oc login command. Run oc login --help for details.
  2. Run the following command to untether the project from the project where Cloud Pak for Data is installed:
    cpd-cli manage setup-tethered-ns \
    --cpd_instance_ns=${PROJECT_CPD_INSTANCE} \
    --tethered_instance_ns=${PROJECT_TETHERED} \
    --remove=true
  3. Delete the project:
    oc delete namespace ${PROJECT_TETHERED} --wait=true