【问题标题】:Cannot create docs for components in backstage docker error无法在后台 docker 错误中为组件创建文档
【发布时间】:2022-11-08 06:18:41
【问题描述】:

我正在尝试在 backstage-io /docs 页面 UI 上显示由 backstage io 组件创建的存储库中存储的文档,但是当我尝试访问文档时出现以下错误

Building a newer version of this documentation failed. Error: "Failed to generate docs from C:\\Users\\Admin\\AppData\\Local\\Temp\\backstage-enprxk into C:\\Users\\Admin\\AppData\\Local\\Temp\\techdocs-tmp-W6iVab; caused by Error: Docker container returned a non-zero exit code (1)"

我的存储库中的文件

docs 文件夹只有 index.md 和 mkdocs.yml 有

nav:
    Home: index.md

【问题讨论】:

  • 我也遇到同样的错误,有解决办法吗?
  • @Sapna 我忘记在 mkdocs.yml 文件中添加 site_name,这就是我收到此错误的原因,您可以通过单击 SHOW BUILD LOGS 选项找到这种错误消息

标签: docker mkdocs backstage


【解决方案1】:

我在 Backstage 的本地 POC 上工作时遇到了类似的问题。最大的问题是我需要安装 pip、python、mkdocs 和 mkdocs-techdocs-core(即pip3 install mkdocs-techdocs-core)。如果您已经这样做了,然后遵循了所有in this documentation,那么它应该开始工作了。希望有帮助。我花了几天时间试图克服这些类型的错误。

【讨论】:

    猜你喜欢
    • 2022-11-02
    • 2019-01-26
    • 2021-05-02
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2014-09-20
    • 2016-05-21
    • 2017-04-27
    相关资源
    最近更新 更多