2. Deploy

Overview

This guide walks you through deploying the monitoring stack (Grafana, Loki, Prometheus, Alertmanager) using Helmfile.

Steps

Step 1: Navigate to the Monitoring Directory

Move to the directory that contains the monitoring Helmfile.

cd deploy-as-code/helm/charts/monitoring

This directory contains the monitoring-helmfile.yaml, that controls the deployment.

Step 2: Preview the Kubernetes Manifests (Dry Run)

Verify the environment configuration. Open monitoring-helmfile.yaml and confirm the environment name.

helmfile -f monitoring-helmfile.yaml -e <environment> template

Why this matters

• Validates Helm values and templates

• Helps catch configuration issues early

• Shows exactly what Kubernetes resources will be created

Step 3: Review the Differences (Diff)

Compare the currently deployed resources with the desired state defined in Helmfile.

• helmfile -f monitoring-helmfile.yaml -e <environment> diff

Step 4: Apply the Changes to the Cluster

Once the diff looks correct, apply the changes to the Kubernetes cluster.

helmfile -f monitoring-helmfile.yaml -e <environment> apply

In the above commands, use the environment as set in monitoring-helmfile.yaml; in this case, it’ll be “demo“. Example - helmfile -f monitoring-helmfile.yaml -e demo apply

This will:

• Install the monitoring stack if not already present

• Upgrade existing components if the configuration has changed