Cloud MTA Build Tool Docker镜像文档

镜像概述和主要用途

本镜像基于Cloud MTA Build Tool（MTA构建工具）构建，集成了Java 11和Node.js 14运行时环境。旨在提供开箱即用的MTA项目构建环境，简化多目标应用（MTA）的构建流程，无需在本地系统手动配置Java、Node.js及MTA构建工具依赖，适用于开发、测试及CI/CD流水线场景。

核心功能和特性

• 预配置环境：内置Java 11和Node.js 14运行时，满足MTA项目构建的基础依赖需求
• 工具集成：包含Cloud MTA Build Tool（mbt命令），支持MTA项目的构建、打包、验证等全流程操作
• 跨平台兼容：基于Docker容器化，可在Linux、macOS、Windows等支持Docker的系统中运行
• 轻量设计：优化镜像体积，减少冗余依赖，提升构建效率
• 灵活易用：支持挂载本地项目目录，直接执行构建命令，输出产物保存在本地

使用场景和适用范围

• MTA项目开发：开发者本地构建MTA项目，无需手动配置Java/Node.js环境
• CI/CD流水线：集成到Jenkins、GitLab CI、GitHub Actions等自动化流程，实现MTA项目的持续构建
• 团队协作：统一团队构建环境，避免因本地依赖版本差异导致的构建问题
• SAP云平台应用开发：适用于SAP BTP（业务技术平台）上MTA应用的打包与部署前构建

详细使用方法和配置说明

基础使用方法

通过docker run命令挂载本地MTA项目目录，并执行mbt构建命令：

# 构建当前目录下的MTA项目，输出产物到本地项目的./target目录
docker run -v $(pwd):/project -w /project sap/cloud-mta-build-tool:latest mbt build

常用命令示例

1. 查看MTA构建工具版本

docker run sap/cloud-mta-build-tool:latest mbt --version

2. 构建并指定输出目录

docker run -v $(pwd):/project -w /project sap/cloud-mta-build-tool:latest mbt build -t ./custom-target

3. 验证MTA项目配置

docker run -v $(pwd):/project -w /project sap/cloud-mta-build-tool:latest mbt validate

4. 交互式运行容器（调试场景）

docker run -it -v $(pwd):/project -w /project sap/cloud-mta-build-tool:latest /bin/sh

Docker Compose配置示例

创建docker-compose.yml文件，定义MTA构建服务：

version: '3'
services:
  mta-builder:
    image: sap/cloud-mta-build-tool:latest
    volumes:
      - ./:/project  # 挂载本地MTA项目目录
    working_dir: /project
    command: mbt build  # 默认执行构建命令

启动构建：

docker-compose up

环境变量说明

卷挂载说明

注意事项

• 确保本地项目目录包含有效的mta.yaml配置文件，否则构建会失败
• 挂载目录权限需允许容器读写（如Linux/macOS下可通过chmod调整目录权限）
• 如需使用自定义MTA构建配置（如mtaext文件），需将其放置在项目目录下并通过命令指定

配置参数说明

通过mbt build命令的参数可自定义构建行为，常用参数如下：

• -t, --target <dir>：指定构建产物输出目录（默认：./target）
• -p, --platform <platform>：指定目标平台（如cf for Cloud Foundry）
• -e, --extensions <extensions>：指定MTA扩展文件（多个文件用逗号分隔）
• --clean：构建前清理目标目录
• --strict：开启严格模式，遇到警告时终止构建

示例（指定扩展文件并清理目标目录）：

docker run -v $(pwd):/project -w /project sap/cloud-mta-build-tool:latest mbt build -e dev.mtaext --clean