open-cluster-management/solutions/migrate-kubefed/README.md

Migrating Kubefed to Open Cluster Management

This guide shows how to migrate from Kubefed to Open Cluster Management in a simple scenario.

Prerequisite

• Kubefed environment
• clusteradm CLI tool installed

Overview of the migration process

Open Cluster Management control plane can be installed in the same cluster as the Kubefed control plane. The goal of this guide is to have Open Cluster Management running side by side with Kubefed. There is no need to remove any Kubefed related deployments, resources or agents until you are comfortable with your Open Cluster Management setup.

Steps by steps

1. Install the Open Cluster Management control plane by logging into the Kubefed federation cluster and run the clusteradm init command. See deploy a cluster manager on your hub cluster for more details.

2. Register the Kubefed federated clusters by logging into each cluster and run the clusteradm join command. See deploy a klusterlet agent on your managed cluster for more details.

3. Accept the registration request on the Kubefed federation by logging into the federation cluster and run the clusteradm accept command. See accept the join request and verify for more details.

4. Using the ManifestWork API, you can now deploy resources from the federation cluster to the federated clusters. See deploy kubernetes resources for more details.

References

• Open Cluster Management
• Kubefed