wunderio/silta-cicd

Silta构建CI/CD Docker镜像文档

1. 镜像概述

本Docker镜像专为Silta项目的CI/CD流程设计，提供标准化的构建环境，确保Silta项目在持续集成和持续部署过程中具备一致的运行环境，简化构建流程并提升可靠性。

2. 核心功能与特性

• 标准化构建环境：预安装Silta构建所需的核心依赖工具和运行时环境，避免因环境差异导致的构建问题。
• CI/CD工具集成：兼容主流CI/CD平台（如GitLab CI、GitHub Actions、Jenkins等），可直接作为构建步骤的执行环境。
• 轻量级设计：基于精简基础镜像构建，减少资源占用，提升构建效率。
• 灵活配置：支持通过环境变量和挂载卷自定义构建参数和项目配置。

3. 使用场景与适用范围

• Silta项目构建：适用于所有基于Silta框架开发的项目，在CI/CD流程中执行构建、测试、打包等任务。
• 多平台CI/CD集成：可无缝集成到GitLab CI、GitHub Actions、Bitbucket Pipelines等主流CI/CD平台，作为构建阶段的执行环境。
• 本地开发调试：开发人员可在本地使用该镜像模拟CI/CD环境，调试Silta构建流程。

4. 使用方法与配置说明

4.1 基本使用（Docker Run）

通过以下命令启动容器并运行Silta构建：

bash
docker run --rm -v $(pwd):/app -e SILTA_PROJECT_PATH=/app silta-cicd-image:latest silta build

参数说明：

• -v $(pwd):/app：将本地项目目录挂载到容器内/app路径，作为Silta项目根目录。
• -e SILTA_PROJECT_PATH=/app：指定容器内Silta项目的路径（需与挂载路径一致）。
• silta build：执行Silta构建命令。

4.2 环境变量配置

4.3 CI/CD平台集成示例（GitLab CI）

在.gitlab-ci.yml中集成该镜像执行Silta构建：

yaml
stages:
  - build

silta-build:
  stage: build
  image: silta-cicd-image:latest
  variables:
    SILTA_PROJECT_PATH: /builds/$CI_PROJECT_PATH
    BUILD_CONFIG: custom.config.yml
  script:
    - silta build
  cache:
    paths:
      - $SILTA_PROJECT_PATH/.silta-cache/

4.4 本地调试

本地启动容器并进入交互式终端，调试构建环境：

bash
docker run -it --rm -v $(pwd):/app -e SILTA_PROJECT_PATH=/app silta-cicd-image:latest /bin/bash

进入容器后，可执行silta --version验证环境，或手动运行构建命令调试。

5. 注意事项

• 确保挂载的项目目录具有正确的读写权限，避免因权限问题导致构建失败。
• 构建缓存默认存储在$SILTA_PROJECT_PATH/.silta-cache/，如需清理缓存，可删除该目录或设置CACHE_ENABLED=false。
• 不同版本的镜像可能对应不同版本的Silta工具，使用时需匹配项目所需的Silta版本。