Files
mq-container/charts/mq-devserver/README.md
2017-09-14 11:05:45 +01:00

5.3 KiB

IBM MQ

IBM® MQ is messaging middleware that simplifies and accelerates the integration of diverse applications and business data across multiple platforms. It uses message queues to facilitate the exchanges of information and offers a single messaging solution for cloud, mobile, Internet of Things (IoT) and on-premises environments.

Introduction

This chart deploys a single IBM MQ Advanced for Developers server (queue manager) into an IBM Cloud private or other Kubernetes environment.

Prerequisites

  • Kubernetes 1.5 or greater, with beta APIs enabled
  • If persistence is enabled (see configuration), then you either need to create a PersistentVolume, or specify a Storage Class if classes are defined in your cluster.

Installing the Chart

To install the chart with the release name foo:

helm install --name foo stable/mq-devserver --set license=accept

This command accepts the IBM MQ Advanced for Developers license and deploys an MQ Advanced for Developers server on the Kubernetes cluster. The configuration section lists the parameters that can be configured during installation.

Tip

: See all the resources deployed by the chart using kubectl get all -l release=foo

Uninstalling the Chart

To uninstall/delete the foo release:

helm delete foo

The command removes all the Kubernetes components associated with the chart, except any Persistent Volume Claims (PVCs). This is the default behavior of Kubernetes, and ensures that valuable data is not deleted. In order to delete the Queue Manager's data, you can delete the PVC using the following command:

kubectl delete pvc -l release=foo

Configuration

The following table lists the configurable parameters of the mq-advancedserver chart and their default values.

Parameter Description Default
license Set to accept to accept the terms of the IBM license not accepted
image.repository Image full name including repository ibmcom/mq
image.tag Image tag 9
image.pullPolicy Image pull policy IfNotPresent
image.pullSecret Image pull secret, if you are using a private Docker registry nil
data.persistence.enabled Use a PersistentVolume to persist MQ data (under /var/mqm) true
data.persistence.storageClass Storage class of backing Persistent Volume nil
data.persistence.size Size of data volume 2Gi
service.name Name of the Kubernetes service to create qmgr
service.type Kubernetes service type exposing ports, e.g. NodePort ClusterIP
resources.limits.cpu Kubernetes CPU limit for the Queue Manager container 500m
resources.limits.memory Kubernetes memory limit for the Queue Manager container 512Mi
resources.requests.cpu Kubernetes CPU request for the Queue Manager container 500m
resources.requests.memory Kubernetes memory request for the Queue Manager container 512Mi
queueManager.name MQ Queue Manager name Helm release name
queueManager.dev.adminPassword Developer defaults - administrator password Random generated string. See the notes that appear when you install for how to retrieve this.
queueManager.dev.appPassword Developer defaults - app password nil (no password required to connect an MQ client)
nameOverride Set to partially override the resource names used in this chart nil

Specify each parameter using the --set key=value[,key=value] argument to helm install.

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart.

Tip

: You can use the default values.yaml

Persistence

The chart mounts a Persistent Volume.

Copyright

© Copyright IBM Corporation 2017