Skip to content

Commit 0dc0f6e

Browse files
authored
Create README.md
1 parent 7aa7b11 commit 0dc0f6e

File tree

1 file changed

+77
-0
lines changed

1 file changed

+77
-0
lines changed

README.md

+77
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
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

Comments
 (0)