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 AWS OpenShift container platform cluster, you must have a cluster created in the AWS cloud and know the region where the cluster is deployed.
2. For AWS OpenShift (ROSA), the credentials typically involve creating an AWS IAM user with the necessary permissions and generating the Access Key ID and Secret Access Key. To create a service account , refer to the Adding OpenShift cluster service account for SWIFT section in the Pre-requisite and Installation Guide.
or
You can download the Installation and Prerequisite Guide from the SWIFT Dashboard. This guide will help you create the required credentials/service account for the AWS OpenShift cluster. Refer to the screenshot below for guidance.
Following are steps to discover the AWS OpenShift cluster.
1. Log in to the SWIFT dashboard, go to Container Cluster, and click Add. Refer to the screenshot below for guidance.
2. Once you click the Add button, the Cluster Add dialog box will appear. Enter the required cluster details to proceed with the discovery. Refer to the screenshot below for guidance.
| 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 as SWIFT supports various clouds |
| Service account token | In an AWS OpenShift cluster, a service account token is a type of Kubernetes authentication token that is automatically created when you create a service account. |
| IP Address/DNS Name | The IP address / DNS name of your AWS OpenShift cluster API endpoint. |
| Access key | Use the Access Key which you have created in the AWS Console (under IAM → Security Credentials → Access Key. Know More |
| Region | Choose the region from the provided list that matches the region of your AWS OpenShift cluster. |
| Secret Key | Use the Secret Key which you have created in the AWS Console (under IAM → Security Credentials → Secret Key |
| 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. |
| 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. Click the Add button. Within a few seconds, the AWS OpenShift cluster will be added. Refer to the screenshot below to confirm that the cluster has been successfully discovered in SWIFT. The cluster will appear similar to the example shown in the screenshot.
4. Once the cluster is discovered, navigate to Container Cluster > Click on the Cluster. You will see that the AWS OpenShift cluster has been successfully discovered.
5. You can view all information about the cluster and its metadata. Click on the cluster to expand it and see the details, including tabs such as Summary, Project, OpenShift Objects, etc.
6 .You can also perform additional operations, such as Rediscover, Configure, or Delete the cluster. To do this, select the cluster, and the available options will appear above.
- Re-Discover : This 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.
- Configure : Use this option if you want to modify the cluster configuration. Please check KB Article on 'Configure the cluster'.
- Delete : Use this option to delete the cluster. Ensure that no DR policy is attached to the cluster; otherwise, the delete option will be disabled. Note: This action removes the cluster from the SWIFT dashboard only and does not delete it from the cloud.