MAS DevOps Ansible Collection Ansible CLI
Edit on GitHub
Home Ansible Automation Platform OCP Install Cloud Pak For Data Install Core Add AIBroker Add IoT Add Manage Add Monitor Add Optimizer Add Predict Add Visual Inspection Update Upgrade Uninstall Core Backup & Restore ocp_cluster_monitoring ocp_config ocp_deprovision ocp_efs ocp_github_oauth ocp_login ocp_node_config ocp_provision ocp_roks_upgrade_registry_storage ocp_upgrade ocp_verify appconnect aws_bucket_access_point aws_documentdb_user aws_policy aws_route53 aws_user_creation aws_vpc cert_manager cis common-services configure_manage_eventstreams cos cos_bucket cp4d_admin_pwd_update cp4d cp4d_service db2 dro eck grafana ibm_catalogs kafka nvidia_gpu mongodb ocs sls turbonomic uds mirror_case_prepare mirror_extras_prepare mirror_images mirror_ocp ocp_idms ocp_simulate_disconnected_network registry suite_app_config suite_app_install suite_app_uninstall suite_app_upgrade suite_app_rollback suite_app_backup_restore suite_certs suite_config suite_db2_setup_for_manage suite_dns suite_install suite_manage_attachments_config suite_manage_birt_report_config suite_manage_bim_config suite_manage_customer_files_config suite_manage_imagestitching_config suite_manage_import_certs_config suite_manage_load_dbc_scripts suite_manage_logging_config suite_manage_pvc_config suite_uninstall suite_upgrade suite_rollback suite_verify suite_backup_restore ansible_version_check entitlement_key_rotation gencfg_jdbc gencfg_watsonstudio gencfg_workspace gencfg_mongo

OCP Playbooks¤

Provision¤

Refer to the ocp_provision role documentation for more information.

Provision on AWS ROSA¤

This playbook uses your ROSA API Token to provision a brand new OCP cluster, provision an instance of EFS and set up the cluster with a ReadWriteMany storage class named efs utilizing that instance.

To obtain your API token login to the OpenShift cluster manager.

export AWS_ACCESS_KEY_ID=xxx
export AWS_SECRET_ACCESS_KEY=xxx
export ROSA_TOKEN=xxx

export CLUSTER_NAME=masonrosa
export OCP_VERSION=4.17
export ROSA_COMPUTE_NODES=5
export ROSA_CLUSTER_ADMIN_PASSWORD=xxx
ansible-playbook ibm.mas_devops.ocp_rosa_provision

Provision on IBMCloud ROKS¤

This playbook uses your IBMCloud API key to provision a brand new OCP cluster.

The playbook supports installing an IBM entitlement key as a cluster-wide image pull secret and reboot all worker nodes, which is required for IBM Cloud Pak for Data v4; this can be enabled by setting REBOOT_WORKER_NODES to true and providing the entitlement key with CPD_ENTITLEMENT_KEY.

This also supports upgrading the storage volume used for the cluster's internal image registry from 100Gb to 400Gb, this must be enabled by setting UPGRADE_IMAGE_REGISTRY_STORAGE to true. This option is stringly recommended if you intend to install the Watson services from Cloud Pak for Data as the default volume size is too small.

export CLUSTER_NAME=masinst1
export OCP_VERSION=4.17_openshift
export IBMCLOUD_APIKEY=xxx
export REBOOT_WORKER_NODES=true
export CPD_ENTITLEMENT_KEY=xxx
export UPGRADE_IMAGE_REGISTRY_STORAGE=true
ansible-playbook ibm.mas_devops.ocp_roks_provision

Provision on IBM DevIT Fyre¤

This playbook will provision a QuickBurn OCP cluster in IBM DevIT Fyre service, QuickBurn clusters will be automatically deprovisioned after 36 hours and are only suitable for small scale deployments for local development and demostration systems.

export CLUSTER_NAME=masinst1
export OCP_VERSION=4.17
export FYRE_USERNAME=xxx
export FYRE_APIKEY=xxx
export FYRE_PRODUCT_ID=xxx

ansible-playbook ibm.mas_devops.ocp_fyre_provision

Deprovision¤

Refer to the ocp_deprovision role documentation for more information.

Deprovision on IBMCloud ROKS¤

export CLUSTER_NAME=masinst1
export IBMCLOUD_APIKEY=xxx

ansible-playbook ibm.mas_devops.ocp_roks_deprovision

Deprovision on IBM DevIT Fyre¤

export CLUSTER_NAME=masinst1
export FYRE_USERNAME=xxx
export FYRE_APIKEY=xxx

ansible-playbook ibm.mas_devops.ocp_fyre_deprovision