Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
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 go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ require (
github.com/mattn/go-shellwords v1.0.12
github.com/mitchellh/go-homedir v1.1.0
github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c
github.com/planetscale/planetscale-go v0.168.1-0.20260609224250-8001bcf5eba5
github.com/planetscale/planetscale-go v0.168.1-0.20260609224250-ef13ea3898a3
github.com/planetscale/psdb v0.0.0-20250717190954-65c6661ab6e4
github.com/planetscale/psdbproxy v0.0.0-20250728082226-3f4ea3a74ec7
github.com/spf13/cobra v1.10.2
Expand Down
4 changes: 2 additions & 2 deletions go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -176,8 +176,8 @@ github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c/go.mod h1:7rwL4CYBLnjL
github.com/pkg/diff v0.0.0-20210226163009-20ebb0f2a09e/go.mod h1:pJLUxLENpZxwdsKMEsNbx1VGcRFpLqf3715MtcvvzbA=
github.com/planetscale/noglog v0.2.1-0.20210421230640-bea75fcd2e8e h1:MZ8D+Z3m2vvqGZLvoQfpaGg/j1fNDr4j03s3PRz4rVY=
github.com/planetscale/noglog v0.2.1-0.20210421230640-bea75fcd2e8e/go.mod h1:hwAsSPQdvPa3WcfKfzTXxtEq/HlqwLjQasfO6QbGo4Q=
github.com/planetscale/planetscale-go v0.168.1-0.20260609224250-8001bcf5eba5 h1:z+ao9YVEVP9GHpyB1Gmw48dt2+RQsS+BAOTE1QUigrw=
github.com/planetscale/planetscale-go v0.168.1-0.20260609224250-8001bcf5eba5/go.mod h1:paQCI5SgquuoewvMQM7R+r1XJO868bdP6/ihGidYRM0=
github.com/planetscale/planetscale-go v0.168.1-0.20260609224250-ef13ea3898a3 h1:AKV0UMYT27rSLTeQqHwkoXAzkV7pDflg1/2weI1gBbA=
github.com/planetscale/planetscale-go v0.168.1-0.20260609224250-ef13ea3898a3/go.mod h1:paQCI5SgquuoewvMQM7R+r1XJO868bdP6/ihGidYRM0=
github.com/planetscale/psdb v0.0.0-20250717190954-65c6661ab6e4 h1:Xv5pj20Rhfty1Tv0OVcidg4ez4PvGrpKvb6rvUwQgDs=
github.com/planetscale/psdb v0.0.0-20250717190954-65c6661ab6e4/go.mod h1:M52h5IWxAcbdQ1hSZrLAGQC4ZXslxEsK/Wh9nu3wdWs=
github.com/planetscale/psdbproxy v0.0.0-20250728082226-3f4ea3a74ec7 h1:aRd6vdE1fyuSI4RVj7oCr8lFmgqXvpnPUmN85VbZCp8=
Expand Down
96 changes: 96 additions & 0 deletions internal/cmd/branch/vtctld/set_shard_tablet_control.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
package vtctld

import (
"fmt"

"github.com/planetscale/cli/internal/cmdutil"
ps "github.com/planetscale/planetscale-go/planetscale"
"github.com/spf13/cobra"
)

// SetShardTabletControlCmd updates shard tablet controls via vtctld.
func SetShardTabletControlCmd(ch *cmdutil.Helper) *cobra.Command {
var flags struct {
keyspace string
shard string
tabletType string
cells []string
deniedTables []string
remove bool
disableQueryService bool
}

cmd := &cobra.Command{
Use: "set-shard-tablet-control <database> <branch>",
Short: "Update shard tablet controls for a branch",
Long: "Update live shard tablet controls from the cluster via vtctld, " +
"including denied tables used during MoveTables cleanup.",
Args: cmdutil.RequiredArgs("database", "branch"),
RunE: func(cmd *cobra.Command, args []string) error {
ctx := cmd.Context()
database, branch := args[0], args[1]

if flags.keyspace == "" {
return fmt.Errorf("keyspace is required")
}
if flags.shard == "" {
return fmt.Errorf("shard is required")
}
if flags.tabletType == "" {
return fmt.Errorf("tablet-type is required")
}

removeSet := cmd.Flags().Changed("remove")
disableQueryServiceSet := cmd.Flags().Changed("disable-query-service")

client, err := ch.Client()
if err != nil {
return err

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing mutation flag validation

Medium Severity

The command reads remove and disable-query-service via Flags().Changed but never requires at least one of --remove, --denied-tables, or --disable-query-service before calling the API. The PR describes that check and manual “CLI validation,” yet no matching fmt.Errorf exists in this repo (unlike deployrequest edit).

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 27c1ed7. Configure here.

}

end := ch.Printer.PrintProgress(
fmt.Sprintf("Updating tablet controls for %s/%s on %s…",
flags.keyspace, flags.shard,
progressTarget(ch.Config.Organization, database, branch)))
defer end()

req := &ps.VtctldSetShardTabletControlRequest{
Organization: ch.Config.Organization,
Database: database,
Branch: branch,
Keyspace: flags.keyspace,
Shard: flags.shard,
TabletType: flags.tabletType,
Cells: flags.cells,
DeniedTables: flags.deniedTables,
}
if removeSet {
req.Remove = &flags.remove
}
if disableQueryServiceSet {
req.DisableQueryService = &flags.disableQueryService
}
Comment thread
cursor[bot] marked this conversation as resolved.

data, err := client.Vtctld.SetShardTabletControl(ctx, req)
if err != nil {
return cmdutil.HandleError(err)
}

end()
return ch.Printer.PrettyPrintJSON(data)
},
}

cmd.Flags().StringVar(&flags.keyspace, "keyspace", "", "Keyspace name")
cmd.Flags().StringVar(&flags.shard, "shard", "", "Shard name (e.g. \"-\" for unsharded)")
cmd.Flags().StringVar(&flags.tabletType, "tablet-type", "", "Tablet type (e.g. rdonly, replica, primary)")
cmd.Flags().StringSliceVar(&flags.cells, "cells", nil, "Cells to update (comma-separated)")
cmd.Flags().StringSliceVar(&flags.deniedTables, "denied-tables", nil, "Tables to add to or remove from the denylist (comma-separated)")
cmd.Flags().BoolVar(&flags.remove, "remove", false, "Remove tablet controls (or specific denied tables when combined with --denied-tables)")
cmd.Flags().BoolVar(&flags.disableQueryService, "disable-query-service", false, "Disable query service on the provided tablets")
cmd.MarkFlagRequired("keyspace")
cmd.MarkFlagRequired("shard")
cmd.MarkFlagRequired("tablet-type")

return cmd
}
66 changes: 66 additions & 0 deletions internal/cmd/branch/vtctld/set_shard_tablet_control_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
package vtctld

import (
"bytes"
"context"
"encoding/json"
"testing"

qt "github.com/frankban/quicktest"

"github.com/planetscale/cli/internal/cmdutil"
"github.com/planetscale/cli/internal/config"
"github.com/planetscale/cli/internal/mock"
"github.com/planetscale/cli/internal/printer"
ps "github.com/planetscale/planetscale-go/planetscale"
)

func TestSetShardTabletControl(t *testing.T) {
c := qt.New(t)

org := "my-org"
db := "my-db"
branch := "my-branch"

svc := &mock.VtctldService{
SetShardTabletControlFn: func(ctx context.Context, req *ps.VtctldSetShardTabletControlRequest) (json.RawMessage, error) {
c.Assert(req.Organization, qt.Equals, org)
c.Assert(req.Database, qt.Equals, db)
c.Assert(req.Branch, qt.Equals, branch)
c.Assert(req.Keyspace, qt.Equals, "commerce")
c.Assert(req.Shard, qt.Equals, "-")
c.Assert(req.TabletType, qt.Equals, "rdonly")
c.Assert(req.DeniedTables, qt.DeepEquals, []string{"customers"})
c.Assert(req.Remove, qt.Not(qt.IsNil))
c.Assert(*req.Remove, qt.Equals, true)
return json.RawMessage(`{}`), nil
},
}

var buf bytes.Buffer
format := printer.JSON
p := printer.NewPrinter(&format)
p.SetResourceOutput(&buf)

ch := &cmdutil.Helper{
Printer: p,
Config: &config.Config{Organization: org},
Client: func() (*ps.Client, error) {
return &ps.Client{
Vtctld: svc,
}, nil
},
}

cmd := SetShardTabletControlCmd(ch)
cmd.SetArgs([]string{db, branch})
cmd.Flags().Set("keyspace", "commerce")
cmd.Flags().Set("shard", "-")
cmd.Flags().Set("tablet-type", "rdonly")
cmd.Flags().Set("denied-tables", "customers")
cmd.Flags().Set("remove", "true")

err := cmd.Execute()
c.Assert(err, qt.IsNil)
c.Assert(svc.SetShardTabletControlFnInvoked, qt.IsTrue)
}
67 changes: 67 additions & 0 deletions internal/cmd/branch/vtctld/shard.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
package vtctld

import (
"fmt"

"github.com/planetscale/cli/internal/cmdutil"
ps "github.com/planetscale/planetscale-go/planetscale"
"github.com/spf13/cobra"
)

// GetShardCmd reads a shard record from the cluster via vtctld.
func GetShardCmd(ch *cmdutil.Helper) *cobra.Command {
var flags struct {
keyspace string
shard string
}

cmd := &cobra.Command{
Use: "get-shard <database> <branch>",
Short: "Get a shard record for a branch",
Long: "Get a live shard record from the cluster via vtctld, including tablet controls and denied tables.",
Args: cmdutil.RequiredArgs("database", "branch"),
RunE: func(cmd *cobra.Command, args []string) error {
ctx := cmd.Context()
database, branch := args[0], args[1]

if flags.keyspace == "" {
return fmt.Errorf("keyspace is required")
}
if flags.shard == "" {
return fmt.Errorf("shard is required")
}

client, err := ch.Client()
if err != nil {
return err
}

end := ch.Printer.PrintProgress(
fmt.Sprintf("Fetching shard %s/%s for %s\u2026",
flags.keyspace, flags.shard,
progressTarget(ch.Config.Organization, database, branch)))
defer end()

data, err := client.Vtctld.GetShard(ctx, &ps.VtctldGetShardRequest{
Organization: ch.Config.Organization,
Database: database,
Branch: branch,
Keyspace: flags.keyspace,
Shard: flags.shard,
})
if err != nil {
return cmdutil.HandleError(err)
}

end()
return ch.Printer.PrettyPrintJSON(data)
},
}

cmd.Flags().StringVar(&flags.keyspace, "keyspace", "", "Keyspace name")
cmd.Flags().StringVar(&flags.shard, "shard", "", "Shard name (e.g. \"-\" for unsharded)")
cmd.MarkFlagRequired("keyspace")
cmd.MarkFlagRequired("shard")

return cmd
}
56 changes: 56 additions & 0 deletions internal/cmd/branch/vtctld/shard_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
package vtctld

import (
"bytes"
"context"
"encoding/json"
"testing"

qt "github.com/frankban/quicktest"

"github.com/planetscale/cli/internal/cmdutil"
"github.com/planetscale/cli/internal/config"
"github.com/planetscale/cli/internal/mock"
"github.com/planetscale/cli/internal/printer"
ps "github.com/planetscale/planetscale-go/planetscale"
)

func TestGetShard(t *testing.T) {
c := qt.New(t)

org := "my-org"
db := "my-db"
branch := "my-branch"

svc := &mock.VtctldService{
GetShardFn: func(ctx context.Context, req *ps.VtctldGetShardRequest) (json.RawMessage, error) {
c.Assert(req.Organization, qt.Equals, org)
c.Assert(req.Database, qt.Equals, db)
c.Assert(req.Branch, qt.Equals, branch)
c.Assert(req.Keyspace, qt.Equals, "commerce")
c.Assert(req.Shard, qt.Equals, "-")
return json.RawMessage(`{"keyspace":"commerce","name":"-"}`), nil
},
}

var buf bytes.Buffer
format := printer.JSON
p := printer.NewPrinter(&format)
p.SetResourceOutput(&buf)

ch := &cmdutil.Helper{
Printer: p,
Config: &config.Config{Organization: org},
Client: func() (*ps.Client, error) {
return &ps.Client{
Vtctld: svc,
}, nil
},
}

cmd := GetShardCmd(ch)
cmd.SetArgs([]string{db, branch, "--keyspace", "commerce", "--shard", "-"})
err := cmd.Execute()
c.Assert(err, qt.IsNil)
c.Assert(svc.GetShardFnInvoked, qt.IsTrue)
}
2 changes: 2 additions & 0 deletions internal/cmd/branch/vtctld/vtctld.go
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ func VtctldCmd(ch *cmdutil.Helper) *cobra.Command {
cmd.AddCommand(ListWorkflowsCmd(ch))
cmd.AddCommand(ListKeyspacesCmd(ch))
cmd.AddCommand(GetRoutingRulesCmd(ch))
cmd.AddCommand(GetShardCmd(ch))
cmd.AddCommand(SetShardTabletControlCmd(ch))
cmd.AddCommand(ListTabletsCmd(ch))
cmd.AddCommand(StartWorkflowCmd(ch))
cmd.AddCommand(StopWorkflowCmd(ch))
Expand Down
16 changes: 16 additions & 0 deletions internal/mock/vtctld_general.go
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,12 @@ type VtctldService struct {
GetRoutingRulesFn func(context.Context, *ps.VtctldGetRoutingRulesRequest) (json.RawMessage, error)
GetRoutingRulesFnInvoked bool

GetShardFn func(context.Context, *ps.VtctldGetShardRequest) (json.RawMessage, error)
GetShardFnInvoked bool

SetShardTabletControlFn func(context.Context, *ps.VtctldSetShardTabletControlRequest) (json.RawMessage, error)
SetShardTabletControlFnInvoked bool

ListTabletsFn func(context.Context, *ps.ListBranchTabletsRequest) ([]*ps.TabletGroup, error)
ListTabletsFnInvoked bool

Expand Down Expand Up @@ -54,6 +60,16 @@ func (s *VtctldService) GetRoutingRules(ctx context.Context, req *ps.VtctldGetRo
return s.GetRoutingRulesFn(ctx, req)
}

func (s *VtctldService) GetShard(ctx context.Context, req *ps.VtctldGetShardRequest) (json.RawMessage, error) {
s.GetShardFnInvoked = true
return s.GetShardFn(ctx, req)
}

func (s *VtctldService) SetShardTabletControl(ctx context.Context, req *ps.VtctldSetShardTabletControlRequest) (json.RawMessage, error) {
s.SetShardTabletControlFnInvoked = true
return s.SetShardTabletControlFn(ctx, req)
}

func (s *VtctldService) ListTablets(ctx context.Context, req *ps.ListBranchTabletsRequest) ([]*ps.TabletGroup, error) {
s.ListTabletsFnInvoked = true
return s.ListTabletsFn(ctx, req)
Expand Down