将开发代理服务器与 GitHub Actions 配合使用

概览
目标: 在 GitHub Actions 中使用开发代理
时间: 15 分钟
插件: 各种
先决条件:设置开发代理、GitHub 存储库

若要将 Dev Proxy 集成到 GitHub Actions 工作流中,请使用 Dev Proxy Actions

在 GitHub Actions 工作流中设置开发代理

若要安装和启动 Dev Proxy,请使用setup操作。

- name: Setup Dev Proxy
  uses: dev-proxy-tools/actions/setup@v1

在录制模式下安装并启动 Dev Proxy

若要在录制模式下启动开发代理,请将 auto-record 输入设置为 true。 此配置允许开发代理捕获请求和响应,以便进一步处理。

- name: Start Dev Proxy
  uses: dev-proxy-tools/actions/start@v1
  with:
    auto-record: true

使用特定配置文件安装和启动开发代理

默认情况下,使用 devproxyrc.json默认开发代理配置文件。 若要使用特定的开发代理配置文件,请将 config-file 输入设置为配置文件的路径。

- name: Start Dev Proxy with config
  uses: dev-proxy-tools/actions/start@v1
  with:
    config-file: .devproxy/my-config.json

使用自定义日志文件安装和启动开发代理

默认情况下,开发代理输出记录到工作目录中devproxy.log文件。 若要指定自定义日志文件,请设置 log-file 输入。

- name: Start Dev Proxy with custom log file
  uses: dev-proxy-tools/actions/start@v1
  with:
    log-file: .devproxy/custom-devproxy.log

安装特定版本的Dev Proxy

默认情况下,该setup操作将安装最新版本的Dev Proxy。 如果要安装特定版本,可以指定 version 输入。

- name: Setup Dev Proxy with specific version
  uses: dev-proxy-tools/actions/setup@v1
  with:
    version: 0.29.2

仅安装开发代理

若要安装开发代理而不启动它,请将 auto-start 输入设置为 false

- name: Install Dev Proxy
  uses: dev-proxy-tools/actions/setup@v1
  with:
    auto-start: false

手动启动开发代理

若要在安装后手动启动开发代理,请使用 start 操作。

- name: Start Dev Proxy manually
  uses: dev-proxy-tools/actions/start@v1

start 操作的行为与 setup 操作类似,但不能用于安装开发代理。 它与version操作共享相同的输入和输出(除setup外)。

禁止自动停止开发代理

默认情况下,作业完成后,setupstart 操作会自动停止开发代理程序。 若要在作业完成后禁止自动停止开发代理,请将 auto-stop 输入设置为 false

- name: Setup Dev Proxy without auto-stop
  uses: dev-proxy-tools/actions/setup@v1
  with:
    auto-stop: false

手动停止开发代理

如果要手动停止开发代理程序,请使用该 stop 命令。 如果要生成报表并将其上传为工件,或者使用不同的配置运行Dev Proxy,此操作非常有用。

- name: Stop Dev Proxy manually
  uses: dev-proxy-tools/actions/stop@v1

- name: Upload Dev Proxy reports
  uses: actions/upload-artifact@v4
  with:
    name: Reports
    path: ./*Reporter*

手动开始录制

要手动开始录制,请使用start操作,并将auto-record设置为true

- name: Start Dev Proxy in recording mode
  uses: dev-proxy-tools/actions/record-start@v1

手动停止录制

若要手动停止录制,请使用 record-stop 操作。

- name: Stop recording
  uses: dev-proxy-tools/actions/record-stop@v1

获取正在运行的开发代理实例的 URL

若要获取正在运行的开发代理实例的 URL,请使用 proxy-urlsetup 操作的 start 输出。 使用 steps.<step_id>.outputs.proxy-url 语法,其中 <step_id> 是该步骤运行动作的 ID。

- name: Setup Dev Proxy
  id: setup-devproxy
  uses: dev-proxy-tools/actions/setup@v1

- name: Get Dev Proxy URL
  run: echo "Dev Proxy URL: ${{ steps.setup-devproxy.outputs.proxy-url }}"

获取开发代理 API 的 URL

若要获取开发代理 API 的 URL,请使用 api-urlsetup 操作产生的 start 输出。 使用 steps.<step_id>.outputs.api-url 语法,其中 <step_id> 是该步骤运行动作的 ID。

- name: Setup Dev Proxy
  id: setup-devproxy
  uses: dev-proxy-tools/actions/setup@v1

- name: Get Dev Proxy API URL
  run: echo "Dev Proxy API URL: ${{ steps.setup-devproxy.outputs.api-url }}"

另请参阅