icatiprlv/sfdx-cli

Salesforce CI/CD专用镜像（含sfdx-cli）

镜像概述

本Docker镜像预装Salesforce官方命令行工具sfdx-cli，旨在为Salesforce开发者和DevOps团队提供标准化的CI/CD环境。通过容器化部署，可快速集成到持续集成/持续部署流程中，简化Salesforce应用的元数据管理、代码部署、测试执行等任务，确保开发环境一致性和流程自动化。

核心功能与特性

• 预装sfdx-cli：包含最新稳定版Salesforce CLI，支持所有标准sfdx命令（如组织管理、元数据部署、代码检索、测试运行等）
• 环境隔离：容器化设计避免本地环境依赖冲突，确保CI/CD流程在不同环境中行为一致
• 轻量级基础：基于Alpine或Ubuntu精简镜像构建，减少资源占用
• 版本可控：可通过标签指定sfdx-cli版本，满足不同项目兼容性需求
• 易于集成：支持与主流CI/CD平台（Jenkins、GitLab CI、GitHub Actions等）无缝对接

使用场景

• Salesforce应用自动化部署：在CI/CD流水线中执行sfdx force:source:deploy等命令，实现代码自动部署到Sandbox或Production环境
• 持续集成测试：通过sfdx force:apex:test:run运行Apex测试，并集成测试报告到CI平台
• 多环境管理：统一管理开发、测试、生产等多环境的Salesforce组织认证与配置
• 元数据版本控制：结合Git实现Salesforce元数据的版本管理与追溯
• 快速开发环境搭建：本地开发时通过容器快速获取标准化的sfdx环境，无需手动安装依赖

使用方法与配置说明

基本使用

1. 拉取镜像

bash
docker pull [镜像仓库地址]/sfdx-ci-cd:latest

2. 基本运行（交互式）

bash
docker run -it --rm [镜像仓库地址]/sfdx-ci-cd:latest sfdx --version

输出示例：sfdx-cli/7.200.0 darwin-x64 node-v18.15.0

3. 挂载本地项目目录

将本地Salesforce项目挂载到容器中，执行部署或测试命令：

bash
docker run -it --rm -v $(pwd):/workspace -w /workspace [镜像仓库地址]/sfdx-ci-cd:latest \
  sfdx force:source:deploy -p force-app -u my-sandbox

CI/CD集成示例

GitHub Actions配置

在.github/workflows/deploy.yml中添加步骤：

yaml
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run sfdx-cli in Docker
        run: |
          docker run -v $(pwd):/workspace -w /workspace [镜像仓库地址]/sfdx-ci-cd:latest \
            sfdx auth:sfdxurl:store -f ./auth-url.txt -a target-org && \
            sfdx force:source:deploy -p force-app -u target-org

Docker Compose配置

创建docker-compose.yml：

yaml
version: '3'
services:
  sfdx:
    image: [镜像仓库地址]/sfdx-ci-cd:latest
    volumes:
      - ./salesforce-project:/workspace
    working_dir: /workspace
    environment:
      - SFDX_AUTH_URL=${SFDX_AUTH_URL}  # 从环境变量传入认证信息
    command: sfdx force:source:deploy -p force-app -u target-org

环境变量配置

常用sfdx命令示例

• 验证环境：sfdx --version
• 认证组织：sfdx auth:web:login -a my-org
• 部署元数据：sfdx force:source:deploy -p force-app/main/default/classes -u my-org
• 运行Apex测试：sfdx force:apex:test:run -n MyTestClass -u my-org -r human
• 检索元数据：sfdx force:source:retrieve -m ApexClass:MyClass -u my-org

注意事项

• 认证信息（如SFDX_AUTH_URL）属于敏感数据，建议通过CI/CD平台的密钥管理功能传递，避免硬编码
• 定期更新镜像以获取最新版sfdx-cli和安全补丁
• 对于大型项目，建议结合缓存机制（如挂载sfdx缓存目录）提升构建效率