IBM MQ Advanced for Developers コンテナー・イメージ

IBM® MQ Advanced for Developersでは、事前作成されたコンテナー・イメージを使用できます。このイメージは、 IBM Container Registryから入手できます。このイメージは、 Docker、 Podman、 Kubernetes、およびその他のコンテナー環境での使用に適しています。

注: IBM MQ Advanced for Developers イメージは以前は Docker Hub から入手できましたが、これは非推奨であり、 Docker Hub ではこれ以上の更新は提供されません。

使用可能なイメージ

IBM MQ イメージは、 IBM Container Registryに保管されます。

IBM MQ Advanced for Developers 9.3.0.25: icr.io/ibm-messaging/mq:9.3.0.25-r1
IBM MQ Advanced for Developers 9.3.5.1: icr.io/ibm-messaging/mq:9.3.5.1-r2

クイック・リファレンス

ライセンス:
- IBM MQ Advanced for Developers および Apache License 2.0。 IBM MQ Advanced for Developers ライセンスでは、これ以上の配布は許可されず、条件によって開発者マシンの使用が制限されることに注意してください。
問題のファイリング先:
- GitHub
以下の CPU アーキテクチャーで使用可能です。
- amd64
- s390x
- ppc64le

使用法

コンテナーで IBM MQ Advanced for Developers を実行します。

コンテナーの実行方法について詳しくは、使用法の資料を参照してください。

イメージを使用できるようにするには、 LICENSE 環境変数を設定して、 IBM MQ ライセンスの条項に同意する必要があります。

サポートされる環境変数

LANG: ライセンスの印刷に使用する言語を設定します。
LICENSE: IBM MQ Advanced for Developers ライセンス条件に同意するには、 accept を設定します。; ライセンス条件を表示するには、 view を設定します。
log_format: 非推奨: MQ_LOGGING_CONSOLE_FORMATに置き換えられました。; コンテナーの stdout ロケーションに出力されるログのフォーマットを変更します。; 単純な人間が理解できる形式を使用するには、 basic を設定します。これがデフォルト値です。; JSON 形式 (各行に 1 つの JSON オブジェクト) を使用するように json を設定します。
MQ_ADMIN_PASSWORD: 管理ユーザーのパスワードを指定します。; 長さは 8 文字以上でなければなりません。; admin ユーザーのデフォルト・パスワードはありません。 3.0.0より前の IBM MQ Operator バージョンの場合、デフォルト値は passw0rdです。; IBM MQ 9.3.4以降、この変数は推奨されなくなりました。このトピックの YAML の例は、この変数を自分で作成し、シークレットで保護する方法を示しています。
MQ_APP_PASSWORD: アプリ・ユーザーのパスワードを指定します。; これを設定すると、 DEV.APP.SVRCONN チャネルが保護され、有効なユーザー ID とパスワードを提供する接続のみが許可されます。; 長さは 8 文字以上でなければなりません。; アプリ・ユーザーのデフォルト・パスワードはありません。 IBM MQ Operator のバージョン3.0.0 より前の場合、 MQのデフォルト値は空白（パスワード不要）で、 HTTPのデフォルト値 passw0rd です。; IBM MQ 9.3.4以降、この変数は推奨されなくなりました。このトピックの YAML の例は、この変数を自分で作成し、シークレットで保護する方法を示しています。
MQ_DEV: 作成中のデフォルト・オブジェクトを停止するには、 false に設定します。
MQ_ENABLE_METRICS: true に設定すると、キュー・マネージャーの Prometheus メトリックが生成されます。
MQ_LOGGING_CONSOLE_SOURCE: コンテナーの stdout ロケーションにミラーリングされるログのソースのコンマ区切りリストを指定します。; 有効な値は qmgr および webです。; デフォルト値は qmgr, webです。
MQ_LOGGING_CONSOLE_FORMAT: LOG_FORMATを置き換えます。; コンテナーの stdout ロケーションに出力されるログのフォーマットを変更します。; 単純な人間が理解できる形式を使用するには、 basic を設定します。これがデフォルト値です。; JSON 形式 (各行に 1 つの JSON オブジェクト) を使用するように json を設定します。
MQ_LOGGING_CONSOLE_EXCLUDE_ID: 除外するログ・メッセージのメッセージ ID のコンマ区切りリストを指定します。; ログ・メッセージは引き続きディスク上のログ・ファイルに表示されますが、コンテナーの stdout ロケーションには出力されません。; デフォルト値は AMQ5041I,AMQ5052I,AMQ5051I,AMQ5037I,AMQ5975Iです。
mq_qmgr_name: キュー・マネージャーの作成に使用する名前を設定します。

IBM MQ Advanced for Developers イメージでサポートされるデフォルトの開発者構成について詳しくは、デフォルトの開発者構成の資料を参照してください。

admin および app ユーザーのパスワードを指定する方法を説明するキュー・マネージャー YAML の例

IBM MQ 9.3.4以降、 admin および app のユーザー ID にデフォルトのパスワードが設定されなくなりました。これらのユーザーについては、 Development ライセンスを使用してキュー・マネージャーをデプロイするときにパスワードを指定する必要があります。 IBM MQ Operatorでこれを行う方法を示すキュー・マネージャー YAML の例を以下に示します。

以下のコマンドは、 admin および app ユーザーのパスワードを含むシークレットを作成します。

oc create secret generic my-mq-dev-passwords --from-literal=dev-admin-password=passw0rd --from-literal=dev-app-password=passw0rd

以下の YAML は、キュー・マネージャーのデプロイ時にこれらのパスワードを使用します。

apiVersion: mq.ibm.com/v1beta1
kind: QueueManager
metadata:
  name: qm-dev
spec:
  license:
    accept: false
    license: L-AXAF-JLZ53A
    use: Development
  web:
    enabled: true
  template:
    pod:
      containers:
        - env:
            - name: MQ_DEV
              value: "true"
            - name: MQ_CONNAUTH_USE_HTP
              value: "true"
            - name: MQ_ADMIN_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: my-mq-dev-passwords
                  key: dev-admin-password
            - name: MQ_APP_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: my-mq-dev-passwords
                  key: dev-app-password
          name: qmgr
  queueManager:
    storage:
      queueManager:
        type: persistent-claim
    name: QUICKSTART
  version: 9.3.5.1-r2