eric2369/debian12-nodejs-typescript-salesforcecli

镜像概述

本Docker镜像基于Debian 12（Bookworm）稳定版构建，集成Node.js、TypeScript及Salesforce CLI工具链，旨在为Salesforce应用开发提供标准化、可移植的开发环境。通过预装核心开发工具，简化环境配置流程，支持从代码编写、类型检查到Salesforce平台部署的全流程开发需求。

核心功能与特性

基础环境

• 系统底座：基于Debian 12（Bookworm）稳定版，提供可靠的系统环境
• Node.js运行时：集成Node.js（具体版本依Dockerfile配置，通常为LTS版本）及npm/yarn包管理工具
• 开发工具链：包含Git、curl、wget等基础开发工具，满足日常开发操作需求

开发支持

• TypeScript集成：预装TypeScript编译器（tsc）及类型定义，支持TypeScript项目的编译与类型检查
• Salesforce CLI：集成Salesforce官方命令行工具（sf CLI），支持Salesforce组织认证、元数据部署、Apex代码执行等核心操作
• 环境一致性：标准化开发环境，避免"本地环境可用，部署环境异常"的问题

使用场景

• Salesforce应用开发：本地开发Salesforce Lightning Web Components（LWC）、Apex类、触发器等
• TypeScript项目构建：使用TypeScript开发Salesforce相关应用，并通过镜像内工具链完成编译打包
• CI/CD流程集成：作为CI/CD管道中的构建/部署节点，执行自动化测试、打包及Salesforce环境部署
• 学习与测试：快速搭建临时环境，学习Salesforce CLI命令或测试新功能兼容性

使用方法

基本使用（docker run）

通过以下命令启动镜像并进入交互式终端：

bash
docker run -it --rm eric2369/debian12-nodejs-typescript-salesforcecli /bin/bash

挂载项目目录

将本地Salesforce项目目录挂载至容器，进行开发和构建：

bash
docker run -it --rm \
  -v /path/to/your/salesforce-project:/app \
  -w /app \
  eric2369/debian12-nodejs-typescript-salesforcecli \
  /bin/bash

进入容器后，可直接使用Salesforce CLI命令操作项目：

bash
# 登录Salesforce组织
sf org login web

# 部署元数据至组织
sf project deploy start

# 使用TypeScript编译项目
tsc

环境变量配置

可通过环境变量自定义部分配置（具体支持的变量依Dockerfile定义，常见包括）：

• NODE_ENV：设置Node.js环境（如development、production）
• SALESFORCE_HUB_ORG：预设Salesforce Hub组织别名
• NPM_REGISTRY：自定义npm镜像源

示例：

bash
docker run -it --rm \
  -e NODE_ENV=development \
  -e NPM_REGISTRY=https://registry.npm.taobao.org \
  eric2369/debian12-nodejs-typescript-salesforcecli

Docker Compose示例

创建docker-compose.yml文件整合项目开发环境：

yaml
version: '3'
services:
  salesforce-dev:
    image: eric2369/debian12-nodejs-typescript-salesforcecli
    volumes:
      - ./salesforce-project:/app
    working_dir: /app
    tty: true
    environment:
      - NODE_ENV=development

启动服务：

bash
docker-compose up -d
docker-compose exec salesforce-dev /bin/bash

验证环境

进入容器后，可通过以下命令验证工具是否正常安装：

bash
# 检查Node.js版本
node -v

# 检查TypeScript版本
tsc -v

# 检查Salesforce CLI版本
sf --version