在GitLab CI/CD流水线中使用cx_Freeze执行bdist_msi时提示无效命令

我使用py setup.py bdist_msi为Python应用生成Windows单可执行安装包，本地运行完全正常，但在GitLab流水线中执行时失败。本地与流水线均使用Python 3.11.8，报错信息如图所示。

我的setup.py文件 #

from cx_Freeze import setup, Executable
import sys

directory_table = [("ProgramMenuFolder", "TARGETDIR", "."),
                   ("MyProgramMenu", "ProgramMenuFolder", "MYPROG~1|My Program")]

msi_data = {"Directory": directory_table,
            "ProgId": [("Prog.Id", None, None, "This is a description", "IconId", None)],
            "Icon": [("IconId", "matplotlib.ico")]}
files = ['param_list.py', 'mca_ioconfig_parser.py', 'mca_package_manifest_parser.py', 'mca_rti_log_parser.py',
         'ui_interface.py', 'resources_rc.py']
bdist_msi_options = {"add_to_path": False,
                     "data": msi_data,
                     'initial_target_dir': r'[ProgramFilesFolder]%s' % 'yammiX',
                     "upgrade_code": "{96a85bac-52af-4019-9e94-3afcc9e1ad0c}"}

build_exe_options = {"excludes": [], "includes": []}
executables = Executable(script="toolName.py",
                         base="Win32GUI" if sys.platform == "win32" else None,
                         icon="matplotlib.ico",
                         shortcut_name="toolName",
                         shortcut_dir="DesktopFolder")
setup(name="toolName",
      version="0.1.5",
      author="toolName",
      description="",
      executables=[executables],
      options={"build_exe": build_exe_options,
               "bdist_msi": bdist_msi_options})

我的GitLab CI/CD配置文件 #

image: python:3.11.8
stages:
  - build
  - test
  - deploy

build-job:
  stage: build
  # Update stuff before building versions
  before_script:
    - apt-get update -q -y
    - apt install -y python3-pip
    - apt install -y python3-venv
    - python3 -m venv .venv
    - source .venv/bin/activate
    - python3 --version
    - python3 -m pip install -r requirements.txt
  script:
    - python3 setup.py -q bdist_msi

  artifacts:
    paths:
      - build/

unit-test-job:
  stage: test
  script:
    - echo "Running unit tests... This will take about few seconds."
    - echo "Code coverage is 100%"

deploy-job:
  stage: deploy
  script:
    - echo "Deploying application..."
    - echo "Application successfully deployed."

请问该如何解决这个问题？

核心问题是：你用的GitLab流水线镜像是Linux系统（python:3.11.8默认基于Debian），但bdist_msi是cx_Freeze仅支持Windows平台的打包命令，Linux环境无法生成Windows MSI安装包。

有两种可行的解决方式：

1. 改用Windows镜像运行流水线 #

直接切换到Windows版本的Python镜像，让流水线在原生Windows环境下打包：

# 替换原镜像为Windows版本的Python镜像
image: python:3.11.8-windowsservercore-ltsc2022

stages:
  - build
  - test
  - deploy

build-job:
  stage: build
  before_script:
    - python --version
    - pip install -r requirements.txt
  script:
    - python setup.py -q bdist_msi
  # 注意：bdist_msi生成的MSI文件默认在dist目录，不是build
  artifacts:
    paths:
      - dist/

注意：需要确保你的GitLab Runner支持Windows环境——如果用共享Runner，要确认平台支持；如果是自托管Runner，需配置Windows Runner。

2. 在Linux环境用Wine模拟Windows #

如果无法使用Windows镜像，可以通过Wine在Linux中模拟Windows环境执行打包：
修改build-job的配置：

build-job:
  stage: build
  before_script:
    - apt-get update -q -y
    - apt install -y python3-pip python3-venv wine64
    - python3 -m venv .venv
    - source .venv/bin/activate
    - pip install -r requirements.txt
    # 下载并安装Windows版本的Python到Wine环境
    - wget https://www.python.org/ftp/python/3.11.8/python-3.11.8-amd64.exe
    - wine64 python-3.11.8-amd64.exe /quiet InstallAllUsers=1 PrependPath=1
  script:
    # 使用Wine中的Python执行打包命令
    - wine64 python setup.py -q bdist_msi
  artifacts:
    paths:
      - dist/

这种方法存在兼容性风险，部分Python库可能在Wine环境下无法正常工作，优先推荐第一种方案。

另外，原配置中artifacts指定的build/路径错误，bdist_msi的产物默认在dist/目录，需要修正才能正确保存打包结果。

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