如何在GitHub Action的services容器内安装运行Python包并实现客户端连接

首先明确两个核心前提：

• GitHub Actions的services配置块本身仅支持声明镜像、端口映射、容器启动参数、环境变量等基础配置，没有原生支持在容器启动时执行自定义安装命令的字段，无法直接在server服务的配置块下写安装逻辑。
• 你原有配置存在两处常见误区：
  1. image: ubuntu-latest 不是合法的Docker镜像地址，它是GitHub托管runner的运行环境标识，无法被Docker拉取，需要替换为标准的公开Docker镜像，比如ubuntu:22.04
  2. YAML层级错误：所有job必须定义在顶级jobs节点下，你现在将remote_server放在了build节点下，会导致工作流识别失败。

可落地的实现路径 #

方法1：通过docker exec直接进入service容器安装依赖、启动服务 #

GitHub Actions的托管runner本身内置完整Docker环境，你在job级定义的services容器，本质是跑在runner本机Docker进程下的普通容器，完全可以通过Docker命令直接操作。
操作逻辑：

• 在services定义里给server容器固定名称，映射服务需要的端口到runner本机
• 在steps的最开头添加前置步骤，待容器正常启动后，通过docker exec进入容器执行所有Python环境、服务端包的安装操作，后台启动对应服务
• 后续客户端步骤可通过映射到本机的端口，正常连接server服务

完整可运行的配置示例：

name: test

jobs:
  remote_server:
    name: ${{ matrix.os }} - Python v${{ matrix.python-version }}
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest]
        python-version: ["3.10"]
    services:
      server:
        # 替换为合法可拉取的基础镜像
        image: ubuntu:22.04
        # 固定容器名，方便后续Docker命令定位
        options: --name test-server-container
        # 将server服务端口映射到runner本机
        ports:
          - 8000:8000

    steps:
      - name: 进入server容器安装Python环境与服务端包
        run: |
          # 确认容器正常运行
          docker ps | grep test-server-container
          # 在server容器内完成安装、后台启动服务
          docker exec test-server-container bash -c "
            apt update && 
            apt install -y python3 python3-pip && 
            # 替换为实际需要安装的服务端Python包
            pip3 install 服务端依赖包名 && 
            # 启动服务，绑定0.0.0.0确保端口可外部访问
            nohup 服务端启动命令 --host 0.0.0.0 --port 8000 > /var/log/server.log 2>&1 &
          "

      - name: 安装并运行客户端包
        run: |
          pip install 客户端包名
          # 连接映射到本机的server端口执行客户端逻辑
          客户端执行命令 --server http://127.0.0.1:8000

注意事项：exec启动服务时必须放后台运行，否则会阻塞当前步骤导致工作流卡住；服务必须绑定0.0.0.0地址，不能绑定容器内的127.0.0.1，否则外部请求无法接入。

方法2：使用自定义预构建镜像，省去重复安装步骤 #

如果不想每次跑工作流都重复执行apt、pip安装的耗时操作，可以直接使用预构建好的自定义镜像，替代公共基础镜像：

• 将带有Python环境、服务端Python包、启动逻辑的Dockerfile托管在仓库内
• 在工作流流程中临时执行docker build，把镜像构建到runner本地
• 手动通过docker run启动这个自定义容器即可——本质上GitHub的services功能就是帮用户自动完成了容器启动、端口映射的通用操作，手动启动的容器完全可以实现同等的连接效果，不需要依赖原生services配置。

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