| Table of Contents |
|---|
...
| Info |
|---|
While creating this guide, our Kubernetes Version is v1.27.7, it might be different in your case |
Requirements
Microsoft Azure Account
HiveMQ License (optional)
Azure CLI
The Azure command-line interface is used to create and manage Azure resources. In this procedure, you use the Azure CLI to create an Azure Resource Group with a Kubernetes cluster on the Azure cloud. To install the Azure CLI on macOS with Homebrew, open a terminal and enter the following. For other operating systems, see Azure CLI installation.
| Code Block |
|---|
brew install az |
kubectl
Kubectl is the official command-line interface for interacting with Kubernetes clusters. Here, you use kubectl to manage the created Kubernetes cluster on Azure. Once you install Azure CLI, you can enter the following command to install kubectl on any operating system:
| Code Block |
|---|
az aks install-cli |
Helm
Helm is the most commonly used package manager for Kubernetes. Helm helps you easily define, install, and update the software that you run on a Kubernetes cluster. In this procedure, you use Helm to install and configure HiveMQ on your K8s cluster. To install Helm on macOS with Homebrew, enter:
| Code Block |
|---|
brew install helm |
For other operating systems, see Helm installation.
MQTT - CLI
MQTT-CLI is an open-source command-line interface from HiveMQ that allows you to quickly simulate MQTT clients. Here, you use the MQTT-CLI to connect clients and interact with your HiveMQ cluster.
To install MQTT-CLI on macOS with Homebrew, enter:
| Code Block |
|---|
brew install hivemq/mqtt-cli/mqtt-cli |
For other operating systems, see MQTT-CLI installation.
Set Up Your Kubernetes Cluster With Azure Kubernetes Service(AKS)
In case you get the following error , you can fix it by setting subscription for your account
The client XYZ with object id 'ABCD' does not have authorization to perform action 'Microsoft.Resources/subscriptions/resourcegroups/write' over scope or the scope is invalid. If access was recently granted, please refresh your credentials.
Code: AuthorizationFailed
Steps to fix the error:
go to subscriptions under your azure account and look for subscription ID
Run the following command to set subscription for your account:
az account set --subscription subscriptionID
...
Your Microsoft Azure account bills you for all resources you create. |
Manage the cluster
To manage the resulting Kubernetes cluster with kubectl, download the access credentials of the cluster:
...
In case you do not see the right nodes, please check and fix the current context
Check the current context, this should be set to HiveMQCluster in this case
kubectl config current-contextFix the context
kubectl config use-context HiveMQCluster
Delete Cluster
In case you do not need your cluster anymore, please use the following commands to delete the cluster.
...
| Code Block |
|---|
az group delete -n hmqResourceGroup -y --no-wait |