There are minimal dependencies to meet on your own computer to use the CLI:
- Bash (v4)
- OpenShift client
- IBMCloud client with container plugin enabled
- Ansible
- Python
- Network access to the OpenShift cluster
The best way to use the CLI is via the container image: docker run -ti -v ~:/mnt/home --pull always quay.io/ibmmas/cli
.
All settings can be controlled via environment variables to avoid needing to manually type them out, for example if you export IBM_ENTITLEMENT_KEY=xxxx
then when you run the install that input will be prefilled with the value from the environment variable, allowing you to press Enter to continue, or modify the value if you need to. Most commands support both an interactive and a non-interactive mode.
The engine that performs all tasks is written in Ansible, you can directly use the same automation outside of this CLI if you wish. The code is open source and available in ibm-mas/ansible-devops, the collection is also available to install directly from Ansible Galaxy.
https://ibm-mas.github.io/cli/
We welcome every Maximo Application Suite users, developers and enthusiasts to contribute to the MAS Command Line Interface while fixing code issues and implementing new automated functionalities.
You can contribute to this collection by raising a new issue with suggestions on how to make our MAS automation engine even better, or if you want to become a new code contributor, please refer to the Contributing section and learn more about how to get started.