This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

Prerequisites

Before you begin, make sure you have:

  • A running Kubernetes cluster
  • Argo CD installed and configured in the cluster
  • Helm CLI installed (optional but useful for inspection and verification)

Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration:

helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update

Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired targetRevision:

helm search repo odigos --versions

Step 3: Define the Argo CD Application Manifest

Create an Argo CD Application custom resource to deploy Odigos using Helm. Save the following YAML as odigos-application.yaml: This guide shows you how to deploy Odigos in your Kubernetes cluster using Argo CD with the official Odigos Helm chart. This allows for GitOps-based management and observability instrumentation across your applications.

Prerequisites

Before you begin, make sure you have:

  • A running Kubernetes cluster
  • Argo CD installed and configured in the cluster
  • Helm CLI installed (optional but useful for inspection and verification)

Step 1: Add the Odigos Helm Repository

Add the Odigos Helm repository to your Helm configuration:

helm repo add odigos https://odigos-io.github.io/odigos --force-update
helm repo update

Step 2: Identify the Helm Chart Version

Check available versions of the Odigos chart to determine the desired targetRevision:

helm search repo odigos --versions

Step 3: Define the Argo CD Application Manifest

Create an Argo CD Application custom resource to deploy Odigos using Helm. Save the following YAML as odigos-application.yaml:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: odigos
  namespace: <ARGOCD_NAMESPACE>  # <- Replace with your Argo CD namespace
spec:
  project: default
  source:
    repoURL: https://odigos-io.github.io/odigos
    chart: odigos
    targetRevision:  # REQUIRED: set the version from 'helm search repo odigos --versions'
    helm:
      releaseName: odigos
      values: |
        # OPTIONAL: add your custom Helm values here if needed.
        # Argo CD expects this field to be a YAML-formatted string.
        # To use chart defaults, delete this field entirely or set it to an empty string ("").
  destination:
    server: https://kubernetes.default.svc
    namespace: <ODIGOS_NAMESPACE>  # <- Replace with the desired namespace where you want Odigos to be installed
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

Step 4: Apply the Application

Use kubectl to create the application in Argo CD:

kubectl apply -f odigos-application.yaml

This will instruct Argo CD to deploy Odigos using the Helm chart.

Step 5: Monitor the Deployment

You can monitor the status of the deployment through the Argo CD UI:

  • Navigate to your Argo CD web interface.
  • Find the application named odigos.
  • Verify that it reaches a Healthy and Synced state.

Once complete, Odigos will be installed in your cluster and ready to instrument workloads.