cosmomyzrailgorynych/justdoit

JUSTDOIT 镜像说明

镜像概述

JUSTDOIT是基于Node.js LTS的容器镜像，旨在简化JAM-stack应用部署流程，支持Kubernetes环境。它能自动监控Git仓库变化，执行构建命令并将产物作为静态站点提供服务，无需复杂配置。

核心功能

1. 支持私有仓库部署密钥，克隆指定仓库；
2. 执行自定义setup（默认npm install）和build（默认npm run build）命令；
3. 在8080端口提供静态HTTP服务；
4. 定时拉取仓库更新，内容变化时自动重建站点；
5. 仅克隆指定分支和有限历史（默认10次提交），节省资源。

使用场景

• 个人/小团队静态博客、文档站点的自动更新部署；
• JAM-stack应用的快速测试与上线；
• 需要定时同步Git仓库内容的静态服务场景。

配置说明

环境变量

Git相关

• GIT_URL（必填）：Git仓库URL，公私有仓库均支持（私有仓库需配合GIT_DEPLOY_KEY）；
• GIT_DEPLOY_KEY：私有仓库部署私钥（需用\n分隔行并在末尾加\n）；
• GIT_DEPTH：拉取的提交历史数量，默认10；
• GIT_PULL_RATE：定时拉取间隔（分钟），默认5；
• GIT_BRANCH：指定克隆分支，默认master。

构建相关

• BUILD_SETUP：克隆后执行的初始化脚本（支持多行，用\n分隔）；
• BUILD_SCRIPT：构建脚本（同BUILD_SETUP）；
• BUILD_TIMEOUT：构建超时时间（分钟）；
• BUILD_AUTOWIPE：构建前是否清空服务目录，默认1（开启）。

服务相关

• SERVE_DIR：静态文件服务目录，默认./dist；
• SERVE_DOTFILES：是否服务隐藏文件，默认1（开启）；
• SERVE_404：404页面路径，默认404.html。

部署示例

拉取镜像（推荐Alpine版本）

sh
docker pull docker.xuanyuan.run/cosmomyzrailgorynych/justdoit:latest-alpine

公共仓库运行示例

sh
docker run -d \
  -p 8080:8080 \
  -e GIT_URL=https://github.com/your-username/your-repo.git \
  -e GIT_BRANCH=main \
  docker.xuanyuan.run/cosmomyzrailgorynych/justdoit:latest-alpine

私有仓库运行示例（需提供部署密钥）

sh
docker run -d \
  -p 8080:8080 \
  -e GIT_URL=git@github.com:your-username/your-private-repo.git \
  -e GIT_DEPLOY_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----\n" \
  docker.xuanyuan.run/cosmomyzrailgorynych/justdoit:latest-alpine

注意事项

• 镜像兼容Docker、CRIO等容器运行时；
• 无官方维护保障，使用前需自行测试；
• 私有仓库密钥需正确格式化，避免换行错误导致认证失败。