Rancher

Owned by Daria Lebedeva
Last updated: Dec 10, 2024
3 min read

Rancher is the open source multi-cluster orchestration platform. This guide explains how to add Rancher integration to Cloudaware.

Rancher - CA_logo_black.png To see how Cloudaware seamlessly integrates with Rancher in action, request a demo.

Prerequisites

 

  1. If Rancher server is running in a private network, configure the TunHub gateway before Rancher integration is added to Cloudaware.

  2. Create a custom role for Cloudaware in Rancher:

2.1. Log in to Rancher account → Home → hamburger icon.

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

rancher - role templates - create.png

2.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:

rancher - create role - permissions.png

Click Create.

2.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.

 

Add Rancher server

 

  1. Log in to Cloudaware account → Admin.

  2. Find Rancher in the list of cloud integrations. Click +Add.

  3. Fill out the form:

    WHERE

    Name - the Rancher integration name
    URL - the Rancher server URL (if the Rancher server is running in a private network, use the TunHub URL generated by Cloudaware after a designated route is set up in TunHub integration, e.g. https://tunhub.cloudaware.com:1234)
    Hostname - the Rancher server hostname
    API Key - Bearer Token. Read more
    Trust Certificate - check this check box if the Rancher server is running in a private network, and TunHub gateway has been set up in Cloudaware.

    Сlick Check → 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. To view Rancher-related data, go to Cloudaware CMDB Navigator. Select RANCHER in the menu on the left:

List of Rancher objects 

 

Cloudaware supports the following Rancher objects:

Rancher Cluster
Rancher Cluster Config Map
Rancher Cluster Daemon Set
Rancher Cluster Deployment
Rancher Cluster Endpoint
Rancher Cluster HPA
Rancher Cluster Ingress
Rancher Cluster Limit Range
Rancher Cluster Namespace
Rancher Cluster Network Policy
Rancher Cluster Network Policy Rule
Rancher Cluster Node
Rancher Cluster Node Address
Rancher Cluster Pod
Rancher Cluster Pod Container
Rancher Cluster Pod Disruption Budget
Rancher Cluster Replica Set
Rancher Cluster Resource Quota
Rancher Cluster Role
Rancher Cluster Role Binding
Rancher Cluster Role Template Binding
Rancher Cluster Secret
Rancher Cluster Service
Rancher Cluster Service Account
Rancher Cluster Service Account Secret
Rancher Cluster Stateful Set
Rancher Global Role
Rancher Global Role Binding
Rancher Project
Rancher Project Role Template Binding
Rancher Role Template
Rancher Server
Rancher User