K3s Deployment

Table of Content

General

KubeMQ can be deployed in a Rancher's K3s Kubernetes cluster as a StatefulSet.

K3S is a highly available, certified Kubernetes distribution designed for production workloads in unattended, resource-constrained, remote locations or inside IoT appliances.

KubeMQ Token

Every installation method requires a KubeMQ token. Please register to obtain your KubeMQ token.

Install kubemqctl

The easiest way to deploy KubeMQ cluster is via kubemqctl CLI tool.

macOS / Linux

curl -sL https://get.kubemq.io/install | sh 
1

Windows

Option 1:

  • Download the latest kubemqctl.exe.
  • Place the file under e.g. C:\Program Files\kubemqctl\kubemqctl.exe
  • Add that directory to your system path to access it from any command prompt

Option 2:

Run in PowerShell as administrator:

New-Item -ItemType Directory 'C:\Program Files\kubemqctl'
Invoke-WebRequest https://github.com/kubemq-io/kubemqctl/releases/download/latest/kubemqctl.exe -OutFile 'C:\Program Files\kubemqctl\kubemqctl.exe'
[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path', [EnvironmentVariableTarget]::Machine) + ';C:\Program Files\kubemqctl', [EnvironmentVariableTarget]::Machine)
$env:Path += ';C:\Program Files\kubemqctl'
1
2
3
4

Install K3s

Install K3s as described in https://github.com/rancher/k3s/blob/master/README.md

Configure kubemqctl

Configure kubemqctl config file by running the following command:

kubemqctl config
1

Set installation destination to "K3s"

Deploy KubeMQ Cluster

Run kubemqctl create cluster command:

kubemqctl cluster create -t <YOUR_KUBEMQ_TOKEN>
1

For Example:

kubemqctl-create-basic.gif

Last Updated: 12/1/2019, 7:53:42 PM