Import a Kubernetes Context¶

When you run the pachctl deploy command with --dry-run flag, instead of immediately deploying a cluster, the command creates a Kubernetes deployment manifest that you can further edit and later use to deploy a Pachyderm cluster.

You can use that manifest with a standard kubectl apply command to deploy Pachyderm. For example, if you have created a manifest called test-manifest.yaml, you can deploy a Pachyderm cluster by running the following command:

kubectl apply -f test-manifest.yaml

Typically, when you run pachctl deploy, Pachyderm creates a new Pachyderm context with the information from the current Kubernetes context embedded into it.

When you use the --dry-run flag, the Pachyderm context is not created. Therefore, if you deploy a Pachyderm cluster from a manifest that you have created earlier, you need to manually create a new Pachyderm context with the embedded current Kubernetes context and activate that context.

To import a Kubernetes context, complete the following steps:

1. Deploy a Pachyderm cluster from the Kubernetes manifest that you have created when you ran the pachctl deploy command with the --dry-run flag:

   kubectl apply -f <manifest.yaml>
   

   System Response:

   clusterrole.rbac.authorization.k8s.io/pachyderm configured
   clusterrolebinding.rbac.authorization.k8s.io/pachyderm configured
   deployment.apps/etcd configured
   service/etcd configured
   service/pachd configured
   deployment.apps/pachd configured
   service/dash configured
   deployment.apps/dash configured
   secret/pachyderm-storage-secret configured
   

2. Verify that the cluster was successfully deployed:

   kubectl get pods
   

   System Response:

   NAME                     READY   STATUS    RESTARTS   AGE
   dash-64c868cc8b-j79d6    2/2     Running   0          20h
   etcd-6865455568-tm5tf    1/1     Running   0          20h
   pachd-6464d985c7-dqgzg   1/1     Running   0          70s
   

   You must see all the dash, etcd, and pachd pods running.

3. Create a new Pachyderm context with the embedded Kubernetes context:

   pachctl config set context <new-pachyderm-context> -k `kubectl config current-context`
   

4. Verify that the context was successfully created and view the context parameters:

   Example:

   pachctl config get context test-context
   

   System Response:

   {
     "source": "IMPORTED",
     "cluster_name": "minikube",
     "auth_info": "minikube",
     "namespace": "default"
   }
   

5. Activate the new Pachyderm context:

   pachctl config set active-context <new-pachyderm-context>
   

6. Verify that the new context has been activated:

   pachctl config get active-context