minikube/site/content/en/docs/tutorials/multi_node.md

title	linkTitle	weight	date
Using Multi-Node Clusters	Using multi-node clusters	1	2019-11-24

Overview

• This tutorial will show you how to start a multi-node clusters on minikube and deploy a service to it.

Prerequisites

• minikube 1.10.1 or higher
• kubectl

Tutorial

• Start a cluster with 2 nodes in the driver of your choice:

minikube start --nodes 2 -p multinode-demo

😄  [multinode-demo] minikube v1.16.0 on Darwin 10.15.7
✨  Automatically selected the docker driver. Other choices: hyperkit, virtualbox
👍  Starting control plane node multinode-demo in cluster multinode-demo
🔥  Creating docker container (CPUs=2, Memory=2200MB) ...
🐳  Preparing Kubernetes v1.20.0 on Docker 20.10.0 ...
🔗  Configuring CNI (Container Networking Interface) ...
    ▪ Generating certificates and keys ...
    ▪ Booting up control plane ...
    ▪ Configuring RBAC rules ...
🔎  Verifying Kubernetes components...
🌟  Enabled addons: storage-provisioner, default-storageclass

👍  Starting node multinode-demo-m02 in cluster multinode-demo
🔥  Creating docker container (CPUs=2, Memory=2200MB) ...
🌐  Found network options:
    ▪ NO_PROXY=192.168.49.2
🐳  Preparing Kubernetes v1.20.0 on Docker 20.10.0 ...
    ▪ env NO_PROXY=192.168.49.2
🔎  Verifying Kubernetes components...
🏄  Done! kubectl is now configured to use "multinode-demo" cluster and "default" namespace by default

• Get the list of your nodes:

kubectl get nodes

NAME                 STATUS   ROLES    AGE   VERSION
multinode-demo       Ready    master   72s   v1.18.2
multinode-demo-m02   Ready    <none>   33s   v1.18.2

• You can also check the status of your nodes:

minikube status -p multinode-demo

multinode-demo
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured
timeToStop: Nonexistent

multinode-demo-m02
type: Worker
host: Running
kubelet: Running

• Deploy our hello world deployment:

kubectl apply -f hello-deployment.yaml

deployment.apps/hello created

kubectl rollout status deployment/hello

deployment "hello" successfully rolled out

• Deploy our hello world service, which just spits back the IP address the request was served from:

kubectl apply -f hello-svc.yaml

service/hello created

• Check out the IP addresses of our pods, to note for future reference

kubectl get pods -o wide

NAME                    READY   STATUS    RESTARTS   AGE   IP           NODE             NOMINATED NODE   READINESS GATES
hello-c7b8df44f-qbhxh   1/1     Running   0          31s   10.244.0.3   multinode-demo   <none>           <none>
hello-c7b8df44f-xv4v6   1/1     Running   0          31s   10.244.0.2   multinode-demo   <none>           <none>

• Look at our service, to know what URL to hit

minikube service list -p multinode-demo

|-------------|------------|--------------|-----------------------------|
|  NAMESPACE  |    NAME    | TARGET PORT  |             URL             |
|-------------|------------|--------------|-----------------------------|
| default     | hello      |           80 | http://192.168.64.226:31000 |
| default     | kubernetes | No node port |                             |
| kube-system | kube-dns   | No node port |                             |
|-------------|------------|--------------|-----------------------------|

• Let's hit the URL a few times and see what comes back

curl  http://192.168.64.226:31000

Hello from hello-c7b8df44f-qbhxh (10.244.0.3)

curl  http://192.168.64.226:31000
Hello from hello-c7b8df44f-qbhxh (10.244.0.3)

curl  http://192.168.64.226:31000
Hello from hello-c7b8df44f-xv4v6 (10.244.0.2)

curl  http://192.168.64.226:31000
Hello from hello-c7b8df44f-xv4v6 (10.244.0.2)

• Multiple nodes!

• Referenced YAML files {{% tabs %}} {{% tab hello-deployment.yaml %}}

{{% readfile file="/docs/tutorials/includes/hello-deployment.yaml" %}}

{{% /tab %}} {{% tab hello-svc.yaml %}}

{{% readfile file="/docs/tutorials/includes/hello-svc.yaml" %}}

{{% /tab %}} {{% /tabs %}}