Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

IBM MQ scaler doc #283

Merged
merged 14 commits into from
Oct 23, 2020
45 changes: 19 additions & 26 deletions content/docs/2.0/scalers/ibm-mq.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,3 @@
> © Copyright IBM Corporation 2020
>
> Licensed under the Apache License, Version 2.0 (the "License"); you
> may not use this file except in compliance with the License. You may
> obtain a copy of the License at
>
> http://www.apache.org/licenses/LICENSE-2.0
>
> Unless required by applicable law or agreed to in writing, software
> distributed under the License is distributed on an "AS IS" BASIS,
> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
> implied. See the License for the specific language governing
> permissions and limitations under the License.


+++
title = "IBM MQ"
layout = "scaler"
Expand All @@ -30,27 +15,33 @@ This specification describes the `ibmmq` trigger for IBM MQ Queue.
triggers:
- type: ibmmq
metadata:
queueLength: '5' # OPTIONAL - Queue length target for HPA. Default: 5 messages
host: <ibm-host> # REQUIRED - IBM MQ Queue Manager Admin REST Endpoint
queueManager: <queue-manager> # REQUIRED - Queue Manager
queueName: <queue-name> # REQUIRED - Queue Name
tlsDisabled: <TLS> # REQUIRED - Set 'true' to disable TLS.
queueManager: <queue-manager> # REQUIRED - Your queue manager
zroubalik marked this conversation as resolved.
Show resolved Hide resolved
queueName: <queue-name> # REQUIRED - Your queue name
tlsDisabled: <TLS enabled/disabled> # OPTIONAL - Set 'true' to disable TLS. Default: false
queueDepth: <queue-depth> # OPTIONAL - Queue depth target for HPA. Default: 5 messages
authenticationRef:
name: ibmmq-consumer-trigger
```

**Parameter list:**

- `queueLength`: OPTIONAL - Queue Length Target for HPA. Will be set to Default Value of 5 if not Provided.
- `host`: REQUIRED - IBM MQ Queue Manager Admin REST Endpoint. Example URI endpoint structure on IBM cloud `https://example.mq.appdomain.cloud/ibmmq/rest/v2/admin/action/qmgr/QM/mqsc`
- `queueName`: REQUIRED - Name of the Queue within the Queue Manager defined from which messages will be consumed


### Authentication Parameters

TriggerAuthentication CRD is used to connect and authenticate to IBM MQ:
tomkerkhove marked this conversation as resolved.
Show resolved Hide resolved
**Parameter list**
tomkerkhove marked this conversation as resolved.
Show resolved Hide resolved
- `host`: REQUIRED - IBM MQ Queue Manager Admin REST Endpoint. Example URI endpoint structure on IBM cloud `https://example.mq.appdomain.cloud/ibmmq/rest/v2/admin/action/qmgr/QM/mqsc`
- `queueManager`: REQUIRED - Name of the queue manager from which messages will be consumed
- `queueName`: REQUIRED - Name of the Queue within the Queue Manager defined from which messages will be consumed
- `tlsDisabled`: OPTIONAL - A boolean: Can be set to 'true' to disable TLS. False by default.
- `queueDepth`: OPTIONAL - Queue depth Target for HPA. Will be set to Default Value of 5 if not Provided.

**Authentication Parameters**
- `ADMIN_USER`: REQUIRED - The admin REST endpoint username for your MQ Queue Manager
- `ADMIN_PASSWORD`: REQUIRED - The admin REST endpoint API key for your MQ Queue Manager

### Example

```yaml
apiVersion: v1
kind: Secret
Expand All @@ -76,9 +67,11 @@ spec:
triggers:
- type: ibmmq
metadata:
queueLength: '5' # OPTIONAL - Depth of Queue per Replica Pod
host: <ibm-host> # REQUIRED - IBM MQ Queue Manager Admin REST Endpoint
queueName: <queue-name> # REQUIRED - Queue Name
queueManager: <queue-manager> # REQUIRED - Your queue manager
queueName: <queue-name> # REQUIRED - Your queue name
tlsDisabled: <TLS enabled/disabled> # OPTIONAL - Set 'true' to disable TLS. Default: false
queueDepth: <queue-depth> # OPTIONAL - Queue depth target for HPA. Default: 5 messages
authenticationRef:
name: keda-ibmmq-trigger-auth
---
Expand Down