package libraryhandoff import ( "errors" "strconv" "strings" "time" ) // 环境变量名集中在这里:API(决定要不要先做搬运)与 capture worker(真正执行搬运) // 必须看同一组名字,写两遍迟早分叉成"一边以为接线了、另一边没接线"。 const ( EnvSSHConfig = "LIBRARY_HANDOFF_SSH_CONFIG" EnvTarget = "LIBRARY_HANDOFF_TARGET" EnvExecutor = "LIBRARY_HANDOFF_EXECUTOR" EnvBundleDir = "LIBRARY_HANDOFF_BUNDLE_DIR" EnvRemoteArchive = "LIBRARY_HANDOFF_REMOTE_ARCHIVE" EnvStagingDir = "LIBRARY_HANDOFF_STAGING_DIR" EnvLocalArchive = "LIBRARY_HANDOFF_LOCAL_ARCHIVE" EnvMaxBytes = "LIBRARY_HANDOFF_MAX_BYTES" EnvTimeout = "LIBRARY_HANDOFF_TIMEOUT" EnvTransport = "LIBRARY_HANDOFF_TRANSPORT" EnvLocalRoot = "LIBRARY_HANDOFF_LOCAL_ROOT" // EnvPullInterval 控制"云端版本回传本机"的扫描间隔(capture 角色)。 EnvPullInterval = "LIBRARY_HANDOFF_PULL_INTERVAL" ) // FromEnv 解析搬运配置。 // // 返回 configured=false 只表示"这项能力没接线",不是错误:未接线时 API 保持旧行为 // (直接投递 library.sync/restore),本机目标部署完全不受影响。 // // 但一旦任何一项接线字段出现,就必须**全部齐备**,否则报错——半接线是最坏的情况: // API 以为会搬运,worker 却搬不动,发布作业会以"快照不在执行器"失败。 func FromEnv(get func(string) string) (Config, bool, error) { if get == nil { return Config{}, false, errors.New("缺少配置读取入口") } value := func(key string) string { return strings.TrimSpace(get(key)) } config := Config{ SSHConfig: value(EnvSSHConfig), SSHTarget: value(EnvTarget), ExecutorContainer: value(EnvExecutor), BundleDir: value(EnvBundleDir), RemoteArchive: value(EnvRemoteArchive), StagingDir: value(EnvStagingDir), LocalArchive: value(EnvLocalArchive), Transport: value(EnvTransport), LocalRoot: value(EnvLocalRoot), OpTimeout: 10 * time.Minute, PullInterval: 5 * time.Minute, } if config.Transport == "" { config.Transport = TransportSSH } if raw := value(EnvMaxBytes); raw != "" { parsed, err := strconv.ParseInt(raw, 10, 64) if err != nil || parsed <= 0 { return Config{}, false, errors.New("LIBRARY_HANDOFF_MAX_BYTES 必须是正整数") } config.MaxBundleBytes = parsed } if raw := value(EnvPullInterval); raw != "" { parsed, err := time.ParseDuration(raw) if err != nil || parsed <= 0 { return Config{}, false, errors.New("LIBRARY_HANDOFF_PULL_INTERVAL 必须是正的时间长度(如 5m)") } config.PullInterval = parsed } if raw := value(EnvTimeout); raw != "" { parsed, err := time.ParseDuration(raw) if err != nil || parsed <= 0 { return Config{}, false, errors.New("LIBRARY_HANDOFF_TIMEOUT 必须是正的时间长度(如 10m)") } config.OpTimeout = parsed } configuredFields := 0 for _, item := range []string{EnvSSHConfig, EnvTarget, EnvExecutor, EnvBundleDir, EnvRemoteArchive, EnvStagingDir} { if value(item) != "" { configuredFields++ } } if configuredFields == 0 && value(EnvTransport) != TransportLocal { return Config{}, false, nil } if config.Transport == TransportLocal { if value(EnvLocalRoot) == "" { return Config{}, false, errors.New("LIBRARY_HANDOFF_TRANSPORT=local 必须同时给出 LIBRARY_HANDOFF_LOCAL_ROOT(仅限隔离 fixture)") } if value(EnvSSHConfig) != "" || value(EnvTarget) != "" { return Config{}, false, errors.New("local 通道不允许同时配置 SSH 目标:fixture 不能冒充云端通道") } if config.LocalArchive == "" { config.LocalArchive = value("LIBRARY_ARCHIVE_ROOT") } if config.ExecutorContainer == "" { // fixture 不跑容器:给一个固定名字只为让配置校验完整,不会被执行。 config.ExecutorContainer = "fixture-executor" } } if err := config.validate(); err != nil { return Config{}, false, err } return config, true, nil }