v3.0.0

Recommended upgrade procedure

Bump the Terraform provider to the latest v2 version, apply, then upgrade to v3 and remove/replace all the attributes that have been removed.

Major features

Terraform Config Generation (Alpha version)

See the README here.

This is a new tool that will be developed further in future releases. It can be pointed at a Grafana instance or at a Grafana Cloud account and it will find all Grafana provider resources and generate the Terraform config for them.

Example (with the binary from this release):

./terraform-provider-grafana-generate_3.0.0_darwin_arm64 --output-dir test --grafana-auth=admin:admin --grafana-url=http://localhost:3000/

Grafana 11 Support

Some Terraform features had to be removed to enable full Grafana 11 support. All resources should now work with Grafana 11 (Cloud, on-prem Enterprise and on-prem OSS).

Breaking changes

Removed the global (provider-level) org_id setting

Reasons for its removal:

• The attribute was already added on each resource, so it doesn't remove any functionality
• It's irrelevant to all parts of the provider other than Grafana resources, possibly causing confusing since there's also an org concept on cloud resources
• Even for Grafana, it does not apply to all resources. For example, users are not org-scoped. By setting it on a resource level, this is much better defined
• When using it globally, it prevents looping on multiple orgs. Ex: Create dashboards for a list of orgs. Providers cannot be created dynamically

Removed support for old ID separators (converge on :)

This makes importing resources consistent across all parts of the provider. For example:

terraform import grafana_folder.test orgID:folderUID
terraform import grafana_dashboard.test orgID:dashboardUID

Removed deprecated resources

• grafana_api_key: Use grafana_service_account instead
• grafana_cloud_stack_api_key: Use grafana_cloud_stack_service_account instead
• grafana_cloud_api_key: Use grafana_cloud_access_policy instead
• grafana_oncall_action : Use grafana_oncall_outgoing_webhook instead

Removed deprecated attributes

• Removed numerical IDs (of dashboards, folders, datasources) in favour of UIDs
• grafana_report dashboard definition converged onto a single dashboards {} block
• cloud_api_key provider attribute: Use cloud_access_policy_token instead

Changelog

• SSO: Improve SSO settings examples by @dmihai in #1549
• Deprecate global org_id config by @julienduchesne in #1516
• Deprecate old ID separators by @julienduchesne in #1518
• Deprecate Cloud API keys by @julienduchesne in #1517
• Remove all deprecated attributes and resources by @julienduchesne in #1529
• Fix README links and images by @julienduchesne in #1554
• Add goreleaser config for code generation tool by @julienduchesne in #1555
• Code Generation: Add readme and warnings by @julienduchesne in #1556
• Link changelog in TF provider docs by @julienduchesne in #1559
• Update synthetic monitoring frequency value validation by @tomaszgawliksa in #1561
• Clear out CHANGELOG.md by @julienduchesne in #1560
• Bump github.com/hashicorp/terraform-plugin-mux from 0.15.0 to 0.16.0 in the terraform group by @dependabot in #1562
• Bump github.com/fatih/color from 1.16.0 to 1.17.0 by @dependabot in #1564
• Bump github.com/hashicorp/go-retryablehttp from 0.7.5 to 0.7.6 by @dependabot in #1563
• Run tests on Grafana v11 by @julienduchesne in #1415
• Cloud: Fix SM installation test by @julienduchesne in #1568
• Cloud: More test fixes by @julienduchesne in #1569

New Contributors

• @tomaszgawliksa made their first contribution in #1561

Full Changelog: v2.19.0...v3.0.0

v2.19.0

What's Changed

• SSO: add skip_org_role_sync field to SAML settings by @dmihai in #1510
• SSO: update docs stating that SAML support is in preview by @dmihai in #1509
• Bump github.com/grafana/synthetic-monitoring-agent from 0.23.3 to 0.23.4 by @dependabot in #1506
• Bump the terraform group with 3 updates by @dependabot in #1505
• Users: ignore case when diffing email and login by @IevaVasiljeva in #1512
• Update oncall_schedule.md by @gthompson280 in #1513
• Terraform Code Generation: Add "lister" function interface by @julienduchesne in #1501
• Terraform Code Generation: Add listers for Grafana resources by @julienduchesne in #1504
• Code Generation: Support json format by @julienduchesne in #1519
• Bump github.com/urfave/cli/v2 from 2.27.1 to 2.27.2 by @dependabot in #1523
• Bump github.com/hashicorp/terraform-plugin-docs from 0.19.1 to 0.19.2 in the terraform group by @dependabot in #1522
• Code Generation: Working prototype for Grafana by @julienduchesne in #1514
• Upgrade Grafana client to latest version by @julienduchesne in #1521
• Code Generation: Grafana Cloud by @julienduchesne in #1528
• Grafana oncall integration data source by @julienduchesne in #1532
• Datasources: Fix numerical UIDs by @julienduchesne in #1531
• Code Generation: Functional Alpha version by @julienduchesne in #1533
• Bump iFaxity/wait-on-action from 1.1.0 to 1.2.1 by @dependabot in #1536
• Bump github.com/tmccombs/hcl2json from 0.6.2 to 0.6.3 by @dependabot in #1539
• Bump golang.org/x/text from 0.14.0 to 0.15.0 by @dependabot in #1538
• Bump github.com/hashicorp/terraform-plugin-go from 0.22.2 to 0.23.0 in the terraform group by @dependabot in #1537
• Bump github.com/grafana/synthetic-monitoring-agent from 0.23.4 to 0.24.1 by @dependabot in #1540
• Cloud Stacks: Better "wait for readiness" by @julienduchesne in #1545
• SSO: Update docs removing azuread from api_url requirements by @dmihai in #1548
• SSO: Fix and improve SAML validations by @dmihai in #1542
• Role Datasource: Find hidden roles by @julienduchesne in #1552
• Add folder UID validation by @julienduchesne in #1551
• grafana_rule_group: Detect name conflicts by @julienduchesne in #1550
• grafana_cloud_stack_service_account: Compatibility with roles/permissions by @julienduchesne in #1546
• TestAccGrafanaServiceAccountFromCloud_AssignRoleOrPermissions: Not parallel by @julienduchesne in #1557

New Contributors

• @gthompson280 made their first contribution in #1513

Full Changelog: v2.18.0...v2.19.0

v2.18.0

What's Changed

• Roles: Unskip Grafana Cloud test by @julienduchesne in #1480
• Permission resources: Common code by @julienduchesne in #1482
• Add grafana_role_assignment_item resource by @julienduchesne in #1484
• grafana_oncall_team: Add retry by @julienduchesne in #1486
• Bump github.com/grafana/synthetic-monitoring-agent from 0.23.2 to 0.23.3 by @dependabot in #1491
• TestAccExampleWithReplace: Make sure replace is actually done by @julienduchesne in #1489
• Bump github.com/hashicorp/terraform-plugin-docs from 0.18.0 to 0.19.0 in the terraform group by @dependabot in #1490
• Alerting Notification Policy: Allow inheriting contact point by @julienduchesne in #1488
• Plugin Framework: Fix Configure function by @julienduchesne in #1487
• grafana_service_account: Require role attribute by @julienduchesne in #1495
• Fix grafana_alert_rule_group imports by @julienduchesne in #1496
• Fix playlist updates by @julienduchesne in #1498
• Fix SM docs link by @julienduchesne in #1500
• grafana_service_account: Fix updates on v11 by @julienduchesne in #1503

Full Changelog: v2.17.0...v2.18.0

v2.17.0

What's Changed

• Add grafana_service_account_permission_item resource by @julienduchesne in #1478
• SSO: Improve Azure AD validation by @mgyongyosi in #1390
• Roles: Remove global role validation by @julienduchesne in #1479
• Add grafana_dashboard_permission_item resource by @julienduchesne in #1481
• SSO: add saml support for the sso settings resource by @dmihai in #1474

New Contributors

• @mgyongyosi made their first contribution in #1390

Full Changelog: v2.16.0...v2.17.0

v2.16.0

What's Changed

• Bump github.com/grafana/synthetic-monitoring-agent from 0.23.1 to 0.23.2 by @dependabot in #1472
• SSO: Prepare for integrating SAML into grafana_sso_settings resource by @dmihai in #1473
• Implement grafana_folder_permission_item resource by @julienduchesne in #1465
• grafana_oncall_escalation: Add notify_team_members option by @julienduchesne in #1477
• Implement grafana_data_source_permission_item by @julienduchesne in #1470
• Permission Items: Common code by @julienduchesne in #1471
• grafana_organization_preferences: Managed by SA token by @julienduchesne in #1476

Full Changelog: v2.15.0...v2.16.0

v2.15.0

What's Changed

• Deprecate datasource_id on ML resources by @csmarchbanks in #1439
• Oncall: Use common resource framework by @julienduchesne in #1438
• Add KeepLast to NoDataState & ExecErrState in Alerting Rule Group by @Cleymax in #1442
• Bump the terraform group with 1 update by @dependabot in #1446
• Alerting Mute Timings: Add disable_provenance by @julienduchesne in #1417
• Update docs: Redirects by @julienduchesne in #1448
• Datasources: Prevent headers from being set in json_data by @julienduchesne in #1447
• Add grafana_data_source_config resource by @miljanic in #1441
• Run enterprise tests on more versions by @julienduchesne in #1343
• Ignore CSS rule failures in linkchecker by @julienduchesne in #1451
• SM: Use common resource framework by @julienduchesne in #1434
• Grafana: Use common resource framework by @julienduchesne in #1445
• Reports: Fix PDF format being added twice by @julienduchesne in #1444
• Update openapi client to latest version by @julienduchesne in #1443
• Reject tokens on global-scoped resources by @julienduchesne in #1421
• Bump ScribeMD/docker-cache from 0.4.0 to 0.5.0 by @dependabot in #1458
• Bump github.com/hashicorp/hcl/v2 from 2.20.0 to 2.20.1 by @dependabot in #1457
• SM: include examples for multihttp by @rdubrock in #1455
• Docs: update docs for local development with Grafana by @dmihai in #1460
• Fully support TF plugin framework by @julienduchesne in #1459
• Alert Rule Group: Migrate away from legacy ID format by @julienduchesne in #1453
• Expose client creation and provider config by @julienduchesne in #1461
• Cloud: Add new cloud_org_member resource by @julienduchesne in #1435
• Fix grafana_cloud_stack_service_account resource to support creating service accounts without a basic role by @F21 in #1464
• Rename cloud_api_key in docs by @julienduchesne in #1466
• grafana_oncall_escalation resource - drop support for type = trigger_action + add support for type = trigger_webhook by @joeyorlando in #1467
• Datasource: Use UID instead of numerical ID by @julienduchesne in #1468
• Folder: Use UID instead of numerical ID by @julienduchesne in #1469

New Contributors

• @miljanic made their first contribution in #1441
• @F21 made their first contribution in #1464
• @joeyorlando made their first contribution in #1467

Full Changelog: v2.14.3...v2.15.0

v2.14.3

What's Changed

• Fix service_account_id reference in stack_service_account_token resource by @julienduchesne in #1431
• ML: each Jobs test creates a datasource to depend on by @gerboland in #1422
• Remove global resources var by @julienduchesne in #1432
• Update module in go.mod by @julienduchesne in #1430
• cloud_stack_service_account: Use new GET and DELETE endpoints by @julienduchesne in #1437

Full Changelog: v2.14.2...v2.14.3

v2.14.2

What's Changed

• Convert Cloud resources to new "resource" framework by @julienduchesne in #1391
• Bump ScribeMD/docker-cache from 0.3.7 to 0.4.0 by @dependabot in #1428
• Bump github.com/grafana/synthetic-monitoring-agent from 0.22.0 to 0.23.1 by @dependabot in #1429
• Expose the provider package by @julienduchesne in #1427
• One more fix for grafana_cloud_stack_service_account by @julienduchesne in #1426

Full Changelog: v2.14.1...v2.14.2

v2.14.1

What's Changed

• Tests: Replace ProviderFactories with ProtoV5ProviderFactories by @julienduchesne in #1423
• Fix grafana_cloud_service_account read by @julienduchesne in #1424

Full Changelog: v2.14.0...v2.14.1

v2.14.0

What's Changed

• Bump the terraform group with 4 updates by @dependabot in #1409
• Bump github.com/go-openapi/strfmt from 0.22.2 to 0.23.0 by @dependabot in #1410
• Bump github.com/go-openapi/runtime from 0.27.2 to 0.28.0 by @dependabot in #1411
• Alerting: Add support for notification settings for alert rules by @yuri-tceretian in #1407
• Cloud: Make full use of ID + import generation framework by @julienduchesne in #1412
• SM: Allow deleting probes that are in use by @julienduchesne in #1386
• Bump github.com/grafana/synthetic-monitoring-agent from 0.21.0 to 0.22.0 by @dependabot in #1414
• Bump the terraform group with 1 update by @dependabot in #1413
• Folder datasource fixes by @julienduchesne in #1416
• Self-contained oncall package by @julienduchesne in #1418
• Self-contained SM package by @julienduchesne in #1419
• Self-contained grafana package by @julienduchesne in #1420

Full Changelog: v2.13.0...v2.14.0