
课题组统一R包和生信软件版本,不等于所有项目共用一个可随时升级的包库。先为项目记录R、包、命令行工具、系统库和参考数据库,再分别锁定。本文用一个小型R项目演示renv,并说明Conda工具的同平台清单;它们不能替你锁住全部操作系统和科学参数。
建立能追溯的环境表
从实际正在使用的环境盘点,而不是把教程中的版本号写进表。记录R版本、Bioconductor发行版、关键包来源、操作系统、外部库和参考索引版本。Git安装包需保留提交标识;本地开发包和私有源另留可访问的归档,只有包名不够让接手人重建。
| 组件 | 记录方式 | 覆盖不到什么 |
|---|---|---|
| R与项目R包 | R.version.string、renv.lock | 不会自动安装指定R本身 |
| Bioconductor | 发行版与兼容R记录 | 不能任意跨发行版混装 |
| 命令行工具 | Conda explicit清单或已核对容器digest | 不自动包含所有宿主机设置 |
| 系统依赖 | OS、编译器、libcurl等实际记录 | renv不锁整个操作系统 |
| 参考与参数 | 来源、版本、校验和、命令 | 软件环境相同不等于分析相同 |
在全新小项目中建立renv基线
需要已有兼容R与renv,且包源可用、个人目录可写。新建目录env-demo,在其中保存setup.R。这里安装jsonlite作为轻量接口演示,正式项目换成其真实依赖;不能把这套小例成功当成Seurat或Bioconductor全部依赖已经通过。
stopifnot(!file.exists("renv.lock"))
options(repos=c(CRAN="https://cloud.r-project.org"))
renv::init(bare=TRUE, restart=FALSE)
renv::install("jsonlite")
renv::snapshot(type="all", prompt=FALSE)
writeLines(R.version.string,"R-version.txt")
capture.output(sessionInfo(), file="session-info.txt")
renv::status()
snapshot默认implicit按代码扫描依赖,动态加载或特殊入口可能漏记;此小项目用all记录项目库全部包,避免把“装过”误当“已经被扫描到”。大项目也应选择并说明snapshot策略。保存renv.lock、.Rprofile、renv/activate.R及项目设置,而不是只发一个lock文件后假定会自动激活。
用一段小脚本检验新会话
保存下面为smoke.R;它是环境接口检查,不做科学推断。在项目目录执行Rscript –vanilla -e “source(‘renv/activate.R’); source(‘smoke.R’)”。使用–vanilla不会自动读项目.Rprofile,因此这里显式加载activate.R,不把命令行会话意外落到全局包库。
x <- jsonlite::fromJSON('{"sample":"S1","counts":[1,2,3]}')
stopifnot(identical(x$sample,"S1"), sum(x$counts)==6)
print(list(sample=x$sample,total=sum(x$counts),
jsonlite_version=as.character(packageVersion("jsonlite"))))
print(.libPaths())
接手人在独立工作副本中使用匹配的R,显式加载项目后执行renv::restore(prompt=FALSE),再跑smoke.R与status。恢复需要包源或已准备缓存;网络不可用、旧包归档缺失、编译依赖缺少都可能失败,不能用restore退出前的几行提示当完成证据。
命令行软件另留清单
若项目同时用Conda里的比对工具,在该实际环境下运行下例。explicit清单偏向同平台精确重建;跨平台需求应另用可移植需求文件求解并重新验证,不能把Linux二进制锁直接当作macOS环境。环境变量、外部数据库与挂载路径也要另记。
set -euo pipefail
: "${ENV_PREFIX:?实际项目Conda环境绝对路径}"
test -d "$ENV_PREFIX"
set -C
conda list -p "$ENV_PREFIX" --explicit > conda-linux.explicit.txt
conda list -p "$ENV_PREFIX" > conda-packages.txt
# 同平台在全新路径重建,先核对实际路径与可用包源
# conda create -p /new/project-env --file conda-linux.explicit.txt
验收物是可重建的版本清单、独立副本的运行记录与预期输出。分享前检查配置里是否夹带访问凭据或私人路径,正式升级先走候选环境验证,再更新批准的项目锁文件,不让成员同时修改正在跑任务的环境。
包版本相同仍可能受R版本、编译选项、系统数学库和外部程序影响。重要结果要保留对应输入与预期检查,不能把锁文件存在当作数值或生物学结论已经复现;新机器恢复后仍需跑项目自身的代表性验收。
参考资料
需要额外算力时
适用前提:有多人协作或交接需求且需要统一计算环境。如需额外资源,可评估课题组多用户计算环境。咨询时说明软件版本、任务规模和使用期限,配置与支持范围另行确认。
咨询本任务的服务器配置
留下手机号,我们会结合本文任务与您沟通服务器配置和报价。 也可联系云生信企业微信客服,说明本文任务。咨询本任务的服务器配置
