101 lines
3.4 KiB
Go
101 lines
3.4 KiB
Go
package liveshare
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"strconv"
|
|
)
|
|
|
|
// A Session represents the session between a connected Live Share client and server.
|
|
type Session struct {
|
|
ssh *sshSession
|
|
rpc *rpcClient
|
|
}
|
|
|
|
// Close should be called by users to clean up RPC and SSH resources whenever the session
|
|
// is no longer active.
|
|
func (s *Session) Close() error {
|
|
if err := s.rpc.Close(); err != nil {
|
|
s.ssh.Close() // close SSH and ignore error
|
|
return fmt.Errorf("failed to close RPC conn: %w", err)
|
|
}
|
|
|
|
if err := s.ssh.Close(); err != nil {
|
|
return fmt.Errorf("failed to close SSH conn: %w", err)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// Port describes a port exposed by the container.
|
|
type Port struct {
|
|
SourcePort int `json:"sourcePort"`
|
|
DestinationPort int `json:"destinationPort"`
|
|
SessionName string `json:"sessionName"`
|
|
StreamName string `json:"streamName"`
|
|
StreamCondition string `json:"streamCondition"`
|
|
BrowseURL string `json:"browseUrl"`
|
|
IsPublic bool `json:"isPublic"`
|
|
IsTCPServerConnectionEstablished bool `json:"isTCPServerConnectionEstablished"`
|
|
HasTLSHandshakePassed bool `json:"hasTLSHandshakePassed"`
|
|
}
|
|
|
|
// startSharing tells the Live Share host to start sharing the specified port from the container.
|
|
// The sessionName describes the purpose of the remote port or service.
|
|
// It returns an identifier that can be used to open an SSH channel to the remote port.
|
|
func (s *Session) startSharing(ctx context.Context, sessionName string, port int) (channelID, error) {
|
|
args := []interface{}{port, sessionName, fmt.Sprintf("http://localhost:%d", port)}
|
|
var response Port
|
|
if err := s.rpc.do(ctx, "serverSharing.startSharing", args, &response); err != nil {
|
|
return channelID{}, err
|
|
}
|
|
|
|
return channelID{response.StreamName, response.StreamCondition}, nil
|
|
}
|
|
|
|
// GetSharedServers returns a description of each container port
|
|
// shared by a prior call to StartSharing by some client.
|
|
func (s *Session) GetSharedServers(ctx context.Context) ([]*Port, error) {
|
|
var response []*Port
|
|
if err := s.rpc.do(ctx, "serverSharing.getSharedServers", []string{}, &response); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return response, nil
|
|
}
|
|
|
|
// UpdateSharedVisibility controls port permissions and whether it can be accessed publicly
|
|
// via the Browse URL
|
|
func (s *Session) UpdateSharedVisibility(ctx context.Context, port int, public bool) error {
|
|
if err := s.rpc.do(ctx, "serverSharing.updateSharedServerVisibility", []interface{}{port, public}, nil); err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// StartsSSHServer starts an SSH server in the container, installing sshd if necessary,
|
|
// and returns the port on which it listens and the user name clients should provide.
|
|
func (s *Session) StartSSHServer(ctx context.Context) (int, string, error) {
|
|
var response struct {
|
|
Result bool `json:"result"`
|
|
ServerPort string `json:"serverPort"`
|
|
User string `json:"user"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
if err := s.rpc.do(ctx, "ISshServerHostService.startRemoteServer", []string{}, &response); err != nil {
|
|
return 0, "", err
|
|
}
|
|
|
|
if !response.Result {
|
|
return 0, "", fmt.Errorf("failed to start server: %s", response.Message)
|
|
}
|
|
|
|
port, err := strconv.Atoi(response.ServerPort)
|
|
if err != nil {
|
|
return 0, "", fmt.Errorf("failed to parse port: %w", err)
|
|
}
|
|
|
|
return port, response.User, nil
|
|
}
|