IBM MQ Advanced for Developers 容器映像 (container image)

预构建的容器映像可用于 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 许可证 2.0。请注意， IBM MQ Advanced for Developers 许可证不允许进一步分发，并且这些条款限制开发者机器的使用。
记录问题的位置:
- GitHub
可用于以下 CPU 体系结构:
- amd64
- s390x
- ppc64le

用法

在容器中运行 IBM MQ Advanced for Developers 。

有关如何运行容器的详细信息，请参阅使用情况文档。

要能够使用该映像，必须通过设置 LICENSE 环境变量来接受 IBM MQ 许可证的条款。

支持的环境变量

LANG: 设置要打印许可证的语言。
许可证: 设置 accept 以同意 IBM MQ Advanced for Developers 许可证条件。; 设置 view 以查看许可证条件。
log_format: 不推荐: 由 MQ_LOGGING_CONSOLE_FORMAT取代。; 更改打印到容器的 stdout 位置的日志的格式。; 设置 basic 以使用简单的人类可读格式。这是缺省值。; 设置 json 以使用 JSON 格式 (每行一个 JSON 对象)。
MQ_ADMIN_PASSWORD: 指定管理用户的密码。; 长度必须至少为 8 个字符。; 没有管理员用户的缺省密码。对于 3.0.0之前的 IBM MQ Operator 版本，缺省值为 passw0rd。; 从 IBM MQ 9.3.4开始，不推荐使用此变量。本主题中的示例 YAML 显示如何自行创建此变量并使用私钥对其进行保护。
MQ_APP_PASSWORD: 指定应用程序用户的密码。; 如果设置了此属性，那么将使 DEV.APP.SVRCONN 通道成为安全通道，并且仅允许提供有效用户标识和密码的连接。; 长度必须至少为 8 个字符。; 没有应用程序用户的缺省密码。对于 3.0.0 之前的 IBM MQ Operator 版本， 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 以使用 JSON 格式 (每行一个 JSON 对象)。
mq_logging_console_exclude_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 用户标识不再具有缺省密码。对于这些用户，您必须在使用 Development 许可证部署队列管理器时提供密码。以下是一个示例队列管理器 YAML ，它向您显示如何使用 IBM MQ Operator执行此操作。

以下命令将创建包含 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