mq-container

module

v9.1.3+incompatible Latest Latest Go to latest Published: Jul 24, 2019 License: Apache-2.0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/ibm-messaging/mq-container

Links

Open Source Insights

README ¶

IBM MQ container

Note: The master branch may be in an unstable or even broken state during development. To get a stable version, please use the correct branch for your MQ version, instead of the master branch.

Overview

Run IBM® MQ in a container.

You can build an image containing either IBM MQ Advanced, or IBM MQ Advanced for Developers. The developer image includes a default developer configuration, to make it easier to get started. There is also an incubating folder for additional images for other MQ components, which you might find useful.

Build

After extracting the code from this repository, you can follow the build documentation to build an image.

Usage

See the usage documentation for details on how to run a container.

Note that in order to use the image, it is necessary to accept the terms of the IBM MQ license.

Environment variables supported by this image

LICENSE - Set this to accept to agree to the MQ Advanced for Developers license. If you wish to see the license you can set this to view.
LANG - Set this to the language you would like the license to be printed in.
MQ_QMGR_NAME - Set this to the name you want your Queue Manager to be created with.
LOG_FORMAT - Set this to change the format of the logs which are printed on the container's stdout. Set to "json" to use JSON format (JSON object per line); set to "basic" to use a simple human-readable format. Defaults to "basic".
MQ_ENABLE_METRICS - Set this to true to generate Prometheus metrics for your Queue Manager.

See the default developer configuration docs for the extra environment variables supported by the MQ Advanced for Developers image.

Kubernetes

If you want to use IBM MQ in Kubernetes, you can find an example Helm chart here: IBM charts. This can be used to run the container on a cluster, such as IBM Cloud Private or the IBM Cloud Kubernetes Service.

Issues and contributions

For issues relating specifically to the container image or Helm chart, please use the GitHub issue tracker. If you do submit a Pull Request related to this Docker image, please indicate in the Pull Request that you accept and agree to be bound by the terms of the IBM Contributor License Agreement.

License

The Dockerfiles and associated code and scripts are licensed under the Apache License 2.0. Licenses for the products installed within the images are as follows:

IBM MQ Advanced for Developers (International License Agreement for Non-Warranted Programs). This license may be viewed from an image using the LICENSE=view environment variable as described above or by following the link above.
IBM MQ Advanced (International Program License Agreement). This license may be viewed from an image using the LICENSE=view environment variable as described above or by following the link above.
License information for Ubuntu packages may be found in /usr/share/doc/${package}/copyright

Note: The IBM MQ Advanced for Developers license does not permit further distribution and the terms restrict usage to a developer machine.

Copyright

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
chkmqhealthy chkmqhealthy checks that MQ is healthy, by checking the output of the "dspmq" command	chkmqhealthy checks that MQ is healthy, by checking the output of the "dspmq" command
chkmqready chkmqready checks that MQ is ready for work, by checking if the MQ listener port is available	chkmqready checks that MQ is ready for work, by checking if the MQ listener port is available
runmqdevserver © Copyright IBM Corporation 2018, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2018, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
runmqserver © Copyright IBM Corporation 2017, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2017, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
internal
command Package command contains code to run external commands	Package command contains code to run external commands
containerruntime © Copyright IBM Corporation 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
containerruntimelogger © Copyright IBM Corporation 2017, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2017, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
copy
filecheck
keystore Package keystore contains code to create and update keystores	Package keystore contains code to create and update keystores
logger Package logger provides utility functions for logging purposes	Package logger provides utility functions for logging purposes
metrics Package metrics contains code to provide metrics for the queue manager Package metrics contains code to provide metrics for the queue manager Package metrics contains code to provide metrics for the queue manager Package metrics contains code to provide metrics for the queue manager	Package metrics contains code to provide metrics for the queue manager Package metrics contains code to provide metrics for the queue manager Package metrics contains code to provide metrics for the queue manager Package metrics contains code to provide metrics for the queue manager
mqini Package mqini provides information about queue managers	Package mqini provides information about queue managers
mqscredact
mqtemplate Package mqtemplate contains code to process template files	Package mqtemplate contains code to process template files
name Package name contains code to manage the queue manager name	Package name contains code to manage the queue manager name
ready Package ready contains code to provide a ready signal mechanism between processes	Package ready contains code to provide a ready signal mechanism between processes
tls © Copyright IBM Corporation 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
user © Copyright IBM Corporation 2018, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2018, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
test
docker © Copyright IBM Corporation 2017, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.	© Copyright IBM Corporation 2017, 2019 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
container Module