---
title: "Deploy Pyroscope with Jsonnet and Tanka | Grafana Pyroscope documentation"
description: "Learn how to deploy Pyroscope on Kubernetes with Jsonnet and Tanka."
---

# Deploy Pyroscope with Jsonnet and Tanka

Grafana Labs publishes a [Jsonnet](https://jsonnet.org/) library that you can use to deploy Pyroscope. The Jsonnet files are located in the [Pyroscope repository](https://github.com/grafana/pyroscope/tree/main/operations/pyroscope/jsonnet) and are using the helm charts as a source.

## Install tools and deploy the first cluster

You can use [Tanka](https://tanka.dev/) and [jsonnet-bundler](https://github.com/jsonnet-bundler/jsonnet-bundler) to generate Kubernetes YAML manifests from the jsonnet files.

1. Install `tanka` and `jb`:
   
   Follow the steps at [https://tanka.dev/install](https://tanka.dev/install). If you have `go` installed locally you can also use:
   
   console ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```console
   # make sure to be outside of GOPATH or a go.mod project
   go install github.com/grafana/tanka/cmd/tk@latest
   go install github.com/jsonnet-bundler/jsonnet-bundler/cmd/jb@latest
   ```
2. Set up a Jsonnet project, based on the example that follows:
   
   - Initialize Tanka
   - Install Pyroscope and Kubernetes Jsonnet libraries
   - Set up an environment
   
   console ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```console
   # Initialize a Tanka directory
   mkdir jsonnet-example && cd jsonnet-example
   tk init --k8s=1.21
   
   # Install Pyroscope jsonnet
   jb install github.com/grafana/pyroscope/operations/pyroscope@main
   
   # Install required tanka-util
   jb install github.com/grafana/jsonnet-libs/tanka-util@master
   
   # Setup your current cluster as the server for the default environment
   tk env set environments/default --server-from-context=$(kubectl config current-context)
   ```
3. Decide if you want to run Pyroscope in the monolithic or the microservices mode

<!--THE END-->

- Option A) For monolithic mode the file `environments/default/main.jsonnet`, should look like;
  
  jsonnet ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
  
  ```jsonnet
  local pyroscope = import 'pyroscope/jsonnet/pyroscope/pyroscope.libsonnet';
  local tk = import 'tk';
  
  pyroscope.new(overrides={
    namespace: tk.env.spec.namespace,
  })
  ```
- Option B) For microservices mode the file `environments/default/main.jsonnet`, should look like;
  
  jsonnet ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
  
  ```jsonnet
  local pyroscope = import 'pyroscope/jsonnet/pyroscope/pyroscope.libsonnet';
  local valuesMicroServices = import 'pyroscope/jsonnet/values-micro-services.json';
  local tk = import 'tk';
  
  pyroscope.new(overrides={
    namespace: tk.env.spec.namespace,
    values+: valuesMicroServices,
  })
  ```

<!--THE END-->

1. Generate the Kubernetes YAML manifests and store them in the `./manifests` directory:
   
   console ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```console
   # Take a look at the generated YAML manifests.
   tk show environments/default
   
   # Export the YAML manifests to the folder `./manifests`:
   tk export ./manifests environments/default
   ```
2. Deploy the manifests to a Kubernetes cluster, in one of two ways:
   
   - **Use the `tk apply` command**.
     
     Tanka supports commands to show the `diff` and `apply` changes to a Kubernetes cluster:
     
     console ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```console
     # Show the difference between your Jsonnet definition and your Kubernetes cluster:
     tk diff environments/default
     
     # Apply changes to your Kubernetes cluster:
     tk apply environments/default
     ```
   - **Use the `kubectl apply` command**.
     
     You generated the Kubernetes manifests and stored them in the `./manifests` directory in the previous step.
     
     You can run the following command to directly apply these manifests to your Kubernetes cluster:
     
     console ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
     
     ```console
     # Review the changes that will apply to your Kubernetes cluster:
     kubectl apply --dry-run=client -k manifests/
     
     # Apply the changes to your Kubernetes cluster:
     kubectl apply -k manifests/
     ```
   
   > **Note**: The generated Kubernetes manifests create resources in the `default` namespace. To use a different namespace, change the `namespace` configuration option in the `environments/default/main.jsonnet` file, and re-generate the Kubernetes manifests.