diff --git a/source/cloud/ibm/iks.md b/source/cloud/ibm/iks.md new file mode 100644 index 00000000..5a7771e8 --- /dev/null +++ b/source/cloud/ibm/iks.md @@ -0,0 +1,76 @@ +# IBM Kubernetes Service (IKS) + +RAPIDS can be deployed on IBM Cloud via IBM Cloud managed Kubernetes service (IKS) using any of the [supported Kubernetes installation methods](../../platforms/kubernetes). + +## Install pre-requisites + +Install and configure dependencies in your local environment: [kubectl](https://kubernetes.io/docs/tasks/tools/), [helm](https://helm.sh/), [IBM cloud cli](https://cloud.ibm.com/docs/cli?topic=cli-getting-started) and [IBM Kubernetes Service (KS) plugin](https://cloud.ibm.com/docs/containers?topic=containers-cs_cli_install). + +## Login to IBM CLI + +```shell +$ ibmcloud login -a cloud.ibm.com -r +$ ibmcloud target -g +``` + +```{note} +You can list regions with `$ ibmcloud regions` and resource groups with `$ ibmcloud resource groups`. +``` + +## Create a Kubernetes cluster + +```shell +$ ibmcloud ks cluster create classic \ + --name \ + --zone dal10 \ + --flavor gx2-8x64x1v100 \ + --hardware dedicated \ + --workers 1 \ + --version +``` + +`` = Name of the IKS cluster. This will be auto generated if not specified.
+`` = Kubernetes version, the tested version for this deployment is 1.21.14.
+ +Upon successful creation, you would get the cluster id, note that down, it will be required in the next step to connect to the cluster. + +## Connect to the cluster + +```shell +$ ibmcloud ks cluster config --cluster +``` + +`` = When creating the cluster using IBM KS CLI, use that cluster id to connect to the cluster. + +## Install GPU drivers + +```shell +$ helm repo add nvidia https://helm.ngc.nvidia.com/nvidia +$ helm repo update +$ helm install --wait --generate-name \ + -n gpu-operator --create-namespace \ + nvidia/gpu-operator +``` + +## Install RAPIDS + +Follow any of the [Kubernetes installation methods to install and use RAPIDS](../../platforms/kubernetes). + +## Delete the cluster + +When you are finished delete the Kubernetes cluster. + +Before you delete the cluster you need to manually delete services running in the cluster with external IPs to release network resources. + +```shell +$ kubectl get svc --all-namespaces +$ kubectl delete svc +``` + +`` = Name of the services which have an `EXTERNAL-IP` value. + +Delete the cluster and its associated nodes. + +```shell +$ ibmcloud ks cluster rm --cluster +``` diff --git a/source/cloud/ibm/index.md b/source/cloud/ibm/index.md index 75bfbdb6..e8546793 100644 --- a/source/cloud/ibm/index.md +++ b/source/cloud/ibm/index.md @@ -6,6 +6,7 @@ maxdepth: 2 caption: IBM Cloud --- single-node +iks ``` RAPIDS can be deployed on IBM Cloud in several ways. See the