taigrr/nats.docs
1
0
Fork 0
mirror of https://github.com/taigrr/nats.docs synced 2025-01-18 04:03:23 -08:00
Code Issues Projects Releases Wiki Activity

Create create-k8s-cluster.md

Browse Source
This commit is contained in:
Waldemar Quevedo 2020-01-22 12:55:04 -08:00 committed by GitHub
parent a63cb10317
commit 20664fea23
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 76 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
nats-on-kubernetes/create-k8s-cluster.md Normal file
View File

@ -0,0 +1,76 @@
# Creating a Kubernetes cluster
Below you can find examples of creating a small 3 nodes Kubernetes
cluster to try NATS on multiple clouds.
## Google Kubernetes Engine
Using [gcloud](https://cloud.google.com/sdk/gcloud/) to create a 3 nodes Kubernetes cluster:
```sh
gcloud container clusters create nats-k8s-cluster \
--project $YOUR_GOOGLE_CLOUD_PROJECT \
--region us-west2 \
--num-nodes 1 \
--machine-type n1-standard-2
```
## Amazon Kubernetes Service
The [eksctl](https://github.com/weaveworks/eksctl) is a very helpful
tool to manage EKS clusters, you can find more docs on how to set it
up [here](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html).
```sh
# Create 3 nodes Kubernetes cluster
eksctl create cluster --name nats-k8s-cluster \
--nodes 3 \
--node-type=t3.large \
--region=eu-west-1
# Get the credentials for your cluster
eksctl utils write-kubeconfig --name $YOUR_EKS_NAME --region eu-west-1
```
## Digital Ocean
You can use [doctl](https://github.com/digitalocean/doctl) tool to create a cluster as follows:
```sh
doctl kubernetes cluster create nats-k8s-nyc2 --count 3 --region nyc1
```
## Azure Kubernetes Service
```sh
# In case not done already, register to use some services:
az login
az provider register -n Microsoft.Network
az provider register -n Microsoft.Storage
az provider register -n Microsoft.Compute
az provider register -n Microsoft.ContainerService
# Create resource group and 3 node cluster
az group create --name nats --location westus
az aks create --resource-group nats --name nats --node-count 3 --node-vm-size Standard_DS1_v2
az aks get-credentials --resource-group nats --name nats
```
*Note* that in order to be able to access NATS externally you need to
provision public IPs for your cluster installing the following component [dgkanatsios/AksNodePublicIPController](https://github.com/dgkanatsios/AksNodePublicIPController):
```sh
kubectl create -n kube-system -f https://raw.githubusercontent.com/dgkanatsios/AksNodePublicIPController/7846c78f77dc5cd4b43629bb5cb7ff3818594aee/deploy.yaml
```
After this component has been installed, eventually your cluster will
be provided ExternalIPs that the NATS cluster can advertise to
clients:
```
kubectl get nodes -o wide
NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME
aks-nodepool1-18657977-0 Ready agent 5d16h v1.13.12 10.240.0.6 52.191.186.114 Ubuntu 16.04.6 LTS 4.15.0-1060-azure docker://3.0.7
aks-nodepool1-18657977-1 Ready agent 5d17h v1.13.12 10.240.0.4 52.229.11.82 Ubuntu 16.04.6 LTS 4.15.0-1060-azure docker://3.0.7
aks-nodepool1-18657977-2 Ready agent 5d17h v1.13.12 10.240.0.5 13.77.149.235 Ubuntu 16.04.6 LTS 4.15.0-1060-azure docker://3.0.7
```