Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

Table of Contents

If you do not have a valid HiveMQ license, the HiveMQ cluster uses a trial licence that allows up to 25 concurrent client connections and is limited to testing and evaluation purposes only. To obtain a HiveMQ licence that is suitable for production use, or request an evaluation licence that allows more connections, contact our customer service team.

...

Set Up Your Kubernetes Cluster With 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:

  1. go to subscriptions under your azure account and look for subscription ID

  2. Run the following command to set subscription for your account:

az account set --subscription subscriptionID

  1. To create a Kubernetes cluster on Azure with the Azure CLI, open a terminal and enter:

Code Block
az login
  1. A window to sign in to your Microsoft account opens in your browser. After you successfully submit your credentials, a sign-in confirmation prints in your terminal.

...

  1. Before you create the cluster, you need to select the region where the cluster is hosted. To view a list of all available locations, enter:

Code Block
az account list-locations
  1. To create an Azure Resource Group with all the necessary resources for your cluster, enter the following command with the desired location (in this procedure, we use germanywestcentral):

Code Block
az group create --name hmqResourceGroup --location germanywestcentral 

...

  1. To create a four-node AKS-managed Kubernetes cluster in your resource group with the Azure virtual machine type Standard_A8_v2 (8 CPUs, 16 GiB RAM), enter the following command and wait until the process completes.Processing time can vary:

Code Block
az aks create -g hmqResourceGroup -n HiveMQCluster --node-count 4 --node-vm-size Standard_A8_v2 --enable-managed-identity

Your Microsoft Azure account bills you for all resources you create.

Manage the cluster

  1. To manage the resulting Kubernetes cluster with kubectl, download the access credentials of the cluster:

Code Block
az login
Code Block
az aks get-credentials -g hmqResourceGroup -n HiveMQCluster
  1. To verify that all four nodes are available, enter:

Code Block
kubectl get nodes
  1. The output from the command is similar to the following:

Code Block
NAME                                STATUS   ROLES   AGE     VERSION
aks-nodepool1-37471664-vmss000000   Ready    agent   5m44s   v1.18.10
aks-nodepool1-37471664-vmss000001   Ready    agent   5m50s   v1.18.10
aks-nodepool1-37471664-vmss000002   Ready    agent   5m47s   v1.18.10
aks-nodepool1-37471664-vmss000003   Ready    agent   5m47s   v1.18.10

In case you do not see the right nodes, please check and fix the current context

  1. Check the current context, this should be set to HiveMQCluster in this case
    kubectl config current-context

  2. Fix the context
    kubectl config use-context HiveMQCluster

Next steps
Install HiveMQ on the AKS cluster

Delete Cluster

Delete Cluster

In case you do not need your cluster anymore, please use the following commands to delete the cluster.

Code Block
az aks delete -g hmqResourceGroup -n HiveMQCluster -y
az group delete -n hmqResourceGroup -y --no-wait

Next steps

Install HiveMQ on the AKS cluster