
维护课题组环境时,正式项目和升级候选应有独立目录。直接在公用R库更新一个包,可能让还在运行的学生任务与后续重跑使用不同依赖。本篇从已有Git管理、renv锁定且有小型验收脚本的项目开始,建立可比较的升级流程。
先固定当前批准版本
准备已提交的renv.lock、.Rprofile、renv/activate.R、项目设置、分析代码和smoke.R。记录当前R、系统和参考数据库;未提交的工作先由作者整理,不能用切换目录掩盖未保存修改。正式任务继续使用旧目录,升级人员在新的候选目录操作。
| 阶段 | 谁操作 | 通过条件 |
|---|---|---|
| 当前基线 | 项目维护者 | 旧环境和固定小输入能复现 |
| 候选升级 | 指定升级人员 | 单独目录、明确改哪些包 |
| 差异解释 | 分析负责人 | 结构、数值及科学指标逐项说明 |
| 批准使用 | 项目负责人 | 记录新锁文件与适用任务 |
| 保留旧版 | 维护者 | 既有结果仍能追到旧版本 |
用独立worktree建立候选
需要可用Git与项目仓库,以下目录和分支名必须尚未使用。worktree建立独立工作目录,但共享同一仓库管理信息;不要把它理解为独立数据备份。大输入与正式结果按项目权限引用,候选结果写新目录。
set -euo pipefail
test -f renv.lock
test -z "$(git status --porcelain)"
git rev-parse HEAD
test ! -e ../project-env-candidate
git worktree add -b environment-candidate ../project-env-candidate HEAD
cd ../project-env-candidate
先在旧项目会话记录renv::paths$library();worktree创建并进入候选后,激活其renv并运行同一语句,确认实际项目库不同,再执行下面的restore。Git worktree不强制隔离R包库;若RENV_PATHS_LIBRARY等设置指向同一库,先改成独立项目库。共享cache不等于共享library。
set -euo pipefail
# 仍在候选目录,已确认项目库独立
Rscript --vanilla -e "source('renv/activate.R'); renv::restore(prompt=FALSE); source('smoke.R')" \
> restore-smoke.log 2>&1
一次只做事先声明的升级
下面沿用轻量示例,只更新jsonlite,正式项目改为真实指定依赖。升级可能连带依赖,查看锁文件diff后登记,而不是只记录主动输入的一个包名。若升级同时涉及R或Bioconductor发行版,应当另立较大范围试验,不能只改lock中的版本字符串。
source("renv/activate.R")
renv::update("jsonlite", prompt=FALSE)
source("smoke.R")
renv::snapshot(type="all", prompt=FALSE)
capture.output(sessionInfo(), file="candidate-session-info.txt")
renv::status()
set -euo pipefail
git diff -- renv.lock renv/settings.json
git status --short
小输入检查要有真正的判定标准
先检查输出文件、行列、标识和单位,再比数值。确定性计数可要求一致;浮点、随机降维或不同实现需事先写容差、随机种子和科学质量指标,不能遇到差异后才随意放宽。只看图大致一样或函数没有报错,都不足以批准涉及科学结果的升级。
在同一输入、同一参数和参考下分别跑基线与候选,保存命令、日志和预期检查。若涉及对象存储格式,还需验证读旧对象和新会话重开。接口不兼容时先定位变更与受影响脚本,不通过关闭校验或删掉失败样本让smoke变绿。
批准与回退都以项目为单位
未通过的候选保留问题和日志,正式任务继续使用旧目录,不把新包覆盖旧库。通过后由维护者提交锁文件及代码变更,通知成员从同一批准提交恢复各自项目库;不要多人同时写共享library。共享renv缓存可以节约副本,但不应手工修改缓存中的包来“同步版本”。
回退指重新使用旧批准提交、匹配的R和对应包环境,不是仅把分析脚本改回去。保留旧包来源、系统依赖与参考记录;重建包可能依赖归档或镜像的可用性。最后在登记表填受影响项目、批准人、日期、检查范围及未覆盖部分,避免一次小例通过被扩大成所有项目已兼容。
参考资料
需要额外算力时
适用前提:有多人协作或交接需求且需要统一计算环境。如需额外资源,可评估课题组多用户计算环境。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。
咨询本任务的服务器配置
留下手机号,我们会结合本文任务与您沟通服务器配置和报价。 也可联系云生信企业微信客服,说明本文任务。咨询本任务的服务器配置
