Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Current »

\uD83D\uDCD8 Instructions

  1. Get a local copy of the Helm chart.
    This will download the chart of the version $CHART_VERSION and untar it to the subdirectory hivemq-operator:

    helm pull hivemq/hivemq-operator --version $CHART_VERSION --untar

    ☝️Hint: To download the latest chart version, omit the option --version $CHART_VERSION. To learn more about chart versions refer to the article HiveMQ Kubernetes Operator Helm chart versions.

  2. Update dependencies in the chart’s directory.
    This command verifies that the required charts, as expressed in 'Chart.yaml', are present in 'charts/' and are at an acceptable version. It will pull down the latest charts that satisfy the dependencies, and clean up old dependencies.

    helm dependencies update hivemq-operator
    Hang tight while we grab the latest from your chart repositories...
    ...Successfully got an update from the "hivemq" chart repository
    ...Successfully got an update from the "prometheus-community" chart repository
    Update Complete. ⎈Happy Helming!⎈
    Saving 1 charts
    Downloading kube-prometheus-stack from repo https://prometheus-community.github.io/helm-charts
    Deleting outdated charts
  3. Edit operator templates, and update the livenessProbe’s declaration.

    1. Edit the operator templates:

      1. hivemq-operator/operator-tmpls/cluster-daemon-set.yaml

      2. hivemq-operator/operator-tmpls/cluster-deployment.yaml

      3. hivemq-operator/operator-tmpls/cluster-stateful-set.yaml

    2. Find the existing declaration of the livenessProbe:

      livenessProbe:
        tcpSocket:
          port: {{ util:getPort(spec, "mqtt").port }}
        initialDelaySeconds: 15
        periodSeconds: 30
        failureThreshold: 240
    3. Replace with the new declaration of the livenessProbe:

      livenessProbe:
        httpGet:
          path: /heartbeat
          port: {{ util:getPort(spec, "heartbeat").port }}
        initialDelaySeconds: 30
        periodSeconds: 15
        failureThreshold: 240
  4. Get the values.yaml file for the hivemq-operator of the version $CHART_VERSION:

    helm show values hivemq/hivemq-operator --version $CHART_VERSION > my-values.yaml

    ☝️ Hint: To download from the latest chart version, omit the option --version $CHART_VERSION. To learn more about chart versions refer to the article HiveMQ Kubernetes Operator Helm chart versions.

  5. Edit the my-values.yaml file:

    1. Add the heartbeat extension to the end of the hivemq.extensions array:

      hivemq:
        ...
        extensions:
          ...
          ...    
          - name: hivemq-heartbeat-extension
            extensionUri: https://github.com/hivemq/hivemq-heartbeat-extension/releases/download/1.0.4/hivemq-heartbeat-extension-1.0.4.zip
            enabled: true
    2. Add the heartbeat port to the end of the hivemq.ports array:

      hivemq:
        ...
        ports:
          ...
          ...
          - name: "heartbeat"
            port: 9090
            expose: true
      
  6. Using Helm, install hivemq-operator from the local directory hivemq-operator which is containing updated operator templates, and use the updated my-values.yaml:

    helm upgrade my-hivemq \ 
      --install hivemq-operator \ 
      --values my-values.yaml 

  7. When the hivemq-operator and hivemq pods are ready, monitor the event.log:

    kubectl exec pod/my-hivemq-abcdefgh -- tail -f log/event.log

  • No labels