Configure the Rancher Integration

The Rancher integration connects Edge Infrastructure Services to a Rancher endpoint so you can manage clusters through Rancher’s remote orchestration capabilities. After you add the integration, Edge Infrastructure Services registers with your Rancher instance using the authentication credentials you provide.

​

Introduction

This procedure covers how to add and manage a Rancher integration. Use this integration when your organization uses Rancher to orchestrate Kubernetes workloads and you want Edge Infrastructure Services to connect to it as a managed cluster target.

​

Prerequisites

• You have the SysAdmin role in your enterprise. See Manage Roles.
• Your enterprise has the Rancher Integration entitlement enabled. If Rancher does not appear in the Integration Type dropdown, your enterprise does not have this entitlement. Contact your ZEDEDA administrator. See Admin Dashboard for entitlement details.
• A Rancher instance is running and reachable from Edge Infrastructure Services.
• You have either an API token or a username and password for your Rancher instance.

​

Add the Rancher Integration

1. In the header, select your profile avatar, then select Enterprise.
2. In the Enterprise Settings navigation, select Integrations.
3. Select Add Integration.
4. In the Name field, enter a descriptive name for this integration.
5. In the Integration Category dropdown, select Remote Orchestration.
6. In the Integration Type dropdown, select Rancher.
7. In the Endpoint URL field, enter the URL of your Rancher instance, for example https://rancher.example.com.
8. In the Authentication Type dropdown, select one of the following:
   • API Token: Use a Rancher API token. Enter the token in the API Token field.
   • Credentials: Use a username and password. Enter your Username and Password.
9. Select Add Integration.

The integration appears in the Integrations list.

​

Manage the Integration

​

Remove an integration

To remove the Rancher integration, select the delete button on the integration row in the Integrations list.

​

Next Steps