local cli: support additional ssh arguments (#19046)

* local cli: support additional ssh arguments

* address

* 1

* add example

Author: mustard-mh

components/local-app/cmd/workspace-ssh.go

@@ -15,7 +15,17 @@ var dryRun bool
 var workspaceSSHCmd = &cobra.Command{
 	Use:   "ssh <workspace-id>",
 	Short: "Connects to a workspace via SSH",
-	Args:  cobra.ExactArgs(1),
+	Args:  cobra.MinimumNArgs(1),
+	Example: `  # connect to workspace with current terminal session
+  $ gitpod workspace ssh <workspace-id>
+
+  # Execute with ssh command
+  $ gitpod workspace ssh <workspace-id> -- ls -la
+  $ gitpod ws ssh <workspace-id> -- -t watch date
+
+  # Get all SSH features with --dry-run
+  $ $(gitpod workspace ssh <workspace-id> --dry-run) -- ls -la
+  $ $(gitpod workspace ssh <workspace-id> --dry-run) -t watch date`,
 	RunE: func(cmd *cobra.Command, args []string) error {
 		cmd.SilenceUsage = true
 
@@ -26,7 +36,14 @@ var workspaceSSHCmd = &cobra.Command{
 			return err
 		}
 
-		return helper.SSHConnectToWorkspace(cmd.Context(), gitpod, workspaceID, dryRun)
+		dashDashIndex := cmd.ArgsLenAtDash()
+
+		sshArgs := []string{}
+		if dashDashIndex != -1 {
+			sshArgs = args[dashDashIndex:]
+		}
+
+		return helper.SSHConnectToWorkspace(cmd.Context(), gitpod, workspaceID, dryRun, sshArgs...)
 	},
 }
 

components/local-app/go.mod

@@ -88,7 +88,7 @@ require (
 	github.com/xrash/smetrics v0.0.0-20201216005158-039620a65673 // indirect
 	golang.org/x/exp v0.0.0-20231006140011-7918f672742d // indirect
 	golang.org/x/net v0.17.0 // indirect
-	golang.org/x/sys v0.13.0
+	golang.org/x/sys v0.13.0 // indirect
 	golang.org/x/text v0.13.0 // indirect
 	google.golang.org/appengine v1.6.7 // indirect
 	google.golang.org/genproto v0.0.0-20230913181813-007df8e322eb // indirect

components/local-app/pkg/helper/workspace.go

@@ -93,7 +93,7 @@ func OpenWorkspaceInPreferredEditor(ctx context.Context, clnt *client.Gitpod, wo
 }
 
 // SSHConnectToWorkspace connects to the workspace via SSH
-func SSHConnectToWorkspace(ctx context.Context, clnt *client.Gitpod, workspaceID string, runDry bool) error {
+func SSHConnectToWorkspace(ctx context.Context, clnt *client.Gitpod, workspaceID string, runDry bool, sshArgs ...string) error {
 	workspace, err := clnt.Workspaces.GetWorkspace(ctx, connect.NewRequest(&v1.GetWorkspaceRequest{WorkspaceId: workspaceID}))
 	if err != nil {
 		return err
@@ -113,13 +113,17 @@ func SSHConnectToWorkspace(ctx context.Context, clnt *client.Gitpod, workspaceID
 	ownerToken := token.Msg.Token
 
 	host := WorkspaceSSHHost(wsInfo)
+
+	command := exec.Command("ssh", fmt.Sprintf("%s#%s@%s", wsInfo.WorkspaceId, ownerToken, host), "-o", "StrictHostKeyChecking=no")
+	if len(sshArgs) > 0 {
+		slog.Debug("With additional SSH args and command", "with", sshArgs)
+		command.Args = append(command.Args, sshArgs...)
+	}
 	if runDry {
-		fmt.Println("ssh", fmt.Sprintf("%s#%s@%s", wsInfo.WorkspaceId, ownerToken, host), "-o", "StrictHostKeyChecking=no")
+		fmt.Println(strings.Join(command.Args, " "))
 		return nil
 	}
-
-	slog.Debug("Connecting to" + wsInfo.Description)
-	command := exec.Command("ssh", fmt.Sprintf("%s#%s@%s", wsInfo.WorkspaceId, ownerToken, host), "-o", "StrictHostKeyChecking=no")
+	slog.Debug("Connecting to", "context", wsInfo.Description)
 	command.Stdin = os.Stdin
 	command.Stdout = os.Stdout
 	command.Stderr = os.Stderr