GitLab CI克隆GitHub私有子模块失败，求解决方案

针对GitLab 14.9.5-ee版本无法使用pre_clone_script/pre_get_sources_script钩子的情况，可通过以下两种可行方案解决：

方案一：禁用自动子模块拉取，手动处理克隆与认证 #

在.gitlab-ci.yml中设置禁用自动子模块拉取，然后手动配置认证并拉取主仓库和子模块：

variables:
  GIT_SUBMODULE_STRATEGY: none  # 阻止CI自动拉取子模块

build_job:
  before_script:
    # 配置Git自动替换GitHub HTTPS URL为带凭据的版本
    - git config --global url."https://${GITHUB_USER_NAME}:${GITHUB_TOKEN}@github.com".insteadOf "https://github.com"
    # 克隆主仓库（CI_REPOSITORY_URL为GitLab自动提供的项目地址）
    - git clone $CI_REPOSITORY_URL .
    # 初始化并拉取所有子模块
    - git submodule init
    - git submodule update --recursive
  script:
    # 此处添加你的构建命令
    - echo "开始构建..."

方案二：同步子模块URL并重新拉取 #

如果CI已经自动拉取了主仓库但子模块认证失败，可通过同步子模块URL并重新拉取解决：

build_job:
  before_script:
    # 配置Git URL替换规则
    - git config --global url."https://${GITHUB_USER_NAME}:${GITHUB_TOKEN}@github.com".insteadOf "https://github.com"
    # 同步子模块URL（将.gitmodules中的URL替换为带凭据的版本）
    - git submodule sync --recursive
    # 初始化并更新子模块
    - git submodule update --init --recursive
  script:
    # 此处添加你的构建命令
    - echo "开始构建..."

前置准备 #

1. 在GitLab项目的CI/CD > 变量中添加GITHUB_USER_NAME（GitHub用户名）和GITHUB_TOKEN（拥有子模块仓库权限的个人访问令牌），并勾选"掩码"选项避免泄露。
2. 确保GitHub令牌拥有repo权限（私有仓库访问需要）。

关键说明 #

• GitLab CI默认会在before_script执行前尝试拉取子模块，因此必须通过GIT_SUBMODULE_STRATEGY: none禁用自动拉取，或者通过git submodule sync强制更新子模块URL后重新拉取，才能让认证凭据生效。
• url.insteadOf规则会让Git在访问GitHub HTTPS地址时自动替换为包含用户名和令牌的认证URL，无需修改.gitmodules文件。

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