|
| 1 | +# mq-infra |
| 2 | + |
| 3 | +This project contains necessary artifacts for deploying queuemanager on Openshift. |
| 4 | + |
| 5 | +## Table of Contents |
| 6 | + |
| 7 | +* [Introduction](#introduction) |
| 8 | +* [Pre-requisites](#pre-requisites) |
| 9 | +* [Deploy Queuemanager](#deploy-queuemanager) |
| 10 | +* [Conclusion](#conclusion) |
| 11 | +* [References](#references) |
| 12 | + |
| 13 | +## Introduction |
| 14 | + |
| 15 | +This guide provides a walkthrough on how to set up an Queuemanager. The Github repository is a template containing a Dockerfile and Helm Chart which is used with the [Cloud Native Toolkit](https://cloudnativetoolkit.dev/) to register a Tekton pipeline to build a Queuemanager image and deploy it on a containerized instance of IBM MQ. |
| 16 | + |
| 17 | +This repo contains the below artifacts. |
| 18 | + |
| 19 | + |
| 20 | +``` |
| 21 | +. |
| 22 | +├── Dockerfile |
| 23 | +├── chart |
| 24 | +│ └── base |
| 25 | +│ ├── Chart.yaml |
| 26 | +│ ├── .helmignore |
| 27 | +│ ├── templates |
| 28 | +│ │ ├── NOTES.txt |
| 29 | +│ │ ├── _helpers.tpl |
| 30 | +│ │ └── qm-template.yaml |
| 31 | +│ └── values.yaml |
| 32 | +└── config example |
| 33 | +``` |
| 34 | + |
| 35 | +- `ibm-mqadvanced-server-integration` docker image that comes with CloudPaks. This image can be further customized if we need additional configurations that are part of queuemanager. |
| 36 | +- `Helm Charts` - Currently, we are using quickstart template for deploying the queuemanager. |
| 37 | +- `Configurations` - Like mentioned earlier, the configurations can be embedded as part of Dockerfile. Alternatively, they can also be injected as configmaps. |
| 38 | + |
| 39 | +## Pre-requisites |
| 40 | + |
| 41 | +- [IBM Catalog Operator](https://www.ibm.com/docs/en/app-connect/11.0.0?topic=iicia-enabling-operator-catalog-cloud-pak-foundational-services-operator) |
| 42 | +- [IBM Common Services](https://github.com/IBM/ibm-common-service-operator) |
| 43 | +- [IBM MQ Operator](https://www.ibm.com/docs/en/ibm-mq/9.2?topic=integration-using-mq-in-cloud-pak-openshift) |
| 44 | +- [Cloudnative toolkit](https://cloudnativetoolkit.dev/overview) |
| 45 | + |
| 46 | +## Deploy Queuemanager |
| 47 | + |
| 48 | +- Clone the repository locally. |
| 49 | +``` |
| 50 | + git clone https://github.com/cloud-native-toolkit/mq-infra.git |
| 51 | + cd mq-infra |
| 52 | +``` |
| 53 | + |
| 54 | +- Create a new project. |
| 55 | + |
| 56 | +``` |
| 57 | +oc sync dev |
| 58 | +``` |
| 59 | + |
| 60 | +- Run the pipeline. |
| 61 | +``` |
| 62 | +oc pipeline --tekton |
| 63 | +``` |
| 64 | + |
| 65 | +- Enter git credentials. |
| 66 | + - Use down/up arrow and select `ibm-mq`. |
| 67 | + - Hit Enter to enable image scanning. |
| 68 | + - Open the url to see the pipeline running in the OpenShift Console. |
| 69 | + |
| 70 | +- Verify that Pipeline Run completed successfully. |
| 71 | + |
| 72 | +- To make sure the queuemanager is successfully deployed, run `oc get queuemanager`. |
| 73 | + |
| 74 | + |
| 75 | + |
| 76 | + |
| 77 | + |
0 commit comments