Installation of OpsRamp Agent on Kubernetes 2.0 Cluster

×

This section provides detailed instructions for installing and managing the OpsRamp Agent on a Kubernetes 2.0 Cluster. Follow these steps:

• Step 1: Configure Kubernetes 2.0 Integration
• Step 2: Download the YAML file
• Step 3: Install OpsRamp Agent on the Kubernetes Cluster

Prerequisites

• Helm command to be installed on the server through which your Kubernetes cluster is being managed using kubectl/oc commands
• Ensure that the Helm repository is accessible from the user cluster.
• The Agent repository must also be reachable from the user cluster.

Step 1: Configure Kubernetes 2.0 Integration

1. To select your client, navigate to All Clients, and click the Client/Partner dropdown menu.
   Note: You may either type your client’s name in the search bar or select your client from the list.
2. Navigate to Setup > Account. The Account Details screen will appear.
3. Click Integrations. The Installed Integrations screen is displayed with all the installed applications.
   Note: If no applications are installed, you will be directed to the Available Integrations page, displaying all available applications, including the newly activated Kubernetes 2.0 integration.
4. Click + ADD on the Installed Integrations page.
   Note: Search for the integration by entering Kubernetes 2.0 or by selecting Container Orchestration category from the All Categories dropdown list.
5. Click ADD in the Kubernetes 2.0 tile.

   

6. The Configuration screen appears, click + ADD.

   

7. Enter the following Basic Information.

5. Click ADD.
   
6. Once the configuration is saved, the cluster will be created and it will be appear on the configurations page.
   

   

   Note

   1. Each configuration having one cluster. To create another cluster, click + ADD button again, as shown in the figure above.
   2. Bypass Resource Reconciliation: Select this checkbox to bypass resource reconciliation for resources discovered through multiple apps. multiple apps.

Manage the Configured Cluster

Once the configuration is created, you can manage it by clicking the ellipsis (…). The below options are available:

• Edit: Modify the Distribution Type and click Update.
• Remove: This will delete all resources and related metrics associated with the configuration.
• Instruction: Detailed instructions to install the OpsRamp Agent on Kubernetes cluster.
• Download YAML: Link to download the YAML file.
• View Logs: Click to view the logs details.
• Copy UID: Hover over the UID, then click the copy button to copy the UID.

  

Manage the Kubernetes 2.0 Integration

For detailed instructions on modifying an installed integration, see the Modify an Installed Integration or Application article.

Step 2: Download and Copy the opsramp-agent-values.yaml file

Download

1. Click the ellipsis (…) next to the configuration and select Download YAML.
2. The YAML file will be downloaded in your local system.
3. Please remember that you downloaded the YAML file location path.

Copy:

1. Click the ellipsis (…) next to the configuration and select Instructions.

   

2. The YAML content will be displayed on the screen.
3. Click on the Copy button to copy the yaml content.
4. You can store this copied content in one file, for example, opsramp-agent-values.yaml.

   

For example, the downloaded or copied file would look like the one below.

agent:
  config:
    masterUuid: "INTG-<integration UUID>"
    appServer: "<app-server-URL>"
    clientId: "<some client ID>"
    integrationResUuid: "<integration UUID>"
    kubernetesType: "<type-of-k8s-distro>"
    enableLogManagement: "TRUE"
    clusterUuid: "<cluster-UUID>"
    clusterName: "<name-of-the-cluster-you-have-given>"
    appConfigId: "ADAPTER-MANIFEST-<app-Config-ID>"
    sdkAppName: "Kubernetes-2.0"
    apiKey: "<api-key>"
    apiSecret: "<api-secret>"
    metricEndpoint: "<opsramp endpoint>"
    metricAuthTokenUrl: "<opsramp URL>"
    logLevel: "warn"

Step 3: Install OpsRamp Agent on the Kubernetes Cluster

1. Log in to your server/host and ensure your kubeconfig is pointing to the Kubernetes cluster.
2. Before we go to the next step, please copy the path of the file you downloaded or copied from the last step we require while running the command below.
3. Now, with the location of the path, run the following helm command to install the OpsRamp Agent on the cluster:

   helm install opsramp oci://us-docker.pkg.dev/opsramp-registry/agent-helm-charts/agent -n opsramp-agent --create-namespace --values <download-file-path-or-copied-file-path>.yaml

Install OpsRamp Agent behind a Proxy

1. To install the agent behind the proxy, the user can update the downloaded or copied manifest from Step 2 with the following values.

       connMode: "proxy"
       proxyProto: ""
       proxyServer: ""
       proxyPort: ""
       proxyUser: ""
       proxyPassword: ""

2. The above details tell about the proxy URL details.
3. For example, with the above fields, our config would become:

   agent:
     config:
       masterUuid: "INTG-<integration UUID>"
       appServer: "<app-server-URL>"
       clientId: "<some client ID>"
       integrationResUuid: "<integration UUID>"
       kubernetesType: "<type-of-k8s-distro>"
       enableLogManagement: "TRUE"
       clusterUuid: "<cluster-UUID>"
       clusterName: "<name-of-the-cluster-you-have-given>"
       appConfigId: "ADAPTER-MANIFEST-<app-Config-ID>"
       sdkAppName: "Kubernetes-2.0"
       apiKey: "<api-key>"
       apiSecret: "<api-secret>"
       metricEndpoint: "<opsramp endpoint>"
       metricAuthTokenUrl: "<opsramp URL>"
       logLevel: "warn"
       connMode: "proxy"
       proxyProto: "http"
       proxyServer: "proxy.example.com"
       proxyPort: "8080"
       proxyUser: "monitoring_user"
       proxyPassword: "securepassword123"

4. Then, proceed to Step 3 to install the Agent.