如何在BitBake配方中同时支持SSH与PAT方式克隆代码库？

问题场景 #

我们编写BitBake配方时，原本使用SSH方式拉取代码：

SRC_URI = "git://git@github.com/our_org/our_repo;protocol=ssh;branch=main"

该配置在已搭建SSH环境的场景下运行正常，但团队部分成员习惯使用GitHub PAT（个人访问令牌）的HTTPS方式，对应配置为：

SRC_URI = "git://github.com/our_org/our_repo;protocol=https;branch=main"

我们希望实现两种方式兼容：当HTTPS（PAT）认证失败时，自动降级到SSH方式。之前尝试过用MIRRORS配置（刚接触Yocto，用法可能有误）：

SRC_URI = "git://github.com/our_org/our_repo;protocol=https;branch=main"
MIRRORS = "git://.*/.* git://github.com/our_org/our_repo;protocol=https;branch=main" 

但HTTPS认证失败时程序直接抛出异常退出，想了解最佳实现方案是通过全局变量构建SRC_URI，还是有内置的降级机制？

可行方案 #

方案一：利用BitBake多源优先级实现自动降级 #

BitBake原生支持在SRC_URI中配置多个拉取源，配合BB_FETCH_PRIORITY参数可以控制尝试顺序，实现失败自动降级。具体配置如下：

# 同时配置HTTPS和SSH源，给HTTPS设置更高优先级
SRC_URI = " \
    git://github.com/our_org/our_repo;protocol=https;branch=main;name=https \
    git://git@github.com/our_org/our_repo;protocol=ssh;branch=main;name=ssh \
"

# 数字越大优先级越高，优先尝试HTTPS源
BB_FETCH_PRIORITY_https = "10"
BB_FETCH_PRIORITY_ssh = "5"

注意：每个源必须添加name参数区分，否则BitBake会判定为同一源，跳过后续尝试。

方案二：通过全局变量动态切换（支持手动指定+自动降级） #

如果需要更灵活的控制，比如允许用户手动指定认证方式，可通过全局变量动态构建SRC_URI：

# 默认使用HTTPS，用户可在local.conf中覆盖该变量切换方式
GIT_AUTH_METHOD ?= "https"

# 根据变量值动态生成SRC_URI
SRC_URI = "${@bb.utils.contains('GIT_AUTH_METHOD', 'https', \
    'git://github.com/our_org/our_repo;protocol=https;branch=main', \
    'git://git@github.com/our_org/our_repo;protocol=ssh;branch=main', \
    d)}"

若要实现自动降级，可添加前置检查任务，在fetch前测试HTTPS可用性，失败则自动切换：

python do_pre_fetch() {
    import subprocess
    import tempfile
    import shutil

    # 临时目录测试HTTPS克隆
    tmp_dir = tempfile.mkdtemp()
    test_repo = "https://github.com/our_org/our_repo.git"
    result = subprocess.call(
        ["git", "clone", "--depth", "1", test_repo, tmp_dir],
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL
    )
    shutil.rmtree(tmp_dir)

    if result != 0:
        d.setVar('GIT_AUTH_METHOD', 'ssh')
        bb.warn("HTTPS认证失败，自动降级到SSH方式")
}
addtask pre_fetch before do_fetch

关于MIRRORS配置无效的原因 #

MIRRORS的设计目标是源地址不可达时替换为镜像地址，无法处理认证失败这类权限问题。当HTTPS认证失败时，BitBake会直接判定为错误，不会触发镜像替换逻辑，因此该场景下MIRRORS不适用。

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