Graduate
Published 09 July 2026
Graduate turns a data container into a brand-new data image, capturing its current state as a reusable, read-only source that other data containers can be created from.
This is useful when you've made changes inside a data container (e.g. applied a migration, seeded test data, anonymised a data set) and want to reuse that exact state as a starting point for future clones, without going back to the original backup.
How it works
* You graduate a specific revision of a data container.
* The result is a new data image, tagged with whichever tag(s) you specify.
* The new data image behaves exactly like any other data image — it can be used to create new data containers, shared with other users, and tagged/updated like normal.
Using the CLI
rgclone graduate data-container <name> --revision <revision> --name <new-image-name> --tag <tag>
| Flag | Short | Description |
|---|---|---|
| --revision | -r | (Required) The revision of the data container to graduate |
| --name | -n | The name to give the new data image |
| --tag | The tag(s) to add to the new image. Repeat the flag to add multiple tags | |
| --output | -o | Output format: json, yaml, or human (default) |
See also
This documentation contains proprietary information and is protected by copyright law.
Copyright © 2026 Red Gate Software Limited. All rights reserved
