[OpenShift Container Platform][IBM Cloud Pak for Integration]

QueueManager (mq.ibm.com/v1beta1) 的 API 参考

QueueManager

QueueManager 是 IBM MQ 服务器，用于向应用程序提供排队和发布/预订服务。 IBM MQ 文档: https://ibm.biz/BdPZqj。 许可证引用: https://ibm.biz/BdPZfq.。

字段 描述
apiVersion 字符串 APIVersion 定义对象的此表示的版本化模式。 服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。 更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources。
kind 字符串 种类是表示此对象所表示的 REST 资源的字符串值。 服务器可以从客户机向其提交请求的端点推断这一点。 Cannot be updated. In CamelCase. 更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-趋。
metadata  
spec QueueManagerSpec QueueManager的期望状态。
status QueueManagerStatus QueueManager的观察状态。

.规格

QueueManager的期望状态。

出现位置:
字段 描述
affinity 标准 Kubernetes 亲缘关系规则。 有关更多信息，请参阅 https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.17/#affinity-v1-core。
annotations 注释 注释字段充当 Pod 注释的传递。 用户可以向此字段添加任何注释，并将其应用于 Pod。 此处的注释将覆盖缺省注释 (如果提供)。 需要 MQ Operator 1.3.0 或更高版本。
imagePullSecrets LocalObjectReference 对同一名称空间中私钥的引用的可选列表，用于拉取此 QueueManager所使用的任何映像。 如果指定了这些私钥，那么这些私钥将传递到各个拉取器实现以供其使用。 例如，对于 docker ，仅接受 DockerConfig 类型的私钥。 有关更多信息，请参阅 https://kubernetes.io/docs/concepts/containers/images#specifying-imagepullsecrets-on-a-pod。
labels 标签 “标签”字段充当 Pod 标签的传递方式。 用户可以向此字段添加任何标签，并将其应用于 Pod。 此处的标签将覆盖缺省标签 (如果提供)。 需要 MQ Operator 1.3.0 或更高版本。
license 许可证 用于控制您接受许可证以及要使用的许可证度量的设置。
pki PKI 公用密钥基础结构设置，用于定义用于传输层安全性 (TLS) 或 MQ Advanced Message Security (AMS) 的密钥和证书。
queueManager QueueManagerConfig 队列管理器容器和底层队列管理器的设置。
securityContext SecurityContext 要添加到队列管理器 Pod 的 securityContext的安全设置。
telemetry 遥测 Open Telemetry 配置的设置。 需要 MQ 操作程序 2.2.0 或更高版本。
template 模板 Kubernetes 资源的高级模板。 该模板允许用户覆盖 MQ 生成底层 Kubernetes的方式，例如 StatefulSet,、Pod和Service。 这仅适用于高级用户，因为如果使用不正确，可能会中断 MQ 的正常操作。 在 QueueManager 资源中的任何其他位置指定的任何值都将被模板中的设置覆盖。
terminationGracePeriodSeconds 整数 Pod 需要正常终止的可选持续时间 (以秒为单位)。 值必须是非负整数。 值 0 指示立即删除。 尝试结束队列管理器的目标时间，将应用程序断开连接的阶段升级。 必要时，将中断基本队列管理器维护任务。 缺省为 30 秒。
tracing TracingConfig 用于跟踪与 Cloud Pak for Integration 操作仪表板的集成的设置。
version 字符串 用于控制将使用 (必需) 的 MQ 版本的设置。 例如: 9.1.5.0-r2 将使用容器映像的第二个修订版指定 MQ V 9.1.5.0。 特定于容器的修订通常在修订中应用，例如基本映像的修订。
web WebServerConfig MQ Web 服务器的设置。

.spec.annotations

注释字段充当 Pod 注释的传递。 用户可以向此字段添加任何注释，并将其应用于 Pod。 此处的注释将覆盖缺省注释 (如果提供)。 需要 MQ Operator 1.3.0 或更高版本。

出现位置:

.spec.imagePullSecrets

LocalObjectReference 包含足够的信息，可让您在同一命名空间内定位引用的对象。

出现位置:
字段 描述
name 字符串 引用的名称。 更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。 apiVersion,, kind, uid?

.spec.labels

“标签”字段充当 Pod 标签的传递方式。 用户可以向此字段添加任何标签，并将其应用于 Pod。 此处的标签将覆盖缺省标签 (如果提供)。 需要 MQ Operator 1.3.0 或更高版本。

出现位置:

.spec.license

用于控制您接受许可证以及要使用的许可证度量的设置。

出现位置:
字段 描述
accept 布尔值 是否接受与此软件关联的许可证 (必需)。
license 字符串 您正在接受的许可证的标识。 这必须是您正在使用的 MQ 版本的正确许可证标识。 请参阅 https://ibm.biz/BdPZfq 以获取有效值。
metric 字符串 用于指定要使用的许可证度量的设置。 例如， ProcessorValueUnit， VirtualProcessorCore 或 ManagedVirtualServer。 使用 MQ 许可证时缺省为 ProcessorValueUnit ，使用 Cloud Pak for Integration 许可证时缺省为 VirtualProcessorCore 。
use 字符串 用于控制软件使用方式的设置，其中许可证支持多次使用。 请参阅 https://ibm.biz/BdPZfq 以获取有效值。

.spec.pki

公用密钥基础结构设置，用于定义用于传输层安全性 (TLS) 或 MQ Advanced Message Security (AMS) 的密钥和证书。

出现位置:
字段 描述
keys PKISource 数组 要添加到队列管理器密钥存储库的专用密钥。
trust PKISource 数组 要添加到队列管理器密钥存储库的证书。

.spec.pki.keys

PKISSource 定义公用密钥基础结构信息 (例如密钥或证书) 的源。

出现位置:
字段 描述
name 字符串 名称用作密钥或证书的标签。 必须是小写字母数字字符串。
secret 私钥 使用 Kubernetes 密钥提供密钥。

.spec.pki.keys.secret

使用 Kubernetes 密钥提供密钥。

出现位置:
字段 描述
items 阵列 应该添加到队列管理器容器的 Kubernetes 私钥中的密钥。
secretName 字符串 Kubernetes 私钥的名称。

.spec.pki.trust

PKISSource 定义公用密钥基础结构信息 (例如密钥或证书) 的源。

出现位置:
字段 描述
name 字符串 名称用作密钥或证书的标签。 必须是小写字母数字字符串。
secret 私钥 使用 Kubernetes 密钥提供密钥。

.spec.pki.trust.secret

使用 Kubernetes 密钥提供密钥。

出现位置:
字段 描述
items 阵列 应该添加到队列管理器容器的 Kubernetes 私钥中的密钥。
secretName 字符串 Kubernetes 私钥的名称。

.spec.queueManager

队列管理器容器和底层队列管理器的设置。

出现位置:
字段 描述
availability 可用性 队列管理器的可用性设置，例如是否使用活动/备用对或本机高可用性。
debug 布尔值 是否将调试消息从特定于容器的代码记录到容器日志。 缺省值为 false。
image 字符串 将使用的容器映像。
imagePullPolicy 字符串 用于控制 kubelet 何时尝试拉取指定映像的设置。 缺省值为 IfNotPresent。
ini INISource 数组 用于为队列管理器提供 INI 的设置。 需要 MQ Operator 1.1.0 或更高版本。
livenessProbe QueueManagerLivenessProbe 用于控制活动性探测器的设置。
logFormat 字符串 要用于此容器的日志格式。 将 JSON 用于来自容器的 JSON 格式的日志。 将 Basic 用于文本格式的消息。 缺省值为 Basic。
metrics QueueManagerMetrics Prometheus样式度量的设置。
mqsc MQSCSource 数组 用于为队列管理器提供 MQSC 的设置。 需要 MQ Operator 1.1.0 或更高版本。
name 字符串 底层 MQ 队列管理器的名称 (如果与 metadata.name不同)。 如果需要不符合 Kubernetes 规则的队列管理器名称 (例如，包含大写字母的名称) ，请使用此字段。
readinessProbe QueueManagerReadinessProbe 用于控制就绪性探测器的设置。
recoveryLogs RecoveryLogs MQ 恢复日志的设置。 需要 MQ Operator 2.4.0 或更高版本。
resources 资源 用于控制资源需求的设置。
route 路由 队列管理器路由的设置。 需要 MQ 操作程序 1.4.0 或更高版本。
startupProbe StartupProbe 用于控制启动探测器的设置。 仅适用于 MultiInstance 和 NativeHA 部署。 需要 MQ Operator 1.5.0 或更高版本。
storage QueueManagerStorage 用于控制队列管理器对持久卷和存储类的使用的存储设置。

.spec.queueManager

队列管理器的可用性设置，例如是否使用活动/备用对或本机高可用性。

出现位置:
字段 描述
tls TLS 用于配置 NativeHA 副本之间的安全通信的可选 TLS 设置。 需要 MQ Operator 1.5.0 或更高版本。
type 字符串 要使用的可用性类型。 将 SingleInstance 用于单个 Pod ，这将由 Kubernetes自动重新启动 (在某些情况下)。 将 MultiInstance 用于一对 Pod ，其中一个是 active 队列管理器，另一个是备用 Pod。 将 NativeHA 用于本机高可用性复制 (需要 MQ 操作程序 1.5.0 或更高版本)。 缺省值为 SingleInstance。 有关更多详细信息，请参阅 http://ibm.biz/BdqAQa 。
updateStrategy 字符串 要用于 MultiInstance 和 NativeHA 队列管理器的更新策略。 使用 RollingUpdate 可在队列管理器配置更改时启用自动滚动更新。 使用 OnDelete 来禁用自动滚动更新，仅当删除 Pod (包括由外部因素触发的 Pod 删除) 时，才会应用队列管理器更改。 缺省值为 RollingUpdate。 需要 MQ 操作程序 1.6.0 或更高版本。

.spec.queueManager.availability.tls

用于配置 NativeHA 副本之间的安全通信的可选 TLS 设置。 需要 MQ Operator 1.5.0 或更高版本。

出现位置:
字段 描述
cipherSpec 字符串 NativeHA TLS 的 CipherSpec 的名称。
secretName 字符串 Kubernetes 私钥的名称。

.spec.queueManager

INI 配置文件的源。

出现位置:
字段 描述
configMap ConfigMapINISource ConfigMap 表示包含 INI 信息的 Kubernetes ConfigMap 。
secret SecretINISource 私钥表示包含 INI 信息的 Kubernetes 私钥。

.spec.queueManager.ini.configMap

ConfigMap 表示包含 INI 信息的 Kubernetes ConfigMap 。

出现位置:
字段 描述
items 阵列 应该应用的 Kubernetes 源中的密钥。
name 字符串 Kubernetes 源的名称。

.spec.queueManager.ini.secret

私钥表示包含 INI 信息的 Kubernetes 私钥。

出现位置:
字段 描述
items 阵列 应该应用的 Kubernetes 源中的密钥。
name 字符串 Kubernetes 源的名称。

.spec.queueManager.livenessProbe

用于控制活动性探测器的设置。

出现位置:
字段 描述
failureThreshold 整数 探测器在成功后被视为失败的最小连续失败次数。 缺省值为 1。
initialDelaySeconds 整数 在启动探测器之前容器已启动的秒数。 对于 SingleInstance，缺省为 90 秒。 对于 MultiInstance 和 NativeHA 部署，缺省为 0 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 10 秒。
successThreshold 整数 探测器在失败后被视为成功的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 5 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.queueManager.度量

Prometheus样式度量的设置。

出现位置:
字段 描述
enabled 布尔值 是否为兼容 Prometheus的度量值启用端点。 缺省值为 true。

.spec.queueManager.mqsc

MQSC 配置文件的源。

出现位置:
字段 描述
configMap ConfigMapMQSCSource ConfigMap 表示包含 MQSC 信息的 Kubernetes ConfigMap 。
secret SecretMQSCSource 私钥表示包含 MQSC 信息的 Kubernetes 私钥。

.spec.queueManager.mqsc.configMap

ConfigMap 表示包含 MQSC 信息的 Kubernetes ConfigMap 。

出现位置:
字段 描述
items 阵列 应该应用的 Kubernetes 源中的密钥。
name 字符串 Kubernetes 源的名称。

.spec.queueManager.mqsc.secret

私钥表示包含 MQSC 信息的 Kubernetes 私钥。

出现位置:
字段 描述
items 阵列 应该应用的 Kubernetes 源中的密钥。
name 字符串 Kubernetes 源的名称。

.spec.queueManager.readinessProbe

用于控制就绪性探测器的设置。

出现位置:
字段 描述
failureThreshold 整数 探测器在成功后被视为失败的最小连续失败次数。 缺省值为 1。
initialDelaySeconds 整数 在启动探测器之前容器已启动的秒数。 对于 SingleInstance，缺省为 10 秒。 对于 MultiInstance 和 NativeHA 部署，缺省为 0。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 5 秒。
successThreshold 整数 探测器在失败后被视为成功的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 3 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.queueManager.recoveryLogs

MQ 恢复日志的设置。 需要 MQ Operator 2.4.0 或更高版本。

出现位置:
字段 描述
logFilePages 整数 恢复日志数据保存在一系列文件中。 日志文件大小以 4 KB 页面为单位指定。

.spec.queueManager.资源

用于控制资源需求的设置。

出现位置:
字段 描述
limits 限制 CPU 和内存设置。
requests 请求 CPU 和内存设置。

.spec.queueManager.resources.limits

CPU 和内存设置。

出现位置:
字段 描述
cpu  
memory  

.spec.queueManager.resources.requests

CPU 和内存设置。

出现位置:
字段 描述
cpu  
memory  

.spec.queueManager

队列管理器路由的设置。 需要 MQ 操作程序 1.4.0 或更高版本。

出现位置:
字段 描述
enabled 布尔值 是否启用路由。 缺省值为 true。

.spec.queueManager.startupProbe

用于控制启动探测器的设置。 仅适用于 MultiInstance 和 NativeHA 部署。 需要 MQ Operator 1.5.0 或更高版本。

出现位置:
字段 描述
failureThreshold 整数 要视为失败的探测器的最小连续失败次数。 缺省值为 24。
initialDelaySeconds 整数 在启动探测器之前容器已启动的秒数。 缺省为 0 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 5 秒。
successThreshold 整数 要视为成功的探测器的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 5 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.queueManager

用于控制队列管理器对持久卷和存储类的使用的存储设置。

出现位置:
字段 描述
defaultClass 字符串 缺省情况下要应用于此队列管理器的所有持久卷的存储类。 特定持久卷可以定义自己的存储类，这将覆盖此缺省存储类设置。 如果 type of availability 是 SingleInstance 或 NativeHA ，则存储类可以是 ReadWriteOnce 或 ReadWriteMany 类型。 如果 type of availability 是 MultiInstance ，存储类必须是 ReadWriteMany 类型。
defaultDeleteClaim 布尔值 删除队列管理器时是否应删除所有卷。 特定的持久卷可以为 deleteClaim 定义自己的值，从而覆盖defaultDeleteClaim 设置。 缺省值为 false。
persistedData QueueManagerOptionalVolume MQ 持久数据的 PersistentVolume 详细信息，包括配置，队列和消息。 使用多实例队列管理器时必需。
queueManager QueueManagerVolume 通常在 /var/mqm下的任何数据的缺省 PersistentVolume 。 将包含所有持久数据和恢复日志 (如果未指定其他卷)。
recoveryLogs QueueManagerOptionalVolume MQ 恢复日志的持久卷详细信息。 使用多实例队列管理器时必需。
scratch 临时 队列管理器的 Scratch 临时卷的设置。 此卷将作为 "/run" 文件夹安装在容器上。 仅当根文件系统设置为只读时才适用。 需要 MQ 操作程序 3.0.0 或更高版本。
tmp 临时 队列管理器的 Tmp 临时卷的设置。 此卷将作为 "/tmp" 文件夹安装在容器上。 将在此卷中创建诊断数据文件，例如 runmqras 命令生成的 zip 文件。 仅当根文件系统设置为只读时才适用。 需要 MQ 操作程序 3.0.0 或更高版本。

.spec.queueManager.storage.persistedData

MQ 持久数据的 PersistentVolume 详细信息，包括配置，队列和消息。 使用多实例队列管理器时必需。

出现位置:
字段 描述
class 字符串 要用于此卷的存储类。 仅当 type 为 persistent-claim时才有效。 如果 type of availability 是 SingleInstance 或 NativeHA ，则存储类可以是 ReadWriteOnce 或 ReadWriteMany 类型。 如果 type of availability 是 MultiInstance ，存储类必须是 ReadWriteMany 类型。
deleteClaim 布尔值 删除队列管理器时是否应删除此卷。
enabled 布尔值 是应将此卷作为单独卷启用，还是将其放在缺省 queueManager 卷上。 缺省值为 false。
size 字符串 要传递到 Kubernetes的 PersistentVolume 的大小，包括 SI 单元。 仅当 type 为 persistent-claim时才有效。 例如，2Gi。 缺省值为 2Gi。
sizeLimit 字符串 使用 ephemeral 卷时的大小限制。 文件仍会写入临时目录，因此您可以使用此选项来限制大小。 仅当 type 为 ephemeral 且根文件系统设置为只读时才有效。 需要 MQ 操作程序 3.0.0 或更高版本。
type 字符串 要使用的卷的类型。 选择 ephemeral 以使用非持久存储器，或选择 persistent-claim 以使用持久卷。 缺省值为 persistent-claim。

.spec.queueManager.storage.queueManager

通常在 /var/mqm下的任何数据的缺省 PersistentVolume 。 将包含所有持久数据和恢复日志 (如果未指定其他卷)。

出现位置:
字段 描述
class 字符串 要用于此卷的存储类。 仅当 type 为 persistent-claim时才有效。 如果 type of availability 是 SingleInstance 或 NativeHA ，则存储类可以是 ReadWriteOnce 或 ReadWriteMany 类型。 如果 type of availability 是 MultiInstance ，存储类必须是 ReadWriteMany 类型。
deleteClaim 布尔值 删除队列管理器时是否应删除此卷。
size 字符串 要传递到 Kubernetes的 PersistentVolume 的大小，包括 SI 单元。 仅当 type 为 persistent-claim时才有效。 例如，2Gi。 缺省值为 2Gi。
sizeLimit 字符串 使用 ephemeral 卷时的大小限制。 文件仍会写入临时目录，因此您可以使用此选项来限制大小。 仅当 type 为 ephemeral 且根文件系统设置为只读时才有效。 需要 MQ 操作程序 3.0.0 或更高版本。
type 字符串 要使用的卷的类型。 选择 ephemeral 以使用非持久存储器，或选择 persistent-claim 以使用持久卷。 缺省值为 persistent-claim。

.spec.queueManager.storage.recoveryLogs

MQ 恢复日志的持久卷详细信息。 使用多实例队列管理器时必需。

出现位置:
字段 描述
class 字符串 要用于此卷的存储类。 仅当 type 为 persistent-claim时才有效。 如果 type of availability 是 SingleInstance 或 NativeHA ，则存储类可以是 ReadWriteOnce 或 ReadWriteMany 类型。 如果 type of availability 是 MultiInstance ，存储类必须是 ReadWriteMany 类型。
deleteClaim 布尔值 删除队列管理器时是否应删除此卷。
enabled 布尔值 是应将此卷作为单独卷启用，还是将其放在缺省 queueManager 卷上。 缺省值为 false。
size 字符串 要传递到 Kubernetes的 PersistentVolume 的大小，包括 SI 单元。 仅当 type 为 persistent-claim时才有效。 例如，2Gi。 缺省值为 2Gi。
sizeLimit 字符串 使用 ephemeral 卷时的大小限制。 文件仍会写入临时目录，因此您可以使用此选项来限制大小。 仅当 type 为 ephemeral 且根文件系统设置为只读时才有效。 需要 MQ 操作程序 3.0.0 或更高版本。
type 字符串 要使用的卷的类型。 选择 ephemeral 以使用非持久存储器，或选择 persistent-claim 以使用持久卷。 缺省值为 persistent-claim。

.spec.queueManager.storage.scratch

队列管理器的 Scratch 临时卷的设置。 此卷将作为 "/run" 文件夹安装在容器上。 仅当根文件系统设置为只读时才适用。 需要 MQ 操作程序 3.0.0 或更高版本。

出现位置:
字段 描述
sizeLimit 字符串 临时卷的大小限制，包括 SI 单元。 例如，2Gi。 仅当根文件系统设置为只读时才有效。 需要 MQ 操作程序 3.0.0 或更高版本。

.spec.queueManager.storage.tmp

队列管理器的 Tmp 临时卷的设置。 此卷将作为 "/tmp" 文件夹安装在容器上。 将在此卷中创建诊断数据文件，例如 runmqras 命令生成的 zip 文件。 仅当根文件系统设置为只读时才适用。 需要 MQ 操作程序 3.0.0 或更高版本。

出现位置:
字段 描述
sizeLimit 字符串 临时卷的大小限制，包括 SI 单元。 例如，2Gi。 仅当根文件系统设置为只读时才有效。 需要 MQ 操作程序 3.0.0 或更高版本。

.spec.securityContext

要添加到队列管理器 Pod 的 securityContext的安全设置。

出现位置:
字段 描述
fsGroup 整数 适用于 pod 中所有容器的特殊补充组。 某些卷类型允许 Kubelet 更改要由 pod 拥有的该卷的所有权: 1。 拥有的 GID 将是 FSGroup 2。 设置了 setgid 位 (在卷中创建的新文件将由 FSGroup 拥有) 3。 许可权位为 OR ' d with rw-rw ---- 如果未设置，那么 Kubelet 将不会修改任何卷的所有权和许可权。
initVolumeAsRoot 布尔值 这会影响初始化 PersistentVolume的容器所使用的 securityContext 。 如果您正在使用要求您作为 root 用户访问新供应的卷的存储器提供程序，请将此设置为 true 。 将此项设置为 true 会影响您可以使用的安全上下文约束 (SCC) 对象，如果您无权使用允许 root 用户的 SCC ，那么队列管理器可能无法启动。 缺省值为 false。 有关更多信息，请参阅 https://docs.openshift.com/container-platform/latest/authentication/managing-security-context-constraints.html。
readOnlyRootFilesystem 布尔值 是否为队列管理器启用只读根文件系统设置。 缺省值为 false。 需要 MQ 操作程序 3.0.0 或更高版本。
supplementalGroups 阵列 应用于每个容器中运行的第一个进程的组的列表，以及容器的主 GID。 如果未指定，那么不会向任何容器添加任何组。

.spec.telemetry

Open Telemetry 配置的设置。 需要 MQ 操作程序 2.2.0 或更高版本。

出现位置:
字段 描述
tracing 跟踪 开放式遥测跟踪的设置。

.spec.telemetry.tracing

开放式遥测跟踪的设置。

出现位置:
字段 描述
instana Instana Instana 跟踪的设置。

.spec.telemetry.tracing.instana

Instana 跟踪的设置。

出现位置:
字段 描述
agentHost 字符串 要向其发送跟踪数据的 Instana 代理程序的主机名。 这不应包含协议。
enabled 布尔值 是否启用 Instana 跟踪。 缺省值为 false。
protocol 字符串 要用于与 Instana 代理程序通信的协议。 支持 http 和 https。

.spec.template

Kubernetes 资源的高级模板。 该模板允许用户覆盖 MQ 生成底层 Kubernetes的方式，例如 StatefulSet,、Pod和Service。 这仅适用于高级用户，因为如果使用不正确，可能会中断 MQ 的正常操作。 在 QueueManager 资源中的任何其他位置指定的任何值都将被模板中的设置覆盖。

出现位置:
字段 描述
pod 用于 Pod 的模板的覆盖。 请参阅 https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.17/#podspec-v1-core。

.spec.tracing

用于跟踪与 Cloud Pak for Integration 操作仪表板的集成的设置。

出现位置:
字段 描述
agent TracingAgent 仅在 Cloud Pak for Integration 中，可以配置可选跟踪代理程序的设置。
collector TracingCollector 仅在 Cloud Pak for Integration 中，您可以配置可选跟踪收集器的设置。
enabled 布尔值 是否通过跟踪启用与 Cloud Pak for Integration 操作仪表板的集成。 缺省值为 false。
namespace 字符串 安装了 Cloud Pak for Integration 操作仪表板的名称空间。

.spec.tracing.agent

仅在 Cloud Pak for Integration 中，可以配置可选跟踪代理程序的设置。

出现位置:
字段 描述
image 字符串 将使用的容器映像。
imagePullPolicy 字符串 用于控制 kubelet 何时尝试拉取指定映像的设置。 缺省值为 IfNotPresent。
livenessProbe TracingProbe 用于控制活动性探测器的设置。
readinessProbe TracingProbe 用于控制就绪性探测器的设置。

.spec.tracing.agent.livenessProbe

用于控制活动性探测器的设置。

出现位置:
字段 描述
failureThreshold 整数 探测器在成功后被视为失败的最小连续失败次数。 缺省值为 1。
initialDelaySeconds 整数 在容器启动之后，启动活动性探测器之前的秒数。 缺省为 10 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 10 秒。
successThreshold 整数 探测器在失败后被视为成功的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 2 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.tracing.agent.readinessProbe

用于控制就绪性探测器的设置。

出现位置:
字段 描述
failureThreshold 整数 探测器在成功后被视为失败的最小连续失败次数。 缺省值为 1。
initialDelaySeconds 整数 在容器启动之后，启动活动性探测器之前的秒数。 缺省为 10 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 10 秒。
successThreshold 整数 探测器在失败后被视为成功的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 2 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.tracing.collector

仅在 Cloud Pak for Integration 中，您可以配置可选跟踪收集器的设置。

出现位置:
字段 描述
image 字符串 将使用的容器映像。
imagePullPolicy 字符串 用于控制 kubelet 何时尝试拉取指定映像的设置。 缺省值为 IfNotPresent。
livenessProbe TracingProbe 用于控制活动性探测器的设置。
readinessProbe TracingProbe 用于控制就绪性探测器的设置。

.spec.tracing.collector.livenessProbe

用于控制活动性探测器的设置。

出现位置:
字段 描述
failureThreshold 整数 探测器在成功后被视为失败的最小连续失败次数。 缺省值为 1。
initialDelaySeconds 整数 在容器启动之后，启动活动性探测器之前的秒数。 缺省为 10 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 10 秒。
successThreshold 整数 探测器在失败后被视为成功的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 2 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.tracing.collector.readinessProbe

用于控制就绪性探测器的设置。

出现位置:
字段 描述
failureThreshold 整数 探测器在成功后被视为失败的最小连续失败次数。 缺省值为 1。
initialDelaySeconds 整数 在容器启动之后，启动活动性探测器之前的秒数。 缺省为 10 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。
periodSeconds 整数 执行探测的频率（以秒计）。 缺省为 10 秒。
successThreshold 整数 探测器在失败后被视为成功的最小连续成功次数。 缺省值为 1。
timeoutSeconds 整数 秒数，经过此秒数之后探测就会超时。 缺省为 2 秒。 更多信息: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes。

.spec.web

MQ Web 服务器的设置。

出现位置:
字段 描述
console 控制台 MQ Web 控制台的设置。 需要 MQ 操作程序 3.0.0 或更高版本。
enabled 布尔值 是否启用 Web 服务器。 缺省值为 false。
manualConfig ManualConfig 用于提供 Web 服务器 XML 配置的设置。 需要 MQ 操作程序 3.0.0 或更高版本。

.spec.web.console

MQ Web 控制台的设置。 需要 MQ 操作程序 3.0.0 或更高版本。

出现位置:
字段 描述
authentication 认证 MQ Web 控制台的认证设置。 需要 MQ 操作程序 3.0.0 或更高版本。
authorization 授权 MQ Web 控制台的授权设置。 需要 MQ 操作程序 3.0.0 或更高版本。

.spec.web.console.authentication

MQ Web 控制台的认证设置。 需要 MQ 操作程序 3.0.0 或更高版本。

出现位置:
字段 描述
provider 字符串 要用于 MQ Web 控制台的认证提供程序。 使用 integration-keycloak 可将单点登录与 Cloud Pak for Integration Platform UI (Keycloak) 配合使用。 如果使用 Cloud Pak for Integration 许可证，那么缺省为 integration-keycloak ; 如果使用 MQ 许可证，那么缺省为 manual 。 如果要提供您自己的配置，请使用 manual 。

.spec.web.console.authorization

MQ Web 控制台的授权设置。 需要 MQ 操作程序 3.0.0 或更高版本。

出现位置:
字段 描述
provider 字符串 要用于 MQ Web 控制台的授权提供程序。 使用 integration-keycloak 可使用 Cloud Pak for Integration Keycloak提供的角色。 如果要提供您自己的配置，请使用 manual 。 如果使用 Cloud Pak for Integration 许可证，那么缺省为 integration-keycloak ; 如果使用 MQ 许可证，那么缺省为 manual 。

.spec.web.manualConfig

用于提供 Web 服务器 XML 配置的设置。 需要 MQ 操作程序 3.0.0 或更高版本。

出现位置:
字段 描述
configMap ConfigMap ConfigMap 表示包含 Web 服务器 XML 配置的 Kubernetes ConfigMap 。
secret 私钥 私钥表示包含 Web 服务器 XML 配置的 Kubernetes 私钥。 使用 Secret 可保护 Kubernetes 层中的任何凭证，但监视或故障诊断工具可能会过早地公开底层文件。 为了提高安全性，请使用 “securityUtility” 对凭证进行编码。

.spec.web.manualConfig.configMap

ConfigMap 表示包含 Web 服务器 XML 配置的 Kubernetes ConfigMap 。

出现位置:
字段 描述
name 字符串 Kubernetes 源的名称。

.spec.web.manualConfig.secret

私钥表示包含 Web 服务器 XML 配置的 Kubernetes 私钥。 使用 Secret 可保护 Kubernetes 层中的任何凭证，但监视或故障诊断工具可能会过早地公开底层文件。 为了提高安全性，请使用 “securityUtility” 对凭证进行编码。

出现位置:
字段 描述
name 字符串 Kubernetes 源的名称。

.状态

QueueManager的观察状态。

出现位置:
字段 描述
adminUiUrl 字符串 管理URL。
availability 可用性 队列管理器的可用性状态。
conditions QueueManagerStatusCondition 条件表示队列管理器状态的最新可用观察值。
endpoints QueueManagerStatusEndpoint 有关此队列管理器正在公开的端点 (例如 API 或 UI 端点) 的信息。
metadata 元数据 元数据表示队列管理器的其他信息，包括集成-Keycloak 状态。
name 字符串 队列管理器的名称。
phase 字符串 队列管理器状态的阶段。
versions QueueManagerStatusVersion 正在使用的 MQ 版本以及 IBM 授权注册表中提供的其他版本。

.status.availability

队列管理器的可用性状态。

出现位置:
字段 描述
initialQuorumEstablished 布尔值 是否已为 NativeHA建立初始定额。

.status.conditions

QueueManagerStatusCondition 定义了队列管理器的条件。

出现位置:
字段 描述
lastTransitionTime 字符串 上次将条件从一个状态转换为另一个状态的时间。
message 字符串 指示有关上次转换的详细信息的人类可读消息。
reason 字符串 最近一次转换此状态的原因。
status 字符串 条件的状态。
type 字符串 条件的类型。

.status.endpoints

QueueManagerStatusEndpoint 定义了 QueueManager 的端点。

出现位置:
字段 描述
name 字符串 端点的名称。
type 字符串 端点的类型，例如UI端点为“UI”，API端点为“API”，API文档为 'OpenAPI' ”。
uri 字符串 端点的 URI。

.status.metadata

元数据表示队列管理器的其他信息，包括集成-Keycloak 状态。

出现位置:
字段 描述
integrationKeycloak IntegrationKeycloak QueueManagerStatusIntegrationKeycloak 定义了 QueueManagerKeycloak 状态。

.status.metadata.integrationKeycloak

QueueManagerStatusIntegrationKeycloak 定义了 QueueManagerKeycloak 状态。

出现位置:
字段 描述
clientName 字符串  

.status.versions

正在使用的 MQ 版本以及 IBM 授权注册表中提供的其他版本。

出现位置:
字段 描述
available QueueManagerStatusVersionAvailable 其他版本的 MQ 可从 IBM Entitled Registry 获取。
reconciled 字符串 正在使用的 IBM MQ 的特定版本。 如果指定了定制映像，那么这可能与实际使用的 MQ 版本不匹配。

.status.versions.available

其他版本的 MQ 可从 IBM Entitled Registry 获取。

出现位置:
字段 描述
channels 阵列 可用于自动更新 MQ 版本的通道。
versions 版本 数组 可用的特定 MQ 版本。

.status.versions.available.versions

QueueManagerStatusVersion 定义了 MQ版本。

出现位置:
字段 描述
licenses 许可证 数组 适用于此版本的 QueueManager的许可证。
name 字符串 此版本的 QueueManager的版本 name 。 这些是 spec.version 字段的有效值。

.status.versions.available.versions.licenses

QueueManagerStatusLicense 定义了许可证。

出现位置:
字段 描述
displayName 字符串 许可证的显示名称。
link 字符串 许可证内容的链接。
matchesCurrentType 布尔值 许可证是否与当前使用的许可证类型匹配。
name 字符串 许可证的名称。