Anonymitaet commented on code in PR #399: URL: https://github.com/apache/pulsar-site/pull/399#discussion_r1106590631
########## versioned_docs/version-2.10.x/deploy-ibm.md: ########## @@ -0,0 +1,237 @@ +--- +id: deploy-ibm +title: Apache Pulsar Installation on IBM Kubernetes Cluster through Helm chart +sidebar_label: "IBM Cloud Services" +original_id: deploy-ibm +--- +# Apache Pulsar Installation on IBM Kubernetes Cluster through Helm chart + +:::note + + This doc referes to the Apache pulsar 2.93 Version. if you want to upgrade the Apache Pulsar version you need to follow the [helm-upgrade](https://pulsar.apache.org/docs/2.10.x/helm-upgrade/) Document for upgrade on the perticular version. + +::: + + + +- [Setup a virtual machine (VM) on IBM Cloud.](#create-vm-on-ibm-cloud) +- [Create Kubernete cluster on IBM Cloud.](#create-kubernetes-cluster-on-ibm) +- [Prepare VM for connecting to Kubernetes cluster and deploy Pulsar Helm chart on Kubernetes cluster.](#prepare-vm-for-connecting-to-kubernetes-cluster-and-deploy-pulsar-helm-chart-on-kubernetes-cluster) +- [Verify the deployment.](#run-kubectl-commands-to-verify-the-deployment) + + +#### Create VM on IBM Cloud + +- Go to [IBM Cloud]( https://cloud.ibm.com/login) and login with your credentials. +- Search for Virtual Server. +- Select Virtual Server for Classic. + + + +- Select the type of virtual server as selected "Public" in the image. +- Type the host name, quantity of the machine and billing method. + + + +- Select location value according to your region. For example: In below image we have selected Chennai in Asia region. + + + +- Select the profile of virtual machine. + + + +- Select the operating system and version. + + + +- Select network interface according to use. + + + +- Select the security group. + + + +- Leave rest of the things could be default. Click on the "Create" button. + + + +- Check created VM in "Navigation Menu" -> "Resource list" Devices + + + + + +- Check the detail of VM in overview + + + +- Check the devices list, click on the menu option on the same page. + + + +#### Create Kubernetes Cluster on IBM + +- Search for the Kubernetes services + + + +- Select the plan details to "Standard". Please note "Free" plan has the limited resources, which can not fulfill the Pulsar cluster requirement. + + + +- Select the infrastructure type we are going with the classic and also select the Kubernetes version . + + + +- Select location and resource group. Select single single zone or multi zone as per your need. + + + + + +- Select worker pool size and flavor (vCPU, Memory) of the worker. + + + + + +- Set cluster name as you want. + + +- Leave rest of the things as we are selecting as default. You can disable below options. Click on create and wait for provisioning of the cluster. + + + +- After the cluster is successfully provisioned, connect to the cluster. In order to connect click on the "Action" button then click on "Connect via CLI", it will give you commands, copy that and run in your VM so that we can communicate to cluster through VM. We have to configure VM for communicating to cluster in the next steps will describe how to configure VM for that. + + + +- Check the created cluster list through clicking on the clusters options + + + +- It will show you the list of all the created clusters. + + + +#### Prepare VM for connecting to Kubernetes cluster and deploy Pulsar Helm chart on Kubernetes cluster. + +**Requirements** : +- Installation of [IBM Cloud CLI](https://cloud.ibm.com/docs/cli?topic=cli-install-ibmcloud-cli): For login in IBM cloud and for connection to Kubernetes master node. + +- Installation of [IBM Cloud CLI Plugins](https://cloud.ibm.com/docs/containers?topic=containers-cs_cli_install) Required for connect to IKS (IBM Kubernetes services). + +- Installation of [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/) (kubeControl-CLI) version 1.23, because on IBM we are using kubernetes version 1.23 +- Installation of [Helm](https://helm.sh/docs/intro/install/) + +> Note:- Please install all the above things before running the below commands + +- First take SSH of your VM with your private key. Run all the below commands one by one. +```bash + $ ibmcloud login + $ ibmcloud plugin list +``` + +Output + + +- For connection to Kubernetes cluster, you will get command in Kubernete cluster section. It is like below example. + +> Note: below command is just an example, you will get this command in your kubernetes console. + +```bash + $ibmcloud ks cluster config --cluster ccql163t064kpvg5gg10 +``` + +> Note: this step is showing during creation of Kubernetes Cluster. + + + +- After running 2nd and 3rd commands showing in above image you will get output shows like in the below image (no need to run number 1 command because we already logged in to IBM Cloud) + +Output + + +> Now we are able to run commands of kubectl. + +#### Run kubectl commands to verify the deployment +Make sure all the pods of Pulsar are runnig. Get the service URL and broker URL for publishing and consuming the messages. + + +- We will add "Pulsar" Helm repo in VM and clone the repo of Apache Pulsar from Github, below is all the commands. Review Comment: ```suggestion ``` Suggest removing this because: 1. The steps below have already explained. 2. If the steps are long, suggest adding a simple summary like https://github.com/apache/pulsar-site/pull/399#discussion_r1106573175 -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
