Rancher

Rancher is the open source multi-cluster orchestration platform.

Prerequisites

1. Create a custom role for Cloudaware in Rancher:

1.1. Log in to your Rancher account → Home → hamburger icon.

1.2. Select 'Users & Authentication' → Role Template → Create Global Role.

1.3. Set up a meaningful name for the role, e.g., CA Read Only. Grant get, list, and watch permissions in 'Verbs'. Set the scope as * in 'Resource'. Leave the radio button in 'New User Default' as is - No:

Click Create.

1.4. Go back to 'Users & Authentication' → Users → select the user created for Cloudaware. Click tree dots on the right → click Edit Config.

Assign CA Read Only role to the Cloudaware user in 'Custom'. Click Save.

More about custom roles in Rancher here.

2. If Rancher server is running on the private network, TunHub Gateway must be configured before Rancher integration can be added to Cloudaware. Address the Cloudaware TunHub Integration Guidefor more information.

Adding Rancher Server

1. Log in to Cloudaware account → select Admin in the main menu under your username.

2. Find Rancher in the list of integrations, click +Add.

3. Fill in the required information:

Name - the Rancher integration name

URL - insert the TunHub URL generated by Cloudaware after a designated route is set up in TunHub integration (e.g. https://tunhub.cloudaware.com:1234)

API Key - use Bearer Token (see more in Rancher documentation)

Trust Certificate - check this box if Rancher server is running on a private network, and TunHub Gateway has been set up in Cloudaware.

Сlick Save.

4. The green light in 'Status' means that Rancher Server integration has been successfully configured. If there is a red light, please contact support@cloudaware.com

5. Once the integration is added, go to Cloudaware CMDB Navigator to view the Rancher data collected under the section RANCHER on the left.

List of Rancher Objects 

Cloudaware supports the following Rancher objects: