Installing RealTheory in a Cluster

In just a few minutes, you can customize, generate, and apply the RealTheory Collector deployment YAML file, which installs RealTheory into your cluster.

Prerequisite

Before you install RealTheory into your cluster, consider the following:

• Review the minimum requirements for the RealTheory Collector installation
• You must have a user account inside the organizational account.
• Establish a labeling protocol if your environment is comprised of multiple clusters.
  See How to Leverage RealTheory Labels For Scalability and Automation.

Installing RealTheory

1. Navigate to Settings > Agent > Deployment.

2. Ensure that the minimum requirements for a successful deployment are met:

   • Is your cluster running a supported version of Kubernetes? I need help with this
   • Does your cluster have the metrics server installed? I need help with this
   • Do you have the appropriate RBAC permissions necessary to install RealTheory in your cluster? I need help with this
   • If your cluster uses a proxy server for outbound traffic, do you have the server's proxy settings? I need help with this

3. (Optional) Provide a descriptive Cluster name that has meaning based on the cluster's function, purpose, location, etc.

4. (Optional) Provide a Cluster description; a comment that describes the cluster.

5. (Optional) If you want to associate labels to all the Kubernetes objects in your cluster, leave the toggle enabled and provide any of the following:

   • Cloud account identifier - an identifier for the cloud provider associated with the cluster such as an Account ID, Account Name, Subscription ID, or Project ID
   • Account owner - the account owner or contact person for this cluster
   • Cluster labels - key/value pairs that specify meaningful and relevant identifying attributes of the cluster
     Important: Labels can be leveraged to configure and manage certain RealTheory features such as rate card policies, access control policies, and rule management automatically and at scale. You should review these features to help you identify labels that can simplify feature management.

   Note: The labels you provide will only be associated with objects within the RealTheory application; no labels in the cluster will be altered.

6. If your cluster is running on an arm64-based architecture, expand the More options section and select arm64.

7. To ensure that the appropriate CPU and memory requests are set for the RealTheory Collector, expand the More options section and specify the Approximate cluster vCPU count for your cluster.

   Note: The performance of the RealTheory Collector is impacted by the size of the cluster where the Collector is installed. On larger clusters, the CPU and memory requests configured for the realtheorycollector pod must be higher to ensure that the Collector has the resources it needs to function efficiently.

8. If a proxy server is required to connect to the Internet, expand the More options section and specify the proxy server details in the Outbound proxy sub-section.

9. Verify the settings you provided in Steps 3 - 8.

10. Click Show YAML.

    The RealTheory Collector deployment YAML will be generated and displayed in the right-hand panel.

11. Review the YAML file and then do one of the following:

    • Download the YAML file to the default download location on your local system.
    • Copy the YAML file to your clipboard and paste it into an application of your choosing.

12. Run the following command to ensure that kubectl is configured to point to the cluster that you want to install the RealTheory collector on:

    kubectl config use-context <cluster-context-name>

    where <cluster-context-name> is the name of the cluster context that you want to use.

13. Run the following command on the cluster you want to manage:

    kubectl apply -f <filename.yaml>

    where <filename.yaml> is the path to the YAML file you created in Step 10.

    Your cluster will be visible in Visualizations within a few minutes.