makepositive/ant 镜像文档

镜像概述

makepositive/ant 是专为 makepositive 团队设计的通用构建基础镜像，主要用于 Bitbucket Pipelines 构建环境，同时兼容 Azure Pipelines。该镜像集成了多种开发工具与依赖组件，旨在提供一站式构建环境，简化跨平台 CI/CD 流程配置。

核心功能与特性

开发工具集成

• Java 环境：OpenJDK 11，支持 Java 应用编译与运行
• 构建工具：Apache Ant，提供自动化构建能力
• JavaScript 生态：NodeJS 及 NPM，支持前端项目依赖管理与构建
• 脚本与编程语言：Perl、Python，满足多语言脚本处理需求
• 版本控制：Git，支持代码拉取与版本管理

系统与安全工具

• Shell 环境：Bash，提供命令行操作支持
• 压缩/解压：Zip、Tar，处理文件归档需求
• 安全组件：OpenSSL、OpenSSH、Mozilla Network Security Services，保障网络通信安全

Azure Pipelines 专用依赖

• Shadow：提供用户与组管理工具
• Sudo：支持权限提升操作，满足 Azure 环境特殊权限需求

使用场景与适用范围

1. Bitbucket Pipelines 构建环境
   作为基础镜像用于 Bitbucket 代码仓库的自动化构建流程，支持 Java、前端、多语言混合项目的构建与测试。

2. Azure Pipelines 构建环境
   兼容 Azure DevOps 流水线配置，通过集成的 Shadow 与 Sudo 工具满足 Azure 环境的权限与系统依赖要求。

3. 多工具集成构建场景
   适用于需要同时使用 Java、NodeJS、Perl、Python 等多种技术栈的项目构建流程，减少多镜像切换成本。

使用方法与配置说明

基础使用方式

在 CI/CD 配置文件中直接引用该镜像作为构建环境：

Bitbucket Pipelines 配置示例 (bitbucket-pipelines.yml)

yaml
image: makepositive/ant

pipelines:
  default:
    - step:
        name: 构建与测试
        script:
          - git --version  # 验证 Git 环境
          - java -version   # 验证 JDK 环境
          - ant -version    # 验证 Ant 环境
          - npm -v          # 验证 NPM 环境
          - python --version # 验证 Python 环境
          - ant build       # 执行 Ant 构建脚本
          - npm install     # 安装前端依赖

Azure Pipelines 配置示例 (azure-pipelines.yml)

yaml
pool:
  vmImage: 'ubuntu-latest'

container: makepositive/ant

steps:
- script: |
    ant -version
    sudo apt-get update  # 示例：使用 sudo 执行权限操作
  displayName: '验证环境与执行构建'

直接运行容器（本地测试）

bash
docker run -it --rm makepositive/ant bash

进入容器后，可直接使用集成工具（如 ant、npm、git 等）进行命令行操作与环境验证。

注意事项

• 该镜像为通用构建基础镜像，未包含项目特定依赖，需在 CI/CD 脚本中根据项目需求补充安装额外依赖。
• Azure Pipelines 中使用 sudo 时，需确保流水线配置允许权限提升操作。
• 工具版本可能随镜像更新变化，建议通过 [工具名] --version 命令验证当前环境版本。