Skip to content

Document server-version pinning on group create --version #1067

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
pedrocarlo wants to merge 1 commit into from
Closed

Document server-version pinning on group create --version #1067

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion internal/cmd/group.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ func init() {
groupCmd.AddCommand(unarchiveGroupCmd)
addLocationFlag(groupsCreateCmd, "Create the group primary in the specified location")
addWaitFlag(groupsCreateCmd, "Wait for group to be ready")
flags.AddVersion(groupsCreateCmd, "Version of the group. Valid values: 'latest' or 'vector'")
flags.AddVersion(groupsCreateCmd, "Version of the group. Valid values: 'latest', or a specific turso-server version tag (e.g. 'v0.34.2') to pin the group — and every database in it — to a fleet running exactly that version (restricted to internal Turso users)")
groupCmd.AddCommand(groupsDestroyCmd)
addYesFlag(groupsDestroyCmd, "Confirms the destruction of the group, with all its locations and databases.")
groupCmd.AddCommand(groupShowCmd)
Expand Down
7 changes: 7 additions & 0 deletions internal/flags/version.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@ import (

var versionFlag string

// AddVersion registers --version. Beyond "latest", the API accepts a specific
// turso-server version tag (e.g. "v0.34.2") from internal Turso users: the
// value is stamped as the turso.io/server-image marker on the group's
// provision request, so the group — and every database in it — is placed on a
// db-api fleet running exactly that version (composed from a matching dynamic
// fleet template). Validation is server-side; the CLI passes the value
// through untouched.
func AddVersion(cmd *cobra.Command, desc string) {
cmd.Flags().StringVar(&versionFlag, "version", "", desc)
_ = cmd.RegisterFlagCompletionFunc("version", func(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective) {
Expand Down
Loading