Bitbucket Server如何实现跨仓库导入共用Python配置文件

有三种可落地的方案，不需要私有制品仓库，也不需要上传公共仓库：

方案1：使用Git子模块挂载配置仓库 #

• 把配置文件单独存放在一个Bitbucket私有仓库中，例如命名为common-python-config
• 在所有需要引用配置的项目仓库根目录执行命令：

  git submodule add <你的配置仓库Bitbucket访问地址> ./common_config
  

• 代码中直接导入使用即可：

  from common_config import your_config
  

• 配置文件更新后，所有项目仅需执行git submodule update --remote即可拉取到最新版本，无需单独维护副本。

方案2：通过Bitbucket Server API动态加载配置 #

• 先在Bitbucket后台生成有权限读取配置仓库的个人访问令牌（PAT）
• 在项目中新增加载逻辑，运行时从配置仓库拉取最新配置文件内容加载到Python环境中：

  import requests
  import sys
  from io import BytesIO
  from zipfile import ZipFile
  import os
  
  # 相关参数建议从环境变量读取，不要硬编码
  BITBUCKET_HOST = os.getenv("BITBUCKET_HOST")
  PROJECT_KEY = os.getenv("CONFIG_REPO_PROJECT_KEY")
  REPO_NAME = "common-python-config"
  BRANCH = "main"
  CONFIG_FILE_PATH = "your_config.py"
  PAT = os.getenv("BITBUCKET_READ_PAT")
  
  resp = requests.get(
      f"https://{BITBUCKET_HOST}/rest/api/latest/projects/{PROJECT_KEY}/repos/{REPO_NAME}/archive?format=zip&path={CONFIG_FILE_PATH}&at={BRANCH}",
      headers={"Authorization": f"Bearer {PAT}"},
      stream=True
  )
  resp.raise_for_status()
  
  # 解压加载配置文件到模块
  with ZipFile(BytesIO(resp.content)) as zf:
      with zf.open(CONFIG_FILE_PATH) as f:
          config_code = f.read()
  config_module = sys.modules.setdefault("common_config", type(sys)("common_config"))
  exec(config_code, config_module.__dict__)
  
  # 后续可正常导入配置使用
  from common_config import CONFIG_VAR
  

• 该方案无需改动项目Git结构，配置更新实时生效，无需手动同步。

方案3：pip直接安装私有Git仓库依赖 #

• 将配置文件仓库封装为极简Python包，仅需新增空的__init__.py和基础的pyproject.toml/setup.py文件即可
• 在每个项目的requirements.txt中添加依赖声明：

  git+https://<你的PAT>@<你的Bitbucket配置仓库Git地址>.git@main#egg=common-python-config
  

• 执行pip install -r requirements.txt即可完成安装，使用时直接import common_config即可。

注意：所有用到个人访问令牌的场景，都不要将令牌硬编码到代码仓库中，建议存放到项目环境变量或CI/CD的保密变量中管理。

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