Add Grafana to dev_setup.sh

Add subscription to community Grafana operator and
configure ArgoCD to deploy a Grafana instance using the
mainfests from redhat-appstudio. A separate GrafanaDashboard
instance is created using the in-tree dashboard manifests,
which allows Pipeline Service contributors to iterate on
the dashboard via GitOps. Instructions on how to do "inner
loop" developement are included in a README.

Author: adambkaplan

developer/openshift/gitops/argocd/pipeline-service-o11y/README.md

@@ -1,5 +1,40 @@
 # Pipeline Service Observability
 
-This deploys observability (o11y) components used to configure Prometheus.
-It utilizes the o11y stack from redhat-appstudio, with modifications to only deploy
-what is needed by the Pipeline Service for inner-loop development.
+This deploys observability (o11y) components used to configure Prometheus and
+Grafana. It utilizes the o11y stack from redhat-appstudio, with modifications
+to only deploy what is needed by the Pipeline Service for GitOps-based
+development.
+
+## GitOps Inner Loop Development
+
+The `dev_setup.sh` configures Prometheus and Grafana to deploy the Pipeline
+Service dashboards. Grafana's UI can be accessed at the
+`grafana-access-appstudio-grafana.apps...` route on your cluster.
+
+To iterate on your dashboard (deploying with `--use-current-branch`):
+
+1. Navigate to the Pipeline Service dashboard in Grafana.
+2. Add the panels and/or rows for your metrics as desired.
+3. Click the "Share" icon to save the dashboard to JSON.
+4. Copy the JSON into the pipeline-service-dashboard.json file, located in
+   `operator/gitops/argocd/grafana/dashboards`.
+5. Commit the updated JSON, push to your branch, and verify the dashboard is
+   updated once ArgoCD syncs your repository.
+
+## Components
+
+### appstudio-prometheus
+
+This configures the Red Hat
+[Observability Operator](https://github.com/rhobs/observability-operator) using
+the same manifests used by App Studio. The operator consolidates the "cluster
+monitoring" and "user workload" monitoring stacks, allowing metrics to combined
+in a single data source view.
+
+### appstudio-grafana
+
+This configures the [Grafana Operator](https://github.com/grafana-operator/grafana-operator)
+using the same manifests as App Studio. The operator deploys and manages
+Grafana instances, and lets dashboards be configured with custom resources and
+JSON stored in ConfigMaps. The deployment includes the Pipeline Service
+dashboard, which is referenced in-tree.

developer/openshift/gitops/argocd/pipeline-service-o11y/appstudio-grafana/allow-argocd-to-manage.yaml

@@ -0,0 +1,77 @@
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: openshift-gitops-apply-grafana
+rules:
+  - apiGroups:
+      - integreatly.org
+    resources:
+      - grafanas
+      - grafanadashboards
+      - grafanadatasources
+    verbs:
+      - get
+      - list
+      - create
+      - update
+      - patch
+      - delete
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: openshift-gitops-apply-grafana
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: openshift-gitops-apply-grafana
+subjects:
+  - kind: ServiceAccount
+    name: openshift-gitops-argocd-application-controller
+    namespace: openshift-gitops
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: Role
+metadata:
+  name: openshift-gitops-manage-grafana
+  namespace: appstudio-grafana
+rules:
+  - apiGroups:
+      - ""
+    resources:
+      - secrets
+      - configmaps
+      - serviceaccounts
+    verbs:
+      - get
+      - list
+      - create
+      - update
+      - patch
+      - delete
+  - apiGroups:
+      - route.openshift.io
+    resources:
+      - routes
+    verbs:
+      - get
+      - list
+      - create
+      - update
+      - patch
+      - delete
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: RoleBinding
+metadata:
+  name: openshift-gitops-manage-grafana
+  namespace: appstudio-grafana
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: Role
+  name: openshift-gitops-manage-grafana
+subjects:
+  - kind: ServiceAccount
+    name: openshift-gitops-argocd-application-controller
+    namespace: openshift-gitops

developer/openshift/gitops/argocd/pipeline-service-o11y/appstudio-grafana/kustomization.yaml

@@ -0,0 +1,14 @@
+---
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+resources:
+  - allow-argocd-to-manage.yaml
+  - namespace.yaml
+  - https://raw.githubusercontent.com/redhat-appstudio/infra-deployments/main/components/monitoring/grafana/base/grafana-operator.yaml
+  - https://raw.githubusercontent.com/redhat-appstudio/infra-deployments/main/components/monitoring/grafana/base/grafana-app.yaml
+  - ../../../../../../operator/gitops/argocd/grafana
+commonAnnotations:
+  argocd.argoproj.io/sync-options: SkipDryRunOnMissingResource=true
+namespace: appstudio-grafana
+configurations:
+  - https://raw.githubusercontent.com/redhat-appstudio/infra-deployments/main/components/monitoring/grafana/base/cm-dashboard.yaml

developer/openshift/gitops/argocd/pipeline-service-o11y/appstudio-grafana/namespace.yaml

@@ -0,0 +1,6 @@
+---
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: appstudio-grafana
+spec: {}

developer/openshift/gitops/argocd/pipeline-service-o11y/kustomization.yaml

@@ -3,3 +3,4 @@ apiVersion: kustomize.config.k8s.io/v1beta1
 kind: Kustomization
 resources:
   - appstudio-prometheus
+  - appstudio-grafana