dbt 的内置文档对于跟踪数据沿袭、数据字典、业务规则等非常有用。但是事实证明,在不使用 dbt Cloud 的情况下以安全的方式将这些文档发布到中心位置并不是那么简单。
与许多企业一样,我们使用 Confluence 进行项目跟踪和文档记录。将所有文档集中在一个地方对于技术和业务用户来说都是有益的。以前有人在 Confluence 中嵌入过 dbt 文档吗?有现成的插件吗?
最好的状态是拥有一些 CI,它可以自动使嵌入的 dbt 文档保持最新,但这只是一小步。
我在 Confluence 支持页面上找到了这个,其中讨论了使用 Confluence 提供静态内容: https://confluence.atlassian.com/confkb/how-to-use-confluence-to-serve-static-content-677282407.html
但我不想乱搞后端 Confluence 服务器的事情。这有点超出我的专业领域。
希望这可以帮助其他人获得更好的答案,但简单的答案是“不容易”。
peter_hanssens 详细记录了直接 netlify + 密码保护的示例: 将 dbt 文档发布到 Netlify
但是,如果您想要更强大的东西,我强烈建议您遵循此部署 CI/CD 管道,该管道会在更改后自动加载更新的文档,并使用 AWS cognito 进行用户管理: 如何托管 dbt 文档
除此之外,我的想法是这样的:
dbt docs generate
命令的 outputs开始 (
index.html
+ catalog.json
)