For any migration or disaster recovery (DR) activity, the first step is to discover the cluster in SWIFT. Discovery allows SWIFT to identify and register the cluster along with its associated resources such as namespaces, workloads, and other objects. Only after the cluster is successfully discovered, you can proceed with operations like syncing applications, or performing the actual migration or failover tasks.   


Pre-requisite: 

1.To discover the IKS cluster, you must have a cluster created in the IBM cloud and know the region where the cluster is deployed. 

2.To add an IKS cluster in SWIFT, you need to create the required IBM Cloud service credentials and generate the necessary API key are documented in the Adding IBM cloud user section 

or

You can download the installation and prerequisite guide from the SWIFT dashboard to create credentials for the IKS cluster. The screenshot below is for your reference. 



Following are steps to discover the IKS cluster.


1. Log in to the SWIFT dashboard, navigate to the Container Cluster menu, and click the Add button. Refer to the screenshot below for guidance. 



2. Once you click on 'Add ' button. It will display Cluster Add modal/dialog. There you need to provide cluster details      to be discovered. You can check below screenshot for your reference.  



Field Name Field Description 
Platform type  Select the platform where your cluster is running  
Friendly name 
You need to enter a friendly name according to your cluster or project.   
Cloud Type  Choose the ‘cloud type’ from the dropdown. In this case it is IBM Cloud.
Cluster Name  Enter the IKS cluster name that you created in oracle cloud. 
API KeyAn API key is a unique code (like a password) used to authenticate and allow applications or users to access an API securely. Know More

TRAIPOD Config 
This is an optional input. They can be configured for each sync, and the values input for the sync will override the defaults set for the cluster. For more info you can look TRAIPOD KB article. 

To more know about Traipod Config section, Please follow below KB Article.

traipod-config

Cluster private IP config 
Normally, the IP address or hostname mentioned in the kubeconfig file is used to discover the cluster. However, if you want to set up a private IP or hostname to access the cluster, and the public IP mentioned in the kubeconfig is not used, this setting can be used to overwrite the default kubeconfig IP with the private IP and port. 


3. Now, click the Add button. Within a few seconds, the IKS cluster will be added. Refer to the screenshot below to confirm that the IKS cluster has been successfully discovered in SWIFT.  


4. Once the cluster is discovered, you can view all information about the cluster and its metadata. Simply expand          the cluster by clicking on it, and you will see the details. You can refer to the screenshot below .  


   - When you go to the Summary tab, you will find information about the cluster, such as its creation date, IKS cluster name, API server port, Kubernetes version, and more.  


   - In the Namespace tab, you can view all namespaces created in the cluster, including the default namespaces provided by IKS. Refer to the screenshot below for guidance. 


   - When you go to the Kubernetes Objects tab, you can view the objects running in your namespace. Simply select the object type from the Object Type tab and choose the namespace from the dropdown. This will display the objects running in that namespace on the cluster. In the screenshot below, you can see that two pods are running in the 'app' namespace.  


4. Once the cluster is successfully discovered, additional operations become available. You can perform the following actions on the selected cluster.




- Re-DiscoverThis option allows you to re-discover the cluster. If you have added new namespaces or applications to the cloud cluster and want them to be reflected in the SWIFT portal, you can re-discover the cluster. 


- ConfigureUse this option if you want to modify the cluster configuration. Please check KB Article on 'Configure the cluster'.

How to configure the cluster

 

- DeleteUse this option to delete the cluster. However, ensure that no DR Policy is attached to the cluster; otherwise, the cluster cannot be deleted and the Delete option will be disabled. It will delete from SWIFT dashboard only not from cloud.


What next:


- Now that the clusters are discovered, you may want to set up a Migration or Disaster Recovery (DR) job. Then follow below KB links.


How to migrate application with Passthrough sync

How to migrate applications with stage sync



Related KB's


How to create DR Policy

DR policy for stage1+2 sync