Skip to content

[patch] Add standalone Db2uCluster to Db2uInstance migration pipeline and CLI command - #2428

Draft
jainyjoseph wants to merge 31 commits into
masterfrom
mascore-11096
Draft

[patch] Add standalone Db2uCluster to Db2uInstance migration pipeline and CLI command#2428
jainyjoseph wants to merge 31 commits into
masterfrom
mascore-11096

Conversation

@jainyjoseph

@jainyjoseph jainyjoseph commented Jun 24, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Description

This PR introduces a new standalone Tekton pipeline and CLI command for migrating Db2uCluster instances to Db2uInstance

Changes

New CLI command(mas db2ucluster-migration)

  • New module: python/src/mas/cli/db2_migration/ is added
  • Integration: Updated cli.py and main.py to register new command
  • Shell wrapper: Enhanced image/cli/mascli/mas script to support new command

New Tekton Pipeline

  • Pipeline definition: tekton/src/pipelines/mas-devops-db2-migration.yml.j2
    • Standalone pipeline for DB2 migration workflow
    • Configurable parameters for namespace, cluster name, and backup options
  • Task updates: Enhanced tekton/src/tasks/dependencies/db2.yml.j2 with migration parameters
  • Build integration: Updated tekton/generate-tekton-pipelines.yml to include new pipeline

Key features

  • Interactive cluster detection and selection
  • Pre-migration backup support (configurable)
  • Single-outage migration workflow
  • Comprehensive parameter validation and user confirmation

Test results

You can refer test results in JIRA MASCORE-11096

Refer : ibm-mas/ansible-devops#2337
ibm-mas/python-devops#405

@jainyjoseph
jainyjoseph requested a review from terc1997 June 24, 2026 13:08
@jainyjoseph jainyjoseph changed the title [patch] Standalone pipeline for single outage v12 upgrade and Db2uInstance migration [patch] Add standalone Db2uCluster to Db2uInstance migration pipeline and CLI command Jun 26, 2026
terc1997
terc1997 requested changes Sep 15, 2026
View reviewed changes

@terc1997 terc1997 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the PRs ansible-devops and python-devops there are several names for this migration: db2-migration, migrate, db2ucluster-migration. Stick to one name and use it in all places. Having multiple naming conventions create confusion in the code.

Also, there are several mentions to cluster in these three PRs. While in the context of the Db2 migration it means Db2uCluster someone not involved into this initiative may misinterpret these variable names. So, update all cluster references to actual db2_cluster to avoid confusion. Always prioritize clarity over size of the name.

Comment thread tekton/src/pipelines/mas-devops-db2-migration.yml.j2 Outdated
Comment thread python/src/mas/cli/db2_migration/app.py Outdated
@jainyjoseph
Merge branch 'master' into mascore-11096
2da33a5
@jainyjoseph
MASCORE-11096 Db2uCluster migration naming cleanup
a66c52f 
- Rename --cluster-name CLI arg to --db2-cluster-name
- Rename all cluster/clusterName locals to db2_cluster/db2ClusterName
- Rename method promptForCluster -> promptForDb2Cluster
- Update class docstring and user-facing strings to reference Db2uCluster explicitly
- Update setParam call to use db2_migration_db2_cluster_name
- Rename db2_migration_cluster_name -> db2_migration_db2_cluster_name in pipeline/task j2
- Rename db2_migration_cleanup_old_cluster -> db2_migration_cleanup_old_db2_cluster in pipeline/task j2
- Rename env vars DB2_MIGRATION_CLUSTER_NAME and DB2_MIGRATION_CLEANUP_OLD_CLUSTER
- Remove commented-out waitfor-approval task block from pipeline
@jainyjoseph

jainyjoseph commented Oct 8, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor Author

Hi @terc1997

I have Updated ansible-devops and python-devops as well , as requested.
Could you please check the latest updates made in JIRA MASCORE-11096

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@terc1997 terc1997 terc1997 requested changes

Requested changes must be addressed to merge this pull request.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@jainyjoseph @terc1997