平台构建

镜像概述和主要用途

此Docker容器用于将SilverStripe源代码压缩为可部署状态，通过运行一系列composer命令及额外脚本，在Silverstripe云部署过程中完成项目构建。

核心功能和特性

• 运行核心composer命令：
  • composer validate：验证composer配置文件
  • composer install --no-progress --prefer-dist --no-dev --ignore-platform-reqs --optimize-autoloader --no-interaction --no-suggest：安装依赖（无进度显示、优先使用分布式包、排除开发依赖、忽略平台要求、优化自动加载器、无交互、无建议）
  • composer vendor-expose copy：暴露供应商资源
• 额外脚本执行（若代码库中存在）：
  • npm/yarn相关：先运行npm install或yarn install，再执行npm run cloud-build或yarn run cloud-build
  • composer脚本：执行composer run-script cloud-build

使用场景和适用范围

适用于Silverstripe云部署流程中，需要将SilverStripe项目源代码处理为可部署状态的场景，尤其适合包含私有仓库依赖或需要额外构建脚本的项目。

详细使用方法和配置说明

基本使用示例

docker run \
    --interactive \
    --tty \
    --volume composer_cache:/tmp/cache \
    --volume ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
    --volume $PWD:/app \
    silverstripe/platform-build

参数说明

• --volume composer_cache:/tmp/cache
  若composer_cache卷不存在则创建，并将其挂载到composer主目录的tmp文件夹，用于缓存composer依赖，加速后续构建。

• --volume ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro
  若源代码包含私有仓库依赖，需将私钥（部署密钥）挂载到容器中（建议设为只读），以授权访问私有仓库。

• --volume $PWD:/app
  容器将从内部的/app目录构建源代码，因此需将本地源代码目录挂载到该路径。