MAS GitOps GitOps Ansible CLI
Edit on GitHub
Home Architecture Source Repository Account Root Chart Cluster Root Chart SLS Root Chart AIService Instance Root Chart AIService Tenant Root Chart Instance Root Chart

Source Repository¤

The Source Repository (usually ibm-mas/gitops) provides Helm Charts that define all of the Kubernetes resources required to deploy MAS instances using ArgoCD. The Helm Charts are split across four sub directories, depending on their intended target:

The following figure shows a tree of ArgoCD applications and Application Sets generated by the charts under root-applications, starting with the Account Root Application at the top.

Account Root Chart¤

Account Root Applications render the Account Root Chart, which installs the Cluster Root Application Set. This generates a set of Cluster Root Applications based on the configuration in the Config Repository

Cluster Root Chart¤

Cluster Root Applications render the Cluster Root Chart, which contains templates to generate ArgoCD Applications for configuring various dependencies and supporting services shared by MAS instances on Target Clusters.

Application Template Helm Chart
EFS CSI Driver 000-efs-csi-driver.yaml 000-efs-csi-driver
IBM Operator Catalog 000-ibm-operator-catalog-app.yaml 000-ibm-operator-catalog
Image Mirroring 000-image-mirroring.yaml 000-image-mirroring
Job Cleaner 000-job-cleaner.yaml 000-job-cleaner
Redhat Certificate Manager 010-ibm-redhat-cert-manager-app.yaml 010-redhat-cert-manager
CIS Certificate Manager 020-ibm-cis-cert-manager.yaml 020-ibm-cis-cert-manager
Data Reporter Operator (DRO) 030-ibm-dro-app.yaml 030-ibm-dro
DRO Public Route 031-ibm-dro-public.yaml 031-ibm-dro-public
DRO Cleanup 032-ibm-dro-cleanup.yaml 032-ibm-dro-cleanup
CIS Compliance 040-cis-compliance-app.yaml 040-cis-compliance
CIS Compliance Cleanup 041-cis-compliance-cleanup.yaml 041-cis-compliance-cleanup
NFD Operator 050-nfd-operator-app.yaml 050-nfd-operator
Nvidia GPU Operator 051-nvidia-gpu-operator-app.yaml 051-nvidia-gpu-operator
Group Sync Operator 052-group-sync-operator-app.yaml 052-group-sync-operator
Falcon Operator 053-falcon-operator-app.yaml 053-falcon-operator
Cluster Logging Operator 054-cluster-logging-operator-app.yaml 054-cluster-logging-operator
Instana Agent Operator 055-instana-agent-operator-app.yaml 055-instana-agent-operator
Custom Cluster Service Accounts 060-custom-sa.yaml 060-custom-sa
IBM RBAC 061-ibm-rbac-app.yaml 061-ibm-rbac
Cluster Promotion 200-cluster-promotion-app.yaml 200-cluster-promotion
MAS Provisioner Service 300-mas-provisioner-app.yaml 300-mas-provisioner

The Cluster Root Chart also contains ApplicationSets that generate child applications:

SLS Root Chart¤

SLS Root Applications render the SLS Root Chart, which is generated by the SLS ApplicationSet in the Cluster Root Chart. This chart manages standalone Suite License Service deployments that are not tied to a specific MAS instance.

Application Template Helm Chart
Suite License Service (SLS) 100-ibm-sls-app.yaml 100-ibm-sls

AIService Instance Root Chart¤

AI Service Instance Root Applications render the AIService Instance Root Chart, which is generated by the AI Service Instance ApplicationSet in the Cluster Root Chart. This chart manages AI Service infrastructure and tenant deployments.

Application Template Helm Chart
Open Data Hub (ODH) 030-ibm-odh-app.yaml 112-ibm-odh
AI Service 040-ibm-aiservice-app.yaml 113-ibm-aiservice

The AIService Instance Root Chart also contains an ApplicationSet:

AIService Tenant Root Chart¤

AI Service Tenant Root Applications render the AIService Tenant Root Chart, which is generated by the AI Service Tenant ApplicationSet. This chart manages individual AI Service tenant deployments.

Application Template Helm Chart
AI Service Tenant 100-ibm-aiservice-tenant-app.yaml 115-ibm-aiservice-tenant

Instance Root Chart¤

MAS Instance Root Applications render the Instance Root Chart, which contains templates to generate ArgoCD Applications that installs MAS on Target Clusters, including:

Synchronization and Resource Management:¤
Application Template Helm Chart
IBM Sync Resources 000-ibm-sync-resources.yaml 000-ibm-sync-resources
IBM Sync Jobs 010-ibm-sync-jobs.yaml 010-ibm-sync-jobs
IBM Sync Jobs CP4D 101-ibm-sync-jobs-cp4d.yaml 101-ibm-sync-jobs-cp4d
Post Sync Job CP4D Services 121-ibm-post-sync-job-cp4d-services.yaml 121-ibm-post-sync-job-cp4d-services
IBM Post Sync Jobs 600-ibm-post-sync-jobs.yaml 600-ibm-post-sync-jobs
Instance-level MAS dependencies:¤
Application Template Helm Chart
Suite License Service (SLS) 100-ibm-sls-app.yaml 100-ibm-sls
Db2u Operator 110-ibm-db2u-app.yaml 110-ibm-db2u
Cloudpak 4 Data (CP4D) 110-ibm-cp4d-app.yaml 110-ibm-cp4d
Cloudpak 4 Data (CP4D) Operators 110-ibm-cp4d-operator-app.yaml 110-ibm-cp4d-operators
Cloudpak 4 Data (CP4D) CS Control 110-ibm-cs-control-app.yaml 110-ibm-cs-control
DB2 Databases 120-db2-databases-app.yaml1 120-ibm-db2u-database
DBS RDS Databases 120-dbs-rds-databases-app.yaml1 120-ibm-dbs-rds-database
Watson Studio Local (WSL) 120-ibm-wsl-app.yaml 120-ibm-wsl
Watson Machine Learning (WML) 120-ibm-wml-app.yaml 120-ibm-wml
Analytics Engine powered by Apache Spark (Spark) 120-ibm-spark-app.yaml 120-ibm-spark
SPSS Modeler 120-ibm-spss-app.yaml 120-ibm-spss
MAS Core Platform¤

This includes the suite, suite configurations and core workspaces

Application Template Helm Chart
MAS Core Suite 130-ibm-mas-suite-app.yaml 130-ibm-mas-suite
Suite Configs 130-ibm-mas-suite-configs-app.yaml1 Multiple charts 2
MAS Workspaces 200-ibm-mas-workspaces.yaml1 220-ibm-mas-workspace

MAS Applications¤

These share a generic chart.

Application Template
Manage 500-ibm-mas-masapp-manage-install.yaml
Facilities 505-ibm-mas-masapp-facilities-install.yaml
Assist 510-ibm-mas-masapp-assist-install.yaml
IoT 510-ibm-mas-masapp-iot-install.yaml
Visual Inspection 510-ibm-mas-masapp-visualinspection-install.yaml
Health 520-ibm-mas-masapp-health-install.yaml
Monitor 520-ibm-mas-masapp-monitor-install.yaml
Optimizer 520-ibm-mas-masapp-optimizer-install.yaml
Predict 540-ibm-mas-masapp-predict-install.yaml

MAS Application Workspace Config¤

The generic 510-550-ibm-mas-masapp-configs.yaml1 template and 510-550-ibm-mas-suite-app-config chart is used for creating MAS Application workspace configurations.

MAS Addons and RBAC¤

Application Template Helm Chart
MAS Addons Config 550-ibm-mas-addons-config.yaml 550-ibm-mas-addons-config
Application Admin RBAC 600-application-admin-rbac-app.yaml 600-application-admin-rbac

  1. These templates are capable of generating multiple Applications; necessary because there may be one or more instances of the type of resource they are responsible for managing. 

  2. The Suite Configs Application is responsible for installing various types of suite configuration types (Mongo, BAS, SMTP, etc) at various scopes (system, app, ws, wsapp). The chart is chosen dynamically based on the configuration type: AiCfg, JDBC, Kafka, BAS, IDP, Mongo, SLS, SMTP, COS, Watson Studio, MAS App, DB2U JDBC Password Rotation