radon57/sfdx-cli

轻量级SFDX CLI镜像（CI/CD专用）

镜像概述

本镜像为CI/CD场景设计，提供轻量级的SFDX CLI运行环境。基于Linux系统和Node.js v11官方slim镜像构建，集成了SFDX CLI（通过npm安装）、git版本控制工具，以及可选的Python 3（仅node-python版本包含），旨在为Salesforce项目的持续集成和部署流程提供精简高效的运行环境。

核心功能与特性

• 轻量级基础：基于Node.js v11官方slim镜像，减少镜像体积，提升CI/CD流程效率
• 完整SFDX CLI：通过npm安装最新稳定版SFDX CLI，支持Salesforce项目的各类开发操作（如元数据部署、检索、测试执行等）
• 版本控制支持：内置git工具，便于在CI/CD流程中拉取代码、管理版本
• 可选Python 3：node-python版本额外包含Python 3环境，满足依赖Python的SFDX插件或脚本需求

使用场景与适用范围

• Salesforce项目的持续集成/持续部署（CI/CD）流水线
• 自动化执行Salesforce元数据部署、测试、代码质量检查等任务
• 需要在隔离环境中运行SFDX命令的场景
• 对镜像体积有要求的轻量级CI/CD系统

使用方法与配置说明

镜像版本选择

• 标准版本：包含Linux、Node.js v11、SFDX CLI、git
• node-python版本：在标准版本基础上增加Python 3支持

基本使用（docker run）

bash
# 标准版本：检查SFDX版本
docker run --rm [镜像名称] sfdx --version

# node-python版本：检查Python版本
docker run --rm [镜像名称]:node-python python --version

典型CI/CD场景示例

在CI/CD pipeline中拉取代码并执行SFDX部署：

bash
# 拉取代码
docker run --rm -v $(pwd):/workspace [镜像名称] git clone https://github.com/your-salesforce-repo.git /workspace

# 执行SFDX认证（需提前配置环境变量或密钥）
docker run --rm -v $(pwd):/workspace [镜像名称] sfdx auth:jwt:grant --clientid [CLIENT_ID] --jwtkeyfile /workspace/server.key --username [USERNAME] --setdefaultdevhubusername

# 部署元数据
docker run --rm -v $(pwd):/workspace [镜像名称] sfdx force:source:deploy -p /workspace/force-app -u [USERNAME]

docker-compose配置示例

yaml
version: '3'
services:
  sfdx-ci:
    image: [镜像名称]
    volumes:
      - ./code:/workspace
    environment:
      - SFDX_CLIENT_ID=[your_client_id]
      - SFDX_HUB_USERNAME=[your_username]
    command: sfdx force:source:deploy -p /workspace/force-app

注意事项

• 运行涉及Salesforce认证的命令时，需通过环境变量、密钥挂载或CI/CD系统的安全存储提供认证信息
• 根据项目需求选择合适版本（标准版或node-python版）
• 建议在CI/CD流程中使用特定版本标签，避免因镜像更新导致兼容性问题