atlasprof/salesforce-dx

Salesforce部署工具镜像

镜像概述

本Docker镜像专为Bitbucket Pipeline设计，集成了Salesforce CLI (DX)和Force.com CLI，可直接用于bitbucket-pipeline.yaml文件，实现Salesforce代码及元数据的自动化部署。

核心功能与特性

• 预安装工具：包含Salesforce DX CLI（sfdx）和Force.com CLI，无需额外配置工具环境
• Pipeline集成：直接适配Bitbucket Pipeline，支持CI/CD流程无缝对接
• 部署支持：支持Salesforce代码（Apex、Visualforce等）和元数据（自定义对象、字段等）的部署操作
• 即开即用：镜像开箱即可使用，减少环境配置时间

使用场景与适用范围

• 开发团队通过Bitbucket Pipeline自动化部署Salesforce应用
• 将代码和元数据部署到Salesforce组织（开发、测试、UAT或生产环境）
• 集成到持续集成/持续部署流程中，实现Salesforce变更的自动化交付

使用方法与配置说明

在Bitbucket Pipeline中使用

在bitbucket-pipeline.yaml文件中指定本镜像，配置部署步骤：

yaml
pipelines:
  default:
    - step:
        name: Deploy to Salesforce
        image: [镜像名称]  # 替换为实际镜像名称
        script:
          - sfdx auth:jwt:grant --clientid $SF_CLIENT_ID --jwtkeyfile server.key --username $SF_USERNAME --setdefaultdevhubusername
          - sfdx force:source:deploy -p force-app/main/default/ -u $SF_USERNAME

环境变量配置

部署过程中通常需要以下环境变量（根据实际认证方式调整）：

• SF_CLIENT_ID：Salesforce Connected App的客户端ID
• SF_USERNAME：Salesforce组织用户名
• SF_PASSWORD（可选）：Salesforce用户密码（如使用密码认证）
• JWT_KEY_FILE（可选）：JWT密钥文件路径（如使用JWT认证）

本地测试（Docker Run）

可通过以下命令本地测试镜像功能：

bash
docker run -it [镜像名称] sfdx --version

运行后将显示Salesforce DX CLI版本，确认工具已正确安装。

注意事项

• 确保Bitbucket Pipeline中已配置所需的环境变量（如通过Bitbucket仓库设置中的"Repository variables"）
• 根据Salesforce组织的安全策略选择合适的认证方式（JWT、密码等）
• 部署前建议通过sfdx force:source:validate命令进行代码验证