Docs: Consolidate OaC intros (#113895)

* Consolidate

* Edits

* Remove Get started

* Prettier

* Edit

* Removing Grizzly

* Prettier
This commit is contained in:
Anna Urbiztondo
2025-11-17 15:10:31 +01:00
committed by GitHub
parent c4f2f3f6f4
commit 2dfcaf9be8
8 changed files with 46 additions and 340 deletions
@@ -5,10 +5,12 @@ keywords:
- Grafana Cloud
- Grizzly
- CLI
menuTitle: Grizzly
menuTitle: Grizzly (deprecated)
title: Grizzly
weight: 130
weight: 200
canonical: https://grafana.com/docs/grafana/latest/as-code/infrastructure-as-code/grizzly/
aliases:
- ../infrastructure-as-code/grizzly/dashboards-folders-datasources
---
# Grizzly (deprecated)
@@ -18,5 +20,3 @@ Grizzly has been removed. It is no longer deployed, enhanced, or supported.
Use the [Grafana CLI](/docs/grafana/<GRAFANA_VERSION>/observability-as-code/grafana-cli/) instead.
{{< /admonition >}}
[Grizzly](https://grafana.github.io/grizzly/) is a command line tool that allows you to manage your observability resources with code. You can use it to manage dashboards, data sources, Prometheus rules, and Synthetic monitoring.
@@ -1,149 +0,0 @@
---
keywords:
- Infrastructure as Code
- Quickstart
- Grafana Cloud
- Grizzly
title: Creating and managing folders, data sources, and dashboards using Grizzly
weight: 100
canonical: https://grafana.com/docs/grafana/latest/as-code/infrastructure-as-code/grizzly/dashboards-folders-datasources/
---
# Creating and managing folders, data sources, and dashboards using Grizzly
Learn how to add a data sources, folders and dashboard, using Grizzly.
## Prerequisites
Before you begin, you should have the following available:
- A Grafana Cloud account
- An existing Grafana Cloud stack with a Grafana API Key
- [Grizzly](https://grafana.github.io/grizzly/installation/) installed on your machine
## Authentication Setup
To authenticate with the Grizzly API, you must create environment variables. Run the following commands to create environment variables named `GRAFANA_URL` and `GRAFANA_TOKEN`:
```shell
export GRAFANA_URL=<Grafana-instance-url>
export GRAFANA_TOKEN=<Grafana-API-Key>
```
Replace the following field values:
- `<Grafana-instance-url>` with the URL of your Grafana instance.
- `<Grafana-API-Key>` with API key from the Grafana instance.
## Add a data source
The following steps use the InfluxDB data source. The required arguments vary depending on the data source you select.
1. Create a file named `data-source.yml` and add the following:
```yaml
apiVersion: grizzly.grafana.com/v1alpha1
kind: Datasource
metadata:
name: <data-source-name>
spec:
name: <data-source-name>
type: influxdb
url: <data-source-url>
database: <db-name>
user: <username>
secureJsonData:
password: '<password>'
uid: <uid>
id: <id>
access: proxy
```
1. Replace the following field values:
- `<data-source-name>` with the name of the data source to be added in Grafana.
- `<data-source-url>` with URL of your data source.
- `<username>` with the username for authenticating with your data source.
- `<password>` with the password for authenticating with your data source.
- `<db-name>` with name of your database.
- `<id>` with the ID for your data source in Grafana.
- `<uid>` wth the UID for your data source in Grafana.
## Add a folder
The following YAML definition creates a folder in your Grafana instance.
1. Create a file named `folder.yml` and add the following:
```yaml
apiVersion: grizzly.grafana.com/v1alpha1
kind: DashboardFolder
metadata:
name: <folder-name>
spec:
title: <folder-name>
uid: <uid>
```
1. Replace the following field values:
- `<folder-name>` with the name of the folder to be added in Grafana.
- `<uid>` with the UID for your folder in Grafana.
## Add a dashboard to the folder
Use the following YAML definition to create a simple dashboard in the Grafana instance folder from the previous step. To add more than a title and UID to the dashboard, you can convert your dashboard JSON config to YAML and paste it under `spec`.
1. Create a file named `dashboard.yml` and add the following:
```yaml
apiVersion: grizzly.grafana.com/v1alpha1
kind: Dashboard
metadata:
folder: <folder-name>
name: influxdb-cloud-demos
spec:
title: InfluxDB Cloud Demos
uid: influxdb-cloud-demos
```
1. Replace the following field values:
- `<folder-name>` with the name of the folder created in the previous step.
## Using Grizzly CLI
In a terminal, run the following commands from the directory where all of the YAML definitions are located.
1. Add the data source.
```shell
grr apply data-source.yml
```
1. Add a folder.
```shell
grr apply folder.yml
```
1. Add a dashboard to the folder.
```shell
grr apply dashboard.yml
```
## Validation
Once you apply the configurations using the Grizzly CLI, you should be able to verify the following:
- A new data source (InfluxDB in this example) is visible in Grafana.
![InfluxDB datasource](/static/img/docs/grafana-cloud/terraform/influxdb_datasource_tf.png)
- A new dashboard and folder in Grafana. In the following image a dashboard named `InfluxDB Cloud Demos` was created inside the `Demos` folder.
![InfluxDB dashboard](/static/img/docs/grafana-cloud/grizzly/grizzly-folder-dashboard-datasource.png)
## Conclusion
In this guide, you created a data source, folder, and dashboard using Grizzly.
To learn more about managing Grafana using Grizzly, see the [Grizzly documentation](https://grafana.github.io/grizzly/).