The installation prerequisites for installing Hybrid Manager on Rancher RKE2

There are prerequisites to meet before you can install Hybrid Manager (HM) on Rancher.

Fulfill the prerequisites to ensure that you have everything you need before you start the installation process.

Prerequisites

• A system from which you can run the installation process with the following utilities:

• `kubectl <https://kubernetes.io/docs/reference/kubectl/>`_  to manage your Kubernetes cluster
  

• `Helm <https://helm.sh/docs/intro/install/>`_  to render and apply the Kubernetes manifest.
  

• `edbctl <https://www.enterprisedb.com/docs/edb-postgres-ai/latest/hybrid-manager/using_hybrid_manager/edbctl/>`_
  

• :ref;`A RKE2 cluster preconfigured for use with HM <Preconfigure a Rancher RKE2 cluster for use with Hybrid Manager>`

• :ref;`Sync container images to your registry <Sync container images to your registry>`

Next steps

Once you have fulfilled these requirements, you can move on to Installation phase of Hybrid Manager on Rancher RKE2 .

• Preconfigure a Rancher RKE2 cluster for use with Hybrid Manager
  • Configure your Helm chart
    • Adding the EDB Helm repo and retrieving the chart
  • Creating your RKE2 cluster
    • Supported RKE2:Kubernetes version pairs
  • Configure node size and resources
    • Node sizing
    • HM Control Plane nodes
    • Postgres data nodes
    • GPU Node Provisioning and Operator Setup (Optional for AI/ML)
    • Taints and labels for CP vs Postgres data nodes machine sets
    • Networking bandwidth
  • Network configuration and requirements
    • Foundational planning and networking architecture
    • High-level network decisions
    • IP Address and CIDR planning
    • Core cluster networking
    • Configure container network interface (CNI)
    • Create a load balancer
    • External access and firewall rules
    • On-premises deployments (NodePort or custom LB)
    • Cloud-based deployments (LoadBalancer)
    • DNS, TLS, and application configuration
    • DNS configuration
    • Load balancer or Node Port configuration
    • TLS certificate management
    • User identity configuration
    • Network security policies hardening
    • Network policies
    • Ingress/egress rules
  • Sync EDB Postgres AI Platform container images into a customer owned registry
    • Sync using edbctl
  • Sync container images
  • Image discovery configuration
    • Configuring the Helm chart for image discovery
    • Registry credentials
    • AWS ECR
    • Google Cloud AR
    • Setting the secret value
  • Namespaces and preliminary secrets
    • Preparation for object storage and general Kubernetes secrets
    • ImagePullSecret namespace and required secrets
    • Authentication and security keys
    • Generate the key and store it in a secret
    • Update the Helm chart
    • Other necessary secrets
    • Securing Migration Portal
  • Storage and cluster preparation
    • Block storage configuration
    • Workload segregation
    • Snapshot class (optional, CSI-capable backends only)
    • Cluster prerequisites
    • CSI driver installation
    • Update the Helm chart
    • KMS key setup
    • Object storage configuration (MinIO setup)
    • MinIO user and policy creation
    • Apply the secret for bucket access
  • Proceed to installation