Skip to main content

Install OpsWorker Kubernetes Agent

Overview​

The OpsWorker Kubernetes Agent is a lightweight component that runs inside your cluster, collecting data for AI-powered investigations. It's installed via Helm chart.

Prerequisites​

  • Kubernetes 1.24 or later
  • Helm 3.x installed
  • kubectl configured for your target cluster
  • Cluster admin permissions (for creating namespace, RBAC resources)
  • Outbound HTTPS access to *.amazonaws.com (port 443)
  • Cluster token from the OpsWorker portal (generated when you add a cluster)

Installation Steps​

1. Add the OpsWorker Helm Repository​

helm repo add opsworker https://charts.opsworker.ai
helm repo update

2. Install the Agent​

Use the command provided in the Add Cluster wizard, which includes your cluster token:

helm install opsworker-agent opsworker/opsworker-agent \
  --namespace opsworker \
  --create-namespace \
  --set clusterToken=YOUR_CLUSTER_TOKEN

3. Verify Installation​

Check that the agent pod is running:

kubectl get pods -n opsworker

Expected output:

NAME                               READY   STATUS    RESTARTS   AGE
opsworker-agent-xxxxx-xxxxx        1/1     Running   0          30s

4. Confirm Connection​

Return to the OpsWorker portal — your cluster status should show Connected within a minute.

Resource Requirements​

The agent has a minimal footprint:

ResourceDefault RequestDefault Limit
CPU100m200m
Memory128Mi256Mi

Custom Configuration​

You can customize the installation with Helm values:

helm install opsworker-agent opsworker/opsworker-agent \
  --namespace opsworker \
  --create-namespace \
  --set clusterToken=YOUR_CLUSTER_TOKEN \
  --set resources.requests.memory=256Mi \
  --set resources.limits.memory=512Mi

See Agent Configuration for all available options.

Restricted Environments​

Behind a Proxy​

helm install opsworker-agent opsworker/opsworker-agent \
  --namespace opsworker \
  --create-namespace \
  --set clusterToken=YOUR_CLUSTER_TOKEN \
  --set proxy.https=http://proxy.example.com:3128

Namespace-Scoped Access​

To limit the agent to specific namespaces, see Agent RBAC.

Upgrading​

To upgrade to the latest agent version:

helm repo update opsworker
helm upgrade opsworker-agent opsworker/opsworker-agent -n opsworker

Next Steps​