NTS Seidor Salesforce DX 镜像文档

1. 镜像概述

NTS Seidor Salesforce DX镜像基于***Salesforce DX工具链构建，旨在为Salesforce应用开发提供标准化、可移植的运行环境。该镜像整合了Salesforce CLI、Node.js、Git等开发必备工具，消除了本地环境差异导致的"在我机器上能运行"问题，支持跨平台开发与团队协作。

2. 核心功能与特性

2.1 预配置开发工具

• 内置最新稳定版Salesforce CLI（sfdx），支持组织认证、元数据管理、测试执行等核心操作
• 集成Node.js（LTS版本）及npm，满足Apex、Lightning组件开发需求
• 包含Git、SSH客户端，支持版本控制与代码拉取/推送
• 预装Java Runtime Environment（JRE），支持Apex测试与部署

2.2 环境兼容性

• 支持连接Salesforce所有环境类型：开发者版、沙盒（Sandbox）、生产环境（Production）及Scratch Org
• 兼容Docker Desktop（Windows/macOS）及Linux Docker引擎
• 支持ARM/AMD64架构，适配主流开发设备

2.3 开发流程优化

• 内置常用Salesforce DX命令别名，简化操作
• 支持自定义环境变量配置，快速切换开发上下文
• 集成日志输出优化，便于调试与问题定位

3. 使用场景

• Salesforce开发团队协作：统一团队开发环境，避免因本地配置差异导致的兼容性问题
• CI/CD流程集成：作为Jenkins、GitHub Actions等CI/CD工具的执行环境，自动化测试与部署
• 培训与演示环境：快速搭建临时开发环境，降低新手入门门槛
• 多版本并行开发：通过不同容器实例隔离多个项目或版本的开发环境

4. 使用方法与配置说明

4.1 基本使用（docker run）

bash
# 拉取镜像（假设镜像标签为nts-seidor/sfdx:latest）
docker pull nts-seidor/sfdx:latest

# 交互式运行容器（映射当前目录到容器内工作区）
docker run -it --rm -v $(pwd):/workspace nts-seidor/sfdx:latest /bin/bash

# 在容器内执行Salesforce CLI命令示例
sfdx --version
sfdx force:org:list

4.2 环境变量配置

通过-e参数传递环境变量，常用配置项：

示例：使用认证URL自动登录

bash
docker run -it --rm -e SFDX_AUTH_URL="force://<token>@<instance>" nts-seidor/sfdx:latest sfdx force:org:display

4.3 Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  sfdx-dev:
    image: nts-seidor/sfdx:latest
    volumes:
      - ./src:/workspace/src
      - ~/.sfdx:/root/.sfdx  # 持久化Salesforce CLI配置与认证信息
    environment:
      - SFDX_DEFAULT_USERNAME=dev-sandbox
      - SFDX_LOG_LEVEL=debug
    tty: true
    stdin_open: true

启动容器：

bash
docker-compose up -d
docker-compose exec sfdx-dev bash

4.4 持久化配置

通过挂载本地目录到容器内的/root/.sfdx（Linux/macOS）或C:\Users\<User>\.sfdx（Windows），可持久化保存Salesforce CLI的认证信息、配置文件等，避免重复登录：

bash
docker run -it --rm -v ~/.sfdx:/root/.sfdx nts-seidor/sfdx:latest

5. 自定义扩展

如需添加额外工具或依赖，可基于该镜像构建自定义镜像，创建Dockerfile：

dockerfile
FROM nts-seidor/sfdx:latest

# 安装额外依赖（示例：安装jq用于JSON处理）
RUN apt-get update && apt-get install -y jq && rm -rf /var/lib/apt/lists/*

# 添加自定义命令别名
RUN echo 'alias sfdx-deploy="sfdx force:source:deploy -p /workspace/src"' >> ~/.bashrc

构建并使用自定义镜像：

bash
docker build -t my-custom-sfdx .
docker run -it --rm my-custom-sfdx