proxymgr

type Proxy struct {
	metav1.TypeMeta `json:",inline"`
	// 对象元信息
	metav1.ObjectMeta `json:"metadata,omitempty"`
	// 代理状态
	Status ProxyStatus `json:"status,omitempty"`
}

type ProxyList struct {
	metav1.TypeMeta `json:",inline"`
	// 对象元信息
	metav1.ListMeta `json:"metadata,omitempty"`
	// 代理信息的列表
	Items []Proxy `json:"items"`
}

type ProxyManager interface {
	// List 列出所有正在运行的代理
	List(ctx context.Context) (*ProxyList, error)
	// Get 获取指定代理信息
	Get(ctx context.Context, name string) (*Proxy, error)
	// GetForConfig 获取使用指定客户端配置的代理
	GetForConfig(ctx context.Context, config *rest.Config) (*Proxy, error)
	// NewForConfig 使用指定客户端配置创建一个代理
	NewForConfig(ctx context.Context, config *rest.Config) (*Proxy, error)

	// LockProxy 当前进程认领并锁定客户端配置对应的代理（避免其它进程基于此客户端配置启动代理）
	LockProxy(ctx context.Context, config *rest.Config) (*Proxy, error)
	// UnlockProxy 解锁当前进程认领的客户端配置对应的代理
	UnlockProxy(ctx context.Context, proxy *Proxy) error
	// SetProxy 设置客户端配置对应的代理信息
	// NOTE: 仅能设置当前进程提供的代理服务信息，需要先 LockConfig
	SetProxy(ctx context.Context, proxy *Proxy) error
	// KillProxy 停止指定代理服务
	KillProxy(ctx context.Context, proxy *Proxy, wait, force bool) error
}

type ProxyState string

type ProxyStatus struct {
	// 状态
	State ProxyState `json:"state,omitempty"`
	// 处于当前状态的原因，可枚举
	Reason string `json:"reason,omitempty"`
	// 关于当前状态的人类可读的描述
	Message string `json:"message,omitempty"`
	// 代理服务进程 ID
	PID int `json:"pid,omitempty"`
	// 代理服务监听端口
	Port int `json:"port,omitempty"`
	// 代理服务数据根目录
	DataRoot string `json:"dataRoot,omitempty"`
	// 运行代理的客户端配置签名
	ClientConfigSignature string `json:"clientConfigSignature,omitempty"`
	// contains filtered or unexported fields
}