gperdomor/nx-kaniko

镜像文档：@nx-tools/nx-container构建器辅助镜像

镜像概述

该Docker镜像作为@nx-tools/nx-container npm包的配套构建器工具，专为Nx工作区环境设计，旨在简化和支持容器化构建流程。通过提供标准化的构建环境和工具链，确保与@nx-tools/nx-container包的无缝集成，提升Nx项目容器化构建的一致性和效率。

核心功能和特性

• 无缝集成：与@nx-tools/nx-container npm包深度协同，支持其完整构建功能
• 环境标准化：内置容器构建所需的依赖环境，消除本地环境差异导致的构建问题
• 流程简化：简化Nx工作区项目的容器化配置流程，减少手动配置步骤
• 多场景支持：适配开发环境调试、CI/CD流水线等多种容器构建场景
• 一致性保障：提供统一的构建环境，确保团队成员和自动化流程中构建结果一致

使用场景和适用范围

• 使用Nx工作区进行多项目管理的开发团队
• 通过@nx-tools/nx-container实现项目容器化构建的开发流程
• 需要在CI/CD流水线中标准化容器构建环境的自动化场景
• 追求构建环境一致性，希望减少"在我机器上能运行"类问题的团队

使用方法和配置说明

基本使用方式

该镜像需配合Nx工作区和@nx-tools/nx-container包使用，基本运行命令如下：

bash
docker run --rm -v /path/to/nx-workspace:/workspace docker.xuanyuan.run/my-builder-image

参数说明：

• -v /path/to/nx-workspace:/workspace：将本地Nx工作区目录挂载到容器内/workspace目录
• --rm：容器运行结束后自动清理
• my-builder-image：实际使用的镜像名称及标签（需替换为具体镜像标识）

与Nx配置集成

在Nx项目配置中（如project.json或nx.json），通过指定构建器镜像来使用该工具：

json
{
  "targets": {
    "build-container": {
      "executor": "@nx-tools/nx-container:build",
      "options": {
        "builderImage": "my-builder-image",
        "context": ".",
        "dockerfile": "Dockerfile"
        // 其他容器构建配置...
      }
    }
  }
}

Docker Compose集成示例

在docker-compose.yml中配置服务，用于本地开发环境的容器化构建：

yaml
version: '3.8'
services:
  nx-container-builder:
    image: docker.xuanyuan.run/my-builder-image
    volumes:
      - ./:/workspace
      - ~/.docker/config.json:/root/.docker/config.json # 可选，挂载Docker认证配置
    working_dir: /workspace
    command: nx run my-app:build-container

注意事项

1. 确保本地环境已安装@nx-tools/nx-container npm包：

   bash
   npm install --save-dev @nx-tools/nx-container
   

2. 根据实际镜像仓库地址替换示例中的my-builder-image

3. 在CI/CD环境中使用时，建议配合工作区缓存机制以提升构建效率

4. 如需自定义构建环境，可基于此镜像创建派生镜像并添加额外依赖