はじめに

MQ30周年おめでとうございます！
ということで（？）MQ入門の入り口になるようなコンテンツを目指して。。。
簡単にデモ環境つくって、メッセージキューイングを体験してみます。

MQとは

メッセージキューイングアプリケーションです。
いわゆるシステム間連携で使用するもので、オンブレとクラウドとの間のデータ連携や
システムとシステムとのつなぐ仲立ちをするものになります。
いまや世の中にある様々なシステムの裏側で活躍する縁の下の力持ちです。

やりたいこと

そんなメッセージキューイングを体感するためローカルにコンテナ環境を作り。
以下システム構成でメッセージのやりとりをしてみました。今回はcURLコマンドを使用して
REST APIで「Hello MQ!!」というメッセージを送受信してみます。

※以下図における「アプリ」はcURLコマンドを指します。

私の環境

Windows11 Pro
Docker for Business

事前準備

Docker（またはpodman）

構築

永続ボリュームを作って、MQコンテナ起動

C:\Users\hogehoge>docker volume create qm1v
C:\Users\hogehoge>docker run -d --name mymq -v qm1v:/mnt/mqm -e LICENSE=accept -e MQ_QMGR_NAME=QM1 -p 9443:9443  icr.io/ibm-messaging/mq:9.3.2.0-r2

コンテナIDを確認して、動作確認

# CONTAINER IDを確認
C:\Users\hogehoge>docker ps
CONTAINER ID   IMAGE                                COMMAND   CREATED      STATUS         PORTS                NAMES
eaed19cf19a4   icr.io/ibm-messaging/mq:9.3.2.0-r2   ""        2 days ago   Up 3 seconds   1414/tcp, 9443/tcp   mymq

※上記コマンドから「eaed19cf19a4」とわかる

# コンテナIDを指定して実行
C:\Users\hogehoge>docker exec -it eaed19cf19a4 dspmq
QMNAME(QM1)                                               STATUS(Running)

REST APIのエンドポイントを確認

# PC側で実行
C:\Users\hogehoge>docker exec -it eaed19cf19a4 /bin/bash
# コンテナ内で実行
$ dspmqweb status
MQWB1124I: Server 'mqweb' is running.
URLS:
  https://eaed19cf19a4:9443/ibmmq/console/
  https://eaed19cf19a4:9443/ibmmq/rest/

※上記で「https://eaed19cf19a4:9443」となっているが
コンテナで実行しているため「https://localhost:9443」となる。

ブラウザでMQ Web Consoleの動作確認

https://localhost:9443/ibmmq/console/
（admin/passw0rdでログイン）
※警告が出るが無視してログイン

RESTAPI実行のために事前認証（トークン認証）

# app/passw0rdでログイン。ローカルPC側のCookieに認証情報を保存する
C:\Users\hogehoge>curl -k https://localhost:9443/ibmmq/rest/v2/login -X POST -H "Content-Type: application/json; charset=UTF-8" -d "{\"username\":\"app\",\"password\":\"passw0rd\"}" -c c:\users\hogehoge\cookiejar.txt

メッセージ送受信

# 送信
C:\Users\hogehoge>curl -k https://localhost:9443/ibmmq/rest/v2/messaging/qmgr/QM1/queue/DEV.QUEUE.1/message -X POST -b c:\users\hogehoge\cookiejar.txt -H "ibm-mq-rest-csrf-token: value" -H "Content-Type: text/plain;charset=utf-8" --data "Hello MQ!!"

# 受信
C:\Users\hogehoge>curl -k https://localhost:9443/ibmmq/rest/v2/messaging/qmgr/QM1/queue/DEV.QUEUE.1/message -b c:\users\hogehoge\cookiejar.txt -H "ibm-mq-rest-csrf-token: value" -H "Content-Type: text/plain;charset=utf-8"
Hello MQ!!

コンソールに「Hello MQ!!」となればOK。メッセージ受信できています。

最後に

ということで、ここまでMQコンテナを使って、メッセージキューを体験してみましたがいかがでしたか？
今回はコマンドでメッセージの送受信をしたので、ものすごくシンプルであっさりした見た目になりましたが・・・
でもメッセージキューはシステムにおける重要なファクターであることを忘れないであげてください。。。
次回はローカルコンテナではなく、クラウド上で同じことをやってみたいと思います。お楽しみに。