Query Garden Linux Releases

This guide shows how to use glrd to retrieve release information from the Garden Linux Release Database (GLRD).

Prerequisites

• glrd installed. See Run GLRD.
• A network connection to the GLRD Amazon S3 bucket (default input source).

To use local release files instead of the S3 endpoint, add --input-type file to any command. See the CLI reference for all available input flags.

Get the latest release

Get the latest active minor release with default shell output:

glrd --latest

Example output:

Name            Version  Type    GitCommitShort    ReleaseDate    ExtendedMaintenance    EndOfMaintenance
minor-1592.6     1592.6  minor   cb05e11f          2025-02-19     N/A                    2025-08-12

Get only the version number

Use --fields and --no-header to extract a single field for scripting:

glrd --latest --fields Version --no-header

Example output:

1592.6

Get JSON output

Use --output-format json to retrieve the full release object:

glrd --latest --output-format json

The JSON output includes all schema fields for the release, including version, lifecycle, git, github, flavors, oci, and attributes. See the GLRD Release Schema for field definitions.

Version note

For v2 releases (major ≥ 2017.0.0), the version object includes a patch field. For v1 releases (major < 2017.0.0), no patch field is present.

Extract a version string from JSON output

Pipe JSON output to jq to extract a specific field:

glrd --latest --output-format json | jq -r '.releases[] | "\(.version.major).\(.version.minor)"'

Example output:

1592.6

For v2 releases, include the patch component:

glrd --latest --output-format json | jq -r '.releases[] | "\(.version.major).\(.version.minor).\(.version.patch)"'

List all active releases

Show all currently active major and minor releases (end-of-life date in the future):

glrd --active

Example output:

Name             Version  Type    GitCommitShort    ReleaseDate    ExtendedMaintenance    EndOfMaintenance
major-1443       1443     major   N/A               2024-03-13     2024-09-13             2025-01-13
minor-1443.15    1443.15  minor   5d33a69           2024-10-10     N/A                    2025-01-13
major-1592       1592     major   N/A               2024-08-12     2025-05-12             2025-08-12
minor-1592.1     1592.1   minor   ec945aa           2024-08-22     N/A                    2025-08-12

Filter by release type

Show only nightly releases:

glrd --type nightly

Show major and next releases:

glrd --type major,next

Filter by version

Show all releases for a specific major version:

glrd --version 1592

Show a specific minor release:

glrd --version 1592.6

Generate a Mermaid Gantt chart

Use --output-format mermaid_gantt to produce a Mermaid Gantt chart of active releases. This is useful for embedding in documentation or dashboards.

glrd --active --type next,major --output-format mermaid_gantt --output-description "Garden Linux active Releases"

Example output:

gantt
    title Garden Linux active Releases
    axisFormat %m.%y
    section 1443
        Release:                milestone, 2024-03-13, 0m
        Standard maintenance:       task, 2024-03-13, 6M
        Extended maintenance:       milestone, 2024-09-13, 0m
        Extended maintenance:       task, 2024-09-13, 4M
        End of maintenance:         milestone, 2025-01-13, 0m
    section 1592
        Release:                milestone, 2024-08-12, 0m
        Standard maintenance:       task, 2024-08-12, 9M
        Extended maintenance:       milestone, 2025-05-12, 0m
        Extended maintenance:       task, 2025-05-12, 3M
        End of maintenance:         milestone, 2025-08-12, 0m

Query from a local file

To run glrd without network access, download the JSON files first and point glrd at them:

# Download release data
curl -s https://gardenlinux-glrd.s3.eu-central-1.amazonaws.com/releases-major.json -o releases-major.json
curl -s https://gardenlinux-glrd.s3.eu-central-1.amazonaws.com/releases-minor.json -o releases-minor.json

# Query from local files
glrd --input-type file --latest

Related topics

• Garden Linux Release Database (GLRD)How-to guides for running, querying, and managing Garden Linux Release Database (GLRD) entries.
• Run GLRDHow to install and run the GLRD tools locally, in a container, or via GitHub Actions.
• Manage GLRD entriesStep-by-step examples for creating, updating, and deleting Garden Linux releases database entries using the glrd-manage CLI tool.
• Garden Linux Release Database (GLRD)Overview of the Garden Linux Release Database (GLRD): a system for managing and querying Garden Linux release information.
• GLRD CLI ReferenceComplete flag and option reference for the glrd and glrd-manage command-line tools.
• GLRD Release SchemaJSON schema reference for Garden Linux Release Database (GLRD) release types: major, minor, nightly, dev, and next.
• GLRD Release LifecycleExplains lifecycle dependencies between major and minor releases, default date calculations, nightly and dev date rules, and the GLRD versioning scheme.