lennartjuetteunic/sapcommerce-azuredevops-ci-image

Azure DevOps Pipelines SAP Commerce构建代理镜像

镜像概述

本Docker镜像专为Azure DevOps Pipelines设计，作为代理节点运行，集成了构建SAP Commerce所需的全套工具链。旨在简化SAP Commerce项目在Azure DevOps环境中的持续集成/持续部署（CI/CD）流程，提供标准化、可重复的构建环境。

核心功能与特性

• Azure DevOps集成：直接作为Pipelines代理运行，无缝对接Azure DevOps服务
• 预配置工具链：包含构建SAP Commerce所需的各类工具（如Java开发环境、构建工具、依赖管理工具等）
• 自动化支持：支持SAP Commerce项目的完整构建流程，包括代码编译、依赖解析、打包等环节
• 环境一致性：确保不同构建环境间的配置统一，减少"在我机器上能运行"的问题
• 轻量部署：容器化设计，支持快速部署和扩展，适应不同规模的CI/CD需求

使用场景

• 企业级SAP Commerce项目的自动化构建流程
• 需要在Azure DevOps中实现SAP Commerce持续集成的团队
• 希望标准化SAP Commerce构建环境的开发和运维团队
• 需频繁执行SAP Commerce构建、测试任务的CI/CD流水线

使用方法与配置说明

前提条件

• 已创建Azure DevOps组织和项目
• 拥有具备代理池管理权限的Azure DevOps个人访问令牌（PAT）
• 目标环境已安装Docker引擎

镜像拉取

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/azure-devops-sap-commerce-agent:latest

注：请将[镜像仓库地址]替换为实际的镜像仓库路径

运行代理容器

使用以下命令启动容器并将其注册为Azure DevOps代理：

bash
docker run -d \
  --name sap-commerce-agent \
  -e AZP_URL="https://dev.azure.com/[组织名称]" \
  -e AZP_TOKEN="[个人访问令牌]" \
  -e AZP_AGENT_NAME="sap-commerce-build-agent" \
  -e AZP_POOL="[代理池名称]" \
  docker.xuanyuan.run/[镜像仓库地址]/azure-devops-sap-commerce-agent:latest

环境变量说明

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  sap-commerce-agent:
    image: docker.xuanyuan.run/[镜像仓库地址]/azure-devops-sap-commerce-agent:latest
    container_name: sap-commerce-agent
    environment:
      - AZP_URL=https://dev.azure.com/MyOrganization
      - AZP_TOKEN=my-personal-access-token
      - AZP_AGENT_NAME=SAP-Commerce-Build-Agent-01
      - AZP_POOL=SAP-Commerce-Pool
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 如需在代理中使用Docker（可选）

启动服务：

bash
docker-compose up -d

验证代理状态

1. 登录Azure DevOps组织
2. 导航至"项目设置" > "代理池"
3. 选择指定的代理池，查看代理是否显示为"在线"状态

注意事项

• 确保个人访问令牌（PAT）具有足够权限（至少需要"代理池(读取&管理)"权限）
• 根据SAP Commerce项目需求，可能需要挂载额外的卷（如Maven仓库缓存、项目代码等）
• 生产环境中建议设置资源限制，避免代理容器过度占用系统资源
• 定期更新镜像以获取最新的工具和安全补丁