如何让GitHub Docker容器Action的端口对后续工作流可访问？

问题根源 #

你遇到的核心问题是：当使用using: docker类型的GitHub Action时，docker-compose命令是在独立的Action容器内执行的，这个容器的Docker环境与GitHub Runner主机的Docker环境完全隔离。ChromaDB服务实际运行在Action容器内部的Docker实例中，而非Runner主机的Docker环境，因此后续工作流步骤访问Runner的localhost:8000自然无法连接到服务。

解决方案 #

方法1：使用Composite Run Steps Action（推荐） #

直接在Runner主机环境中执行docker-compose命令，和你最初直接在工作流中运行的逻辑完全一致，避免容器隔离问题。

创建如下action.yml：

name: 'ChromaDB'
description: 'Instantiates a chroma database server'
runs:
  using: "composite"
  steps:
    - name: Start ChromaDB via Docker Compose
      shell: bash
      run: docker-compose up -d
      working-directory: ${{ github.action_path }}  # 若docker-compose.yml在Action目录下，需指定工作目录

在工作流中调用该Action：

- name: Checkout repository
  uses: actions/checkout@v4

- name: Launch ChromaDB
  uses: ./path-to-your-action-directory  # 替换为你的本地Action目录路径

- name: Wait for server to be ready
  run: |
    while ! curl -s http://localhost:8000 > /dev/null; do
      echo "Waiting for server..."
      sleep 5
    done

- name: Verify server is running
  run: curl http://localhost:8000

方法2：修改Docker Action，共享Runner的Docker套接字 #

如果坚持使用Docker类型的Action，需要将Runner主机的Docker套接字挂载到Action容器中，让Action容器内的docker-compose操作Runner主机的Docker环境，从而将ChromaDB端口映射到Runner的localhost。

修改后的action.yml：

name: 'ChromaDB'
description: 'Instantiates a chroma database server'
runs:
  using: 'docker'
  image: 'docker/compose:1.29.2'
  entrypoint: docker-compose
  args:
    - up
    - -d
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock  # 共享Runner的Docker守护进程套接字
    - ${{ github.action_path }}:/workspace  # 挂载Action目录到容器工作目录，确保能读取docker-compose.yml
  working-directory: /workspace

注意：确保你的docker-compose.yml中已配置端口映射8000:8000，否则即使共享套接字，端口也不会暴露到Runner主机。

关键验证点 #

无论使用哪种方法，都需要确认：

• docker-compose.yml包含正确的端口映射：ports: ["8000:8000"]
• Runner主机已预装Docker和Docker Compose（GitHub官方ubuntu-latest镜像默认已包含）

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