d5a1781fb6
* Initial migration pending to test * Update tests * apply feedback * Remove unnecessary types * Fix types * Update tests * fixing tests * Default DS for transformer * Update the default DS * Update the generated sdk files * Restore commented tests * Update tests * Updating snapshots * fix * Do not preserve empty datasource in panel spec * update provisioning v2 sample dashboard * Fix test * Prettier * Fix import e2e * Prettier * restore commented tests * Update to support annotations * Lint * Make gen apps * Make the build pass Signed-off-by: Igor Suleymanov <igor.suleymanov@grafana.com> * Update grafana-app-sdk to 0.39.2 * Workspace update * make gen-cue * Runtime error fix * Update dashboard spec * Update go workspaces * Schema V2: Simplify annotations v1<->v2 conversions * Update public/app/features/dashboard-scene/serialization/transformSceneToSaveModelSchemaV2.ts * Cleanup and some more tests * test improvement * Update public/app/features/dashboard-scene/serialization/transformSceneToSaveModelSchemaV2.ts * Update go.sum * make generate * Update public/app/features/dashboard-scene/serialization/transformSceneToSaveModelSchemaV2.ts Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com> * ts * make gen-apps * Update response transformers to correctly handle v2->v1 annotations * Update dashboards openapi snapshot --------- Signed-off-by: Igor Suleymanov <igor.suleymanov@grafana.com> Co-authored-by: Ivan Ortega <ivanortegaalba@gmail.com> Co-authored-by: alexandra vargas <alexa1866@gmail.com> Co-authored-by: Haris Rozajac <haris.rozajac12@gmail.com> Co-authored-by: Igor Suleymanov <igor.suleymanov@grafana.com> Co-authored-by: spinillos <selenepinillos@gmail.com> Co-authored-by: Haris Rozajac <58232930+harisrozajac@users.noreply.github.com>
This folder contains a rendered OpenAPI file for each group/version. The “real” OpenAPI is generated by the running server, but the files here are used to build static frontend clients.
Generating RTK API Clients
The RTK API clients are generated from processed OpenAPI files using the scripts/process-specs.ts script. The source files are in pkg/tests/apis/openapi_snapshots, and the processed files are stored in the data/openapi directory. Spec processing happens as part of yarn generate-apis task, but can also be triggered separately (see below).
To generate or update the RTK API clients:
-
If generating or updating an RTK client for the first time, update
scripts/generate-rtk-apis.jssoschemaFilepoints to the processed spec files, for example:'../public/app/features/dashboards/api/endpoints.gen.ts': { schemaFile: '../data/openapi/dashboard.grafana.app-v0alpha1.json', }, -
Generate or update the OpenAPI spec files by running:
go test pkg/tests/apis/openapi_test.goIf generating an RTK client for a new API, also add a new group/version of the API to the
groupsslice. If the API is behind a feature toggle, add the toggle toEnableFeatureTogglesinpkg/tests/apis/openapi_test.go. -
Run:
yarn generate-apisThis command generates (or updates) the spec files in the
data/openapidirectory and generates the RTK API clients.
If you want to process the OpenAPI files without generating the RTK API clients (for example, if you have a separate generate-rtk-apis file), run:
yarn process-specs