Dev Images CLI

Docker 镜像构建与发布工具。

安装

pnpm install

使用方式

dev-images <command> [options]

命令

| 命令 | 说明 | 镜像标签格式 | |------|------|-------------| | release | 正式发布 | {name}:{version}, {name}:latest | | test | 测试发布 | {name}:test-{date}, {name}:latest-test | | dev | 开发版本 | {name}:dev-{date}, {name}:latest-dev |

参数

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | --cache | boolean | false | 是否使用 Docker 缓存。false 时使用 --no-cache 构建 | | --push | boolean | true | 构建后是否推送到镜像仓库 | | --dockerBuildkit | boolean | true | 是否启用 Docker BuildKit (DOCKER_BUILDKIT=1) | | --platform | linux/amd64 | linux/arm64 | linux/arm64（release/test）/ linux/amd64（dev） | 构建目标平台 | | --dockerFileName | Dockerfile | Dockerfile.dev | Dockerfile.test | Dockerfile.test（release/test）/ Dockerfile.dev（dev） | 使用的 Dockerfile |

示例

完整参数模式

dev-images test --cache=true --push=true --dockerBuildkit=true --platform=linux/arm64

等价于（使用默认值）：

dev-images test

仅构建不推送（调试用）

dev-images test --push=false

禁用缓存完整重建

dev-images test --cache=false --push=false

禁用 BuildKit

dev-images test --dockerBuildkit=false

指定平台构建

# 构建 ARM64 镜像（默认）
dev-images test --platform=linux/arm64

# 构建 AMD64 镜像
dev-images test --platform=linux/amd64

正式发布

dev-images release --cache=true

开发版本（指定 Dockerfile）

# 使用 Dockerfile.dev（默认）
dev-images dev

# 使用自定义 Dockerfile
dev-images dev --dockerFileName=Dockerfile

环境变量

| 变量 | 默认值 | 说明 | |------|--------|------| | DOCKER_ORG_REPO | docker.cnb.cool/ruten/images | 镜像仓库前缀 |

工作原理

1. 读取本地 package.json 获取 name 和 version
2. 根据命令类型生成镜像标签
3. 执行 docker build 构建镜像
4. 可选执行 docker tag 和 docker push