📚 课程目录第1章课程介绍与环境准备

第一章：课程介绍与环境准备

各位好，欢迎来到《生物信息学Pipeline版本锁定实战》。

我是这门课的老周。干了快十年生信Pipeline开发，踩过的坑比跑过的样本还多。今天咱们要聊的，说白了就是一件事——怎么让你的Pipeline不崩、不爽约、不坑队友。

1.1 为什么我们非要聊“版本锁定”？

先问你个问题：你写过一个Pipeline，去年跑得好好的，今年换了个服务器，一执行就报错？

我遇到过。有一次一个RNA-seq定量流程，因为conda环境里悄悄升级了kallisto，结果索引格式变了。整个项目组等了两天，最后发现是版本不兼容。

你想想看，这在生产环境里多要命。

生物信息学Pipeline的依赖关系极为复杂。一个流程里可能有几十个工具，每个工具又有自己的库依赖。一旦某个包自动升级，可能整套流程就废了。版本锁定，就是把这些工具版本“焊死”在已知可工作的状态上。

  核心观点：版本锁定不是过度谨慎，而是生产环境Pipeline的底线。

1.2 版本锁定的三大武器

实战中，我们主要靠三样东西来锁定版本。我习惯称它们为“三件套”——Miniconda、Git、Docker。它们各有分工，缺一不可。

工具	锁定对象	作用层级
Miniconda	生物信息软件及Python/R包版本	软件包环境
Git	Pipeline代码、配置文件、环境定义文件	代码版本
Docker	整个操作系统+软件栈	系统级环境

这三者不是互斥的。我个人的最佳实践是：用Miniconda管理工具本身，用Git控制脚本和配置，用Docker打包整套运行时环境。这样无论到哪个平台，都能一键复现。

1.3 搭建实验环境

嗯，理论先聊这么多。咱们得先把家伙事儿准备好。下面我按步骤走一遍，你跟着做就行。

1.3.1 安装Miniconda

Miniconda是Conda的轻量版。我推荐用它而不是Anaconda，因为它只带核心功能，剩下的包你自己装，更清爽。

下载并安装（以Linux为例）：

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh

安装完成后，记得执行一下：

source ~/.bashrc

验证一下是否成功：

conda --version

你如果看到版本号，比如 conda 23.10.0，那就对了。

小技巧：我个人习惯把conda配置成“不自动激活base环境”。这样每次进终端，不会因为基环境变化影响其他工作。命令如下：

conda config --set auto_activate_base false

1.3.2 安装Git

Git在生信Pipeline开发里不仅仅是代码版本管理，它也是环境定义文件的载体。比如你的environment.yml、Dockerfile，都要靠Git追踪。

安装：

sudo apt-get install git  # Debian/Ubuntu
或者
sudo yum install git      # CentOS/RHEL

配置你的用户名和邮箱（这个很重要，不然后面commit会报错）：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

曾经踩过的坑：我曾经在一台新服务器上忘了配git user.email，结果提交的代码在日志里显示的是unknown。后来查项目溯源时浪费了大半天。所以千万别省这一步。

1.3.3 安装Docker

Docker是版本锁定的终极武器。它把整个运行环境——从操作系统到每个依赖的库——都打包成一个镜像。你发给别人，别人直接就能跑，保证一模一样。

安装Docker Engine（Ubuntu为例）：

sudo apt-get update
sudo apt-get install docker.io

启动并设置开机自启：

sudo systemctl start docker
sudo systemctl enable docker

验证：

sudo docker run hello-world

如果看到消息提示“Hello from Docker!”，说明安装成功。

避坑指南：为了避免每次执行docker命令都要加sudo，可以把当前用户加入docker组：

sudo usermod -aG docker $USER
newgrp docker

然后退出重新登录。这样以后直接敲 docker 就行。

1.4 环境验证清单

到了这一步，我们检查一下环境是不是都就绪了。下面这个清单，你跟着过一遍：

Miniconda：终端输入 conda --version，正常显示版本号。
Git：输入 git --version，显示类似 git version 2.34.1。
Docker：输入 docker --version，显示类似 Docker version 24.0.5。
Git配置：输入 git config --global --list，能看到你的user.name和user.email。

全部通过的话，恭喜你，环境基本ready了。

1.5 第一个Miniconda环境

咱们来创建第一个实验环境。这个环境后续课程会频繁用到。

conda create -n bio-lock-env python=3.9
conda activate bio-lock-env
conda install -c bioconda fastqc=0.12.1
conda install -c bioconda multiqc=1.21
conda install -c bioconda cutadapt=4.4

你看到这里，我刻意指定了fastqc、multiqc、cutadapt的版本号。这就是版本锁定的雏形。

检查一下是不是锁定住了：

conda list | grep -E "fastqc|multiqc|cutadapt"

看到版本号和刚刚指定的一致，就说明环境锁住了。

  核心要点：版本锁定的第一步，就是从 conda install 里明确带上版本号开始。不要偷懒省略，不然将来吃苦的是你自己。

好，第一节课的实战内容就到这里。你只需要把Miniconda、Git、Docker装好，再建一个带版本锁定的实验环境，就够了。后面的课程，咱们会一个个深入这些工具的用法，把这些“锁”打得更加结实。