On Kubernetes it's possible to use Helm or install it via Deployment resource specification.

Helm

Make sure you have helm installed in your machine. Check Helm installation page

shell
VERSION=$(curl -s https://releases.hoop.dev/release/latest.txt)
helm upgrade --install hoopagent \
	https://releases.hoop.dev/release/$VERSION/hoopagent-chart-$VERSION.tgz \
	--set "config.HOOP_KEY=<AUTH-KEY>"

Using Manifests

shell
VERSION=$(curl -s https://releases.hoop.dev/release/latest.txt)
helm template hoopagent \
	https://releases.hoop.dev/release/$VERSION/hoopagent-chart-$VERSION.tgz \
	--set 'config.HOOP_KEY=<AUTH-KEY>' \
  --set 'image.tag=1.21.9' \
  --set 'extraSecret=AWS_REGION=us-east-1'

This example allows pining the version to 1.21.9 and providing extra secrets as environment variables to the agent.

⚠️

Starting from version 1.21.9, there is only one way to configure the agent key, which is by using the config.HOOP_KEY configuration. This requires creating a key in a DSN format in the API. To use legacy options, use the Helm chart version 1.21.4.

Standalone Deployment

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: hoopagent
spec:
  replicas: 1
  selector:
    matchLabels:
      app: hoopagent
  template:
    metadata:
      labels:
        app: hoopagent
    spec:
      containers:
      - name: hoopagent
        image: hoophq/hoopdev
        env:
        - name: HOOP_KEY
          value: '<AUTH-KEY>'

Sidecar Container

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 1
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
      - name: myapp
        image: myapp
        ports:
        - containerPort: 8000
          name: http
          protocol: TCP
      - name: hoopagent
        image: hoophq/hoopdev
        env:
        - name: HOOP_KEY
          value: '<AUTH-KEY>'