jorgesolebur/salesforce-ci

Salesforce CI/CD开发工具集成镜像

镜像概述与主要用途

本Docker镜像专为Salesforce开发与持续集成/持续部署（CI/CD）场景设计，集成了Salesforce CLI（SF CLI）及其核心插件、基础开发工具、代码分析工具和自动化工具，旨在提供开箱即用的标准化环境，支持Salesforce项目的全流程开发、构建、测试与部署。

核心功能与特性

基础开发工具

• ant：支持代码占位符替换及自动化构建流程
• git：版本控制工具，支持代码仓库管理与分支操作
• jq：轻量级JSON处理器，用于解析和提取JSON输出数据
• Powershell 7.4.6：跨平台脚本环境，支持复杂自动化脚本编写

Node.js环境

• Node.js LTS 20.18.1：稳定版Node.js运行时，支持JavaScript开发
• npm LTS 10.8.2：Node.js包管理工具，用于安装依赖包
• ESLint libraries：JavaScript代码检查工具，确保代码质量

Salesforce CLI及插件

• SF CLI：Salesforce官方命令行工具，版本与镜像标签对应（如标签v58.0对应SF CLI 58.0版本）
• SF SFDMU：Salesforce数据迁移工具，支持数据导入/导出
• sfdx-scanner：静态代码分析工具，支持Apex和JavaScript代码质量检查
• sfdx-git-delta：增量部署工具，基于Git差异仅部署变更内容
• lightning-flow-scanner：Lightning Flow扫描工具，检查Flow配置合规性

自动化工具

• cumulusCI：Salesforce项目自动化工具，支持构建、测试、部署流程（依赖Python 3和pipx）

使用场景与适用范围

适用场景

• CI/CD流水线：作为GitHub Actions、GitLab CI、Jenkins等CI/CD平台的执行环境，自动化Salesforce项目的构建、测试与部署
• Salesforce开发：本地或容器化开发环境，集成全套Salesforce CLI工具链
• 静态代码分析：通过sfdx-scanner和ESLint对Apex、JavaScript代码进行质量检查
• 增量部署：使用sfdx-git-delta实现基于Git提交记录的增量部署，提升部署效率
• 数据迁移：通过SF DMU工具执行Salesforce组织间的数据迁移

适用人群

• Salesforce开发工程师
• DevOps工程师（负责Salesforce CI/CD流程设计与维护）
• CI/CD平台管理员（配置Salesforce项目流水线）

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本）
• 具备Docker镜像拉取权限（如镜像托管于私有仓库）

镜像拉取

bash
# 拉取指定SF CLI版本的镜像（示例标签为v58.0）
docker pull [镜像仓库地址]/salesforce-ci-tools:v58.0

注：镜像标签与SF CLI版本对应，具体版本参考镜像仓库标签列表。

容器运行

基础运行（交互式终端）

bash
docker run -it --rm \
  -v $(pwd):/workspace  # 挂载本地项目目录到容器内/workspace
  [镜像仓库地址]/salesforce-ci-tools:v58.0 \
  /bin/bash  # 启动bash终端

执行SF CLI命令

bash
# 检查SF CLI版本
docker run --rm [镜像仓库地址]/salesforce-ci-tools:v58.0 sf --version

# 执行Salesforce认证（需提前获取SFDX认证URL）
docker run --rm \
  -e SFDX_AUTH_URL="your-sfdx-auth-url" \  # 注入SF CLI认证环境变量
  [镜像仓库地址]/salesforce-ci-tools:v58.0 \
  sf org login sfdx-url -f -  # 通过环境变量认证Salesforce组织

CI/CD流水线集成示例（GitHub Actions）

在.github/workflows/salesforce-deploy.yml中配置：

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run Salesforce CI tools
        uses: docker/run-action@v3
        with:
          image: [镜像仓库地址]/salesforce-ci-tools:v58.0
          volumes:
            - ${{ github.workspace }}:/workspace
          env:
            SFDX_AUTH_URL: ${{ secrets.SFDX_AUTH_URL }}  # 从GitHub Secrets注入认证信息
          run: |
            cd /workspace
            # 安装项目依赖
            npm install
            # 执行静态代码分析
            sf scanner run --target "force-app/**/*.{cls,js}"
            # 增量部署变更内容
            sf sgd:source:delta --from "HEAD~1" --to "HEAD" --output . --generate-delta
            sf deploy metadata --source-dir delta/source

环境变量配置

许可证信息

镜像本身

本Docker镜像采用MIT License许可。详情参见镜像内LICENSE文件。

包含组件许可证

• Ubuntu：基于Apache 2.0 License许可
• Node.js：基于MIT License许可
• Salesforce CLI及插件：基于https://github.com/salesforcecli/cli?tab=BSD-3-Clause-1-ov-file#readme%E8%AE%B8%E5%8F%AF%EF%BC%8C%E5%85%81%E8%AE%B8%E5%85%8D%E8%B4%B9%E5%86%8D%E5%88%86%E5%8F%91

合规说明

使用或分发本镜像时，需遵守上述各组件的许可证要求，确保合规性。