LogoLogo
  • Welcome to Gretel!
  • Gretel Basics
    • Getting Started
      • Quickstart
      • Blueprints
      • Use Case Examples
      • Environment Setup
        • Console
        • SDK
      • Projects
      • Inputs and Outputs
      • Gretel Connectors
        • Object Storage
          • Amazon S3
          • Google Cloud Storage
          • Azure Blob
        • Database
          • MySQL
          • PostgreSQL
          • MS SQL Server
          • Oracle Database
        • Data Warehouse
          • Snowflake
          • BigQuery
          • Databricks
        • Gretel Project
    • Release Notes
      • Platform Release Notes
        • May 2025
        • April 2025
        • March 2025
        • February 2025
        • January 2025
        • December 2024
        • November 2024
        • October 2024
        • September 2024
        • August 2024
        • July 2024
        • June 2024
      • Console Release Notes
        • January 2025
        • December 2024
        • November 2024
        • October 2024
        • September 2024
        • August 2024
      • Python SDKs
  • Create Synthetic Data
    • Gretel Safe Synthetics
      • Transform
        • Reference
        • Examples
        • Supported Entities
      • Synthetics
        • Gretel Tabular Fine-Tuning
        • Gretel Text Fine-Tuning
        • Gretel Tabular GAN
        • Benchmark Report
        • Privacy Protection
      • Evaluate
        • Synthetic Quality & Privacy Report
        • Tips to Improve Synthetic Data Quality
        • Data Privacy 101
      • SDK
    • Gretel Data Designer
      • Getting Started with Data Designer
      • Define your Data Columns
        • Column Types
        • Add Constraints to Columns
        • Custom Model Configurations
        • Upload Files as Seeds
      • Building your Dataset
        • Seeding your Dataset
        • Generating Data
      • Generate Realistic Personal Details
      • Structured Outputs
      • Code Validation
      • Data Evaluation
      • Magic Assistance
      • Using Jinja Templates
  • Gretel Playground [Legacy]
    • Getting Started
    • Prompts Tips & Best Practices
    • FAQ
    • SDK Examples
    • Tutorials
    • Videos
    • Gretel Playground [Legacy] Inference API
    • Batch Job SDK
  • Reference
    • Gretel's Python Client
    • Gretel’s Open Source Synthetic Engine
    • Gretel’s REST API
    • Homepage
    • Model Suites
Powered by GitBook
On this page
  • Release Schedule and Versioning
  • Gretel Cloud
  • Gretel Hybrid
  • Image Mirrors

Was this helpful?

Export as PDF
  1. Gretel Basics
  2. Release Notes

Platform Release Notes

PreviousRelease NotesNextMay 2025

Last updated 1 month ago

Was this helpful?

Gretel's Platform is comprised of control plane and data plane components.

The Gretel Data Plane is responsible for processing user-provided prompts and/or datasets and generating synthetic data.

The Gretel Control Plane includes Gretel's APIs, job scheduling, and workflow management.

Release Schedule and Versioning

Gretel generally releases platform updates every Tuesday. We do sometimes release out-of-band to address critical bug fixes, security updates, or pre-releases for future features and capabilities.

Gretel follows a CalVer versioning schema. The schema is YYYY.MM.N:

  • YYYY: Calendar year.

  • MM: Month of year.

  • N: Monotonically increasing release number for the given month, so 2024.6.1 is the first release in June of 2024.

Gretel Cloud

Gretel automatically upgrades the Gretel Cloud to support enhancements and upgrades to the platform. All users get the same updates at the same time. Gretel uses the CalVer internally to track the changes and release notes are organized by these CalVer numbers to more easily communicate changes that are delivered.

Gretel Hybrid

splits the control and data planes such that:

  • Gretel maintains and runs the control plane in Gretel Cloud. Gretel control plane updates are automatically shipped by Gretel for both Gretel Hybrid and Gretel Cloud.

  • The data plane is customer managed within customer cloud accounts. Depending on your Hybrid setup, you will need to update varying container images. More on this below.

All container image versions for Hybrid are tagged with the same CalVer number on each release. The concrete release notes are organized by version number, these version numbers should be used to update your container images as necessary.

The container images used on Gretel Hybrid can be split into three categories:

  • Management containers. Images are prefixed with gcc-. There are three core management containers that run on the Hybrid cluster. These containers are responsible for managing model jobs and workflows.

  • Workflow container. This container image is named workflow. These containers are used when running Gretel Workflows and handle things such as source and sink actions.

  • Model container. This container image is named model. These are containers that run the actual Gretel models for generating synthetic data.

Gretel's container images have several shared internal libraries. We have consolidated the number of total images to make upgrades easier. We highly recommend upgrading all container images at the same time based on release version numbers. This mirrors how we update Gretel Cloud.

Image Mirrors

If your Hybrid deployment directly uses Gretel's container registry or a the workflow and model container images are automatically updated and pulled for you upon release. These containers are spawned by the management containers during model jobs and workflow runs.

If you need to explicitly and cannot use the latest tag, then you should use the appropriate CalVer version number for the image tag.

Gretel Hybrid
pull through cache
pull images by tag