grimbough/code.bioc-mirror-updater

Bioconductor代码仓库浏览工具

镜像概述和主要用途

本仓库详细说明了code.bioconductor.org网站的底层实现，该网站由欧洲分子生物学实验室（EMBL）管理的Kubernetes实例托管。它包含四个Docker容器，分别提供网站的不同功能模块。预构建容器镜像可在https://hub.docker.com/u/grimbough%E8%8E%B7%E5%8F%96%E3%80%82

核心功能和特性

• homepage：静态主页，提供指向其他服务的链接和网站详情
• gitlist：Git浏览器，用于浏览代码仓库内容
• zoekt-webserver：搜索界面，支持代码搜索功能
• mirror-updater：结合R脚本和zoekt索引工具，维护git.bioconductor.org的本地镜像

使用场景和适用范围

适用于需要本地部署Bioconductor代码仓库浏览和搜索功能的开发者、研究人员，支持离线代码查看、版本历史浏览及高效代码搜索。

使用方法和配置说明

本地运行容器

环境变量

定义容器内文件夹挂载路径的环境变量：

• LOCAL_*：主机机器上的目录
• CONTAINER_*：容器内的挂载点，应用程序期望在此处查找文件

bash
LOCAL_REPO_DIR=/tmp/docker/repos  # 主机上存储Git仓库的目录
LOCAL_ZOEKT_IDX_DIR=/tmp/docker/zoekt  # 主机上存储Zoekt索引的目录

## 暂不建议自定义以下变量
CONTAINER_REPO_DIR=/var/git  # 容器内Git仓库的挂载点
CONTAINER_ZOEKT_IDX_DIR=/var/zoekt  # 容器内Zoekt索引的挂载点

初始化或更新Bioconductor包Git仓库

通过mirror-updater容器初始化或更新Bioconductor包Git仓库集合。若${LOCAL_REPO_DIR}为空，将从Bioconductor Git服务器克隆所有仓库；若包含一个或多个目录，仅克隆新包或更新有变更的现有仓库。完成后为受影响的仓库创建Zoekt索引文件。

可传递以下参数：

• --all：若${LOCAL_REPO_DIR}非空，更新所有现有包并克隆缺失的包
• --clean：删除${LOCAL_REPO_DIR}中的所有内容并重新下载
• --npkgs=N：若${LOCAL_REPO_DIR}为空或使用--clean，仅下载清单中的前N个包

运行命令：

bash
docker run -it \
  --env GIT_REPOS_DIR=${CONTAINER_REPO_DIR} \
  --env CONTAINER_ZOEKT_IDX_DIR=${CONTAINER_ZOEKT_IDX_DIR} \
  --mount type=bind,source=${LOCAL_REPO_DIR},target=${CONTAINER_REPO_DIR} \
  --mount type=bind,source=${LOCAL_ZOEKT_IDX_DIR},target=${CONTAINER_ZOEKT_IDX_DIR} \
  grimbough/code.bioc-mirror-updater

启动Gitlist和Zoekt Web服务器容器

bash
# 启动zoekt-webserver（搜索界面），映射主机8888端口到容器8080端口
docker run -p 8888:8080 -d --name zoekt-webserver --rm=true \
  --mount type=bind,source=${LOCAL_REPO_DIR},target=${CONTAINER_REPO_DIR} \
  --mount type=bind,source=${LOCAL_ZOEKT_IDX_DIR},target=${CONTAINER_ZOEKT_IDX_DIR} \
  grimbough/code.bioc-zoekt-webserver

# 启动gitlist-webserver（Git浏览器），映射主机8889端口到容器8080端口
docker run -p 8889:8080 -d --name gitlist-webserver --rm=true \
  --mount type=bind,source=${LOCAL_REPO_DIR},target=${CONTAINER_REPO_DIR} \
  grimbough/code.bioc-gitlist