-
Sub-task
-
Resolution: Unresolved
-
Critical
-
None
-
None
-
Quality / Stability / Reliability
-
2
-
False
-
-
False
-
-
-
ACM Console Train 37 - 1
Goal
Document the full Azure CCLM deployment process end-to-end. Consolidates learnings from the manual deployment (ACM-30198, ACM-30199, ACM-30200, ACM-30201). Serves as:
- Team reference for reproducing or extending the environment
- Input for pipeline automation (ACM-30229)
- Onboarding guide for anyone new to Azure CCLM setup
Documentation Structure
| Section | Content |
|---|---|
| Azure Prerequisites | Service principal creation, portal permissions (Contributor role), DNS zone selection, CIDR planning for non-overlapping pod/service/machine networks |
| OCP Cluster Deployment | openshift-install IPI with custom install-config.yaml, D8s_v3 workers, preserving metadata.json for Submariner |
| ACM Installation | acm-dev-catalog CatalogSource, ACM operator install, MultiClusterHub creation, spoke import as ManagedCluster |
| Submariner on Azure | subctl cloud prepare azure (NSGs, gateway MachineSets, public IPs), broker deployment, cluster join, OCP 4.21 workaround (--skip-version-check) |
| CCLM Feature Enablement | setup_virt-cclm_env.sh --all walkthrough: MCH components (cnv-mtv-integrations, fine-grained-rbac), CNV install on hub+spoke, HyperConverged feature gates, ForkliftController flags, console plugins, UI feature flag |
| Script Bug Fixes | Two bugs found during deployment: jq boolean handling (line 321), grep pipefail (line 1223). Root cause analysis and fixes documented. |
| MSA Token Workaround | ManagedServiceAccount token expiry issue (ACM-27016), workaround: increase validity to 365 days + restart forklift-controller |
| E2E Migration Verification | Test VM creation, triggering migration from Fleet Virt UI, verifying success on target cluster |
| Azure Storage | managed-csi (RWO, Azure Disk) vs azurefile-csi-nfs (RWX, Azure Files NFS). CCLM works with RWO for cross-cluster migration; RWX needed only for intra-cluster live migration. |
| Known Limitations | InstanceType VMs fail CCLM (MTV-3948, fix in MTV 2.11). Token rotation delay (MTV-3934, fix in MTV 2.11). |
| Troubleshooting | Common issues encountered and their resolutions |