在GitLab CI/CD流水线中使用docToolchain遇权限问题求助

问题背景 #

在GitLab项目CI/CD流水线中集成docToolchain时，复制示例项目的.gitlab-ci.yml后修改了启动命令，配置如下：

image: doctoolchain/doctoolchain:v2.2.1
pages:
  stage: build
  script:
    - export DTC_HEADLESS=true
    - ./dtcw.bat generateSite # 将原命令./dtcw改为./dtcw.bat
    - mkdir public
    - cp -r build/microsite/output/. public/.
  artifacts:
    paths:
      - public/

流水线运行时触发错误：

$ ./dtcw generateSite
/bin/bash: line 135: ./dtcw.bat: Permission denied

本地项目已安装docToolchain并推送，包含dtcw.ps1、dtcw.bat、docToolchainconfig.groovy文件，但缺少示例项目中的dtcw文件，尝试改用./dtcw.bat或./dtcw.ps1均出现权限拒绝问题。

问题解答 #

• 权限拒绝原因：你使用的doctoolchain/doctoolchain:v2.2.1是基于Linux的镜像，而dtcw.bat、dtcw.ps1是Windows平台专属脚本，在Linux环境下无法直接执行，且这类脚本默认没有可执行权限，因此触发权限拒绝错误。

• 关于dtcw文件：这个文件是docToolchain为Linux/macOS平台提供的Shell启动脚本，用于在类Unix系统中调用docToolchain的各项命令，是跨平台启动套件的一部分，你确实需要添加这个文件到项目中。

• 解决步骤：

  1. 获取dtcw脚本：从docToolchain官方资源或示例项目中复制该脚本，放到项目根目录
  2. 添加可执行权限：本地执行chmod +x dtcw后推送到GitLab；或者在CI脚本中先执行chmod +x dtcw再运行命令
  3. 修正CI配置：将.gitlab-ci.yml中的命令改回./dtcw generateSite，即示例项目中的原始写法

内容的提问来源于stack exchange，提问作者Cat