GitHub Codespaces 502 网关错误服务于 docfx 站点

Question

我正在努力将 GitHub 代码空间添加到 NUnit 文档存储库以进行文档编辑。我们对 Codespaces 在我们的用例中的潜力感到非常兴奋！

当前成分

• 添加代码空间的PR，里面有我们的配置文件和容器：https://github.com/nunit/docs/pull/563
• 我们从 Codespaces Dockerfile 引用的 Dockerfile 的来源：https://github.com/nunit/docfx-action/blob/master/Dockerfile

复制

• 打开代码空间
• 打开终端
• cd docs
• docfx build - 构建成功，如预期
• docfx serve - 表示它在端口 8080 上服务，正如预期的那样
• 从终端跟随 link，这会在转发的选项卡中打开端口 8080

预期行为

在 /_site 子目录的根站点中查看该站点，该子目录是 docfx 提供项目的地方

实际行为

在初始 URL 以及尝试附加 /_site 时看到 502 错误网关错误。

我尝试过的其他东西

• 我已经在我机器上的 VS Code 中提取了这个分支，并在这个容器中打开了它。我能够看到该站点在转发的 8080 端口根和附加的 /_site 上均按预期服务。

Answer 1

我想通了！感谢这条评论：https://github.com/dotnet/docfx/issues/3615#issuecomment-451664865

在这种情况下，因为 docfx 使用 WebApp.Start()，容器内的正确语法是：

docfx serve _site -n "*"

"*" 是这里的不同之处，它允许单声道适当绑定以使转发工作。