SKIP UPGRADE Resolve "Update Migration Documentation and Refactor"

General MR

Summary

Update Migration Documentation for Nexus Repository Manager to NXRM-HA

NOTE:

This will be taken care of in the follow on renovate issue that is pending:

Relevant logs/screenshots

Migration successful (Production Configuration with s3 Blobstore and external RDS Postgresql DB):

nexusRepositoryManager Deployment:

Migration steps per ./docs/migration.md:

NXRM-HA Deployment Migration:

Post Migration Steps per /docs/migration.md: set nexusRepositortManager package to false to remove HR:

Both tasks complete successfully:

Linked Issue

issue

Upgrade Notices

Important: New Package Introduction

NXRM-HA (Nexus Repository Manager High Availability) is a new Big Bang package that will be replacing the legacy nexus-repository-manager chart.

What is NXRM-HA?

NXRM-HA is the official Sonatype-supported Helm chart for deploying Nexus Repository Manager in production environments. This package provides:

• High Availability Support: Deploy Nexus Repository Manager Pro in a highly available, multi-node configuration
• Production-Ready Architecture: Built-in support for external databases (PostgreSQL, AWS RDS) and object storage (S3, Azure Blob)
• Enterprise Features: Full support for Nexus Repository Manager Pro features including clustering, replication, and advanced security
• Active Maintenance: Direct support and updates from Sonatype, ensuring compatibility with the latest Nexus Repository Manager versions
• Improved Scalability: Better resource management and horizontal scaling capabilities

Migration Required

⚠️ WARNING: Upgrading from the legacy nexus-repository-manager chart to nxrm-ha requires a migration process. This is NOT a simple in-place upgrade.

Before You Upgrade

1. READ THE MIGRATION DOCUMENTATION: A comprehensive migration guide is available at docs/migration.md
2. PLAN FOR DOWNTIME: The migration process requires a maintenance window
3. BACKUP YOUR DATA: Ensure you have current backups of:
   • Repository data and blob stores
   • Configuration settings
   • Database (if using external database)
4. TEST IN NON-PRODUCTION: Always test the migration process in a development or staging environment first

Key Differences from Legacy Chart

• Resource Names: All resources now use nxrm-ha prefix instead of nexus-repository-manager
• Configuration Structure: Values structure follows upstream Sonatype chart patterns
• Database Support: Improved external database configuration with automatic secret generation

Migration Path

For detailed migration instructions, refer to: docs/migration.md

The migration guide covers:

• Prerequisites and preparation steps
• Step-by-step migration procedure
• Configuration mapping between old and new charts
• Validation and rollback procedures

Support

For questions or issues during migration:

• Review the migration documentation
• Check the general documentation for configuration details
• Consult the Sonatype NXRM-HA documentation

---

Note: This upgrade represents a significant architectural improvement for Nexus Repository Manager deployments in Big Bang, providing better stability, scalability, and long-term support.

Umbrella Branch

nxrm-ha-integration