github.com/esnet/gdg@v0.6.1-0.20240412190737-6b6eba9c14d8/website/content/docs/releases/gdg_0.6.md (about)

     1  ---
     2  title: "version v0.6"
     3  description: "Release Notes for v0.6"
     4  date: 2023-09-01T00:00:00
     5  draft: false
     6  images: [ ]
     7  weight: 197
     8  toc: true
     9  ---
    10  
    11  ## Release Notes for v0.6.0
    12  
    13  **Release Date: 03/11/2024**
    14  
    15  ### Breaking Changes
    16  
    17  - This is a major release, so once again doing some cleanups and introducing some breaking changes. Please use version
    18    v0.5.2 if you wish to maintain backward compatibility. Previous version organized downloads by org_id. Example an
    19    export for dashboards would be stored in `export/org_1/dashboards`. The org ID is inconsistent and something that
    20    cannot be guaranteed across installations of grafana. Instead, we've switched over to using a slug of the OrgName. The
    21    default dashboard backup will go in: `export/org_main-org/dashboards`.
    22  
    23    {{< callout context="caution" title="Caution" icon="alert-triangle" >}}
    24   If you renamed the default organization to something else besides `Main Org.`, be sure to set `organization_name` in your config, otherwise nothing will work.
    25    {{< /callout >}}
    26  - The import/export dashboards keyword provided confusion. It has been phased out bit by bit.  In version 0.6 all references have now been removed. Import has been renamed to `download`, and export is now `upload`.
    27  - `organization_id` is deprecated in the importer config in favor of `organization_name`.
    28  
    29  ### New Features
    30  
    31  - Retry logic. You can now set a number of `retry_count` and `retry_delay` in the configuration that retries failed API calls
    32  - User upload now has the ability to generate random passwords.  (Please be aware that those values can't be recreated)
    33  - JSON output has been added.  This can be somewhat unstructured but is available to the user. `--output json` with the default rendering being table format.
    34  - Linter support! (Beta) Grafana official linter has been added to GDG `tools dashboard lint`.
    35  - `gdg-generate` CLI behavior has been updated to better mimic what `gdg` is already doing.  Restructuring into subcommands.
    36  - Org Preferences can now be retrieved when listing Orgs. `--with-preferences`
    37    {{< callout context="caution" title="Caution" icon="alert-triangle" >}}
    38  This is a heavy call currently till this [issue](https://github.com/grafana/grafana/issues/84309) is resolved.  Use with caution if you have many Organizations in your grafana instance.
    39    {{< /callout >}}
    40  
    41  ### Changes
    42  
    43  - [#192](https://github.com/esnet/gdg/issues/192) Dropping support for various entities. import/export no longer
    44    supported. Removed warning for datasources (Deprecated config). Removed AlertNotification as it's been deprecated from
    45    grafana for a while now.
    46  - [#254](https://github.com/esnet/gdg/issues/254) [#258](https://github.com/esnet/gdg/issues/258) org_id usage has been
    47    deprecated. Switching mainly using orgName / SlugName to allow for a more consistent experience between grafana
    48    installations. Change affects gdg and gdg-generate
    49  - User import now has support for random password generator. Only printed upon import.
    50  - [#259](https://github.com/esnet/gdg/issues/259) Adding support for Org Properties. Allowing a user to update a given
    51    orgs properties. Data also added to org Listing.
    52  - [#251](https://github.com/esnet/gdg/issues/251) Adding a dashboard linter tool. The official grafana is recommended,
    53    but GDG will provide similar functionality.
    54  
    55  ### Bug Fixes
    56  - [#253](https://github.com/esnet/gdg/issues/253) In order to manage orgs, the grafana admin that is configured needs to be a part of all organizations.  This ticket adds a sanity check to ensure that the configured Grafana Admin is part of all known organizations.  It then programmatically adds the user (if user confirms and the feature is supported), otherwise gdg will list all orgs that the user needs to be added.
    57  -
    58  
    59  ### Developer Changes
    60  
    61  - Upgraded to go 1.22
    62  - Updated documentation instructions relating to install
    63  - Website theme upgraded to latest version