mirror of
https://github.com/gravitational/teleport.git
synced 2026-11-01 21:52:02 +08:00
Rafał Cieślak
7474228529
* Add RunDiagnostics RPC * Add button for running diagnostics * Return network stack info from runPlatformUserProcess This will allow teleterm's VNet service to read the interface name after VNet is started. * Add route conflict diag check * Run route conflict diag check from teleterm's VNet service * Add hidden diag flag to tsh vnet * Inline CheckAndSetDefaults of RouteConflictConfig * Add comment for RunDiagnostics RPC * Reduce indentation in vnetCommand.run by returning early * Add godocs * Depend on the default split function * Log and skip invalid route messages * Keep exported APIs in platform-independent file * Make NetworkStackInfo platform-independent * Fix Go and JS linters * Adjust title for disabled button * Adjust check for interface name in teleterm's service * Use teleport.Component for logger name * Add godoc for DarwinRouting * Use `unstable.` instead of `feature.` as app config prop prefix Users are less likely to enable something called `unstable` than `feature`.
65 lines
2.4 KiB
Go
65 lines
2.4 KiB
Go
// Teleport
|
|
// Copyright (C) 2025 Gravitational, Inc.
|
|
//
|
|
// This program is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Affero General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Affero General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Affero General Public License
|
|
// along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
package vnet
|
|
|
|
import (
|
|
"context"
|
|
"os"
|
|
|
|
"github.com/gravitational/trace"
|
|
|
|
"github.com/gravitational/teleport/api/profile"
|
|
"github.com/gravitational/teleport/api/types"
|
|
)
|
|
|
|
// UserProcessConfig provides the necessary configuration to run VNet.
|
|
type UserProcessConfig struct {
|
|
// ClientApplication is a required field providing an interface implementation for
|
|
// [ClientApplication].
|
|
ClientApplication ClientApplication
|
|
// HomePath is the tsh home used for Teleport clients created by VNet. Resolved using the same
|
|
// rules as HomeDir in tsh.
|
|
HomePath string
|
|
}
|
|
|
|
func (c *UserProcessConfig) checkAndSetDefaults() error {
|
|
if c.ClientApplication == nil {
|
|
return trace.BadParameter("missing ClientApplication")
|
|
}
|
|
if c.HomePath == "" {
|
|
c.HomePath = profile.FullProfilePath(os.Getenv(types.HomeEnvVar))
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// RunUserProcess is called by all VNet client applications (tsh, Connect) to
|
|
// start and run all VNet tasks. It returns a [ProcessManager] which controls
|
|
// the lifecycle of all tasks and background processes.
|
|
//
|
|
// ctx is used for setup steps that happen before RunUserProcess passes control
|
|
// to the process manager. Canceling ctx after RunUserProcess returns will _not_
|
|
// cancel the background tasks. If [RunUserProcess] returns without error, the
|
|
// caller is expected to call Close on the process manager to clean up any
|
|
// resources, terminate all processes, and remove any OS configuration used for
|
|
// actively running VNet.
|
|
func RunUserProcess(ctx context.Context, cfg *UserProcessConfig) (*ProcessManager, NetworkStackInfo, error) {
|
|
if err := cfg.checkAndSetDefaults(); err != nil {
|
|
return nil, NetworkStackInfo{}, trace.Wrap(err)
|
|
}
|
|
return runPlatformUserProcess(ctx, cfg)
|
|
}
|