Pulumi 项目文档如何部署到 firebase 中

pulumi 项目的文档使用的是 hugo 来进行编译的

这篇文章主要用于记录实际的部署过程。

项目仓库

项目的原始仓库地址为:GitHub - pulumi/pulumi-hugo: A Hugo module containing content and layouts used on pulumi.com, including hand-authored docs, the Pulumi blog, and Learn Pulumi. 为了便于中文化,我们 Fork 了项目到本地后进行后续的工作。

Fork 的地址为:GitHub - iSharkFly-Docs/pulumi-hugo-cn: A Hugo module containing the Pulumi Hugo theme and website content.

准备

pulumi 文档的部署使用的是静态文件,因此你可以非常容易的将编译后的静态文件部署到任何服务器上。

我们经过研究后发现 pulumi 的官方使用的 AWS S3 来存储文件的。

为了能够更多的提示自动性,我们使用了 Google 的 Firebase 来进行部署。

我们使用了 Jenkins 在服务器上进行 CI。

在进行编译之前,你需要确定你的机器上安装了下面的工具:

  • Go 语言编译器
  • Hugo 文档工具
  • Node.JS 最新稳定版
  • Yarn
  • Make 工具

因为 make 工具通常没有办法在 Windows 上使用,因此我们强烈建议你的编译过程放在 Linux 平台上进行

同时 pulumi 的编译需要使用比较新版本的 NodeJs 和 Go 语言编译器,你可能需要手动配置不同的语言版本。

编译

Pulumi 的文档的编译,在 Linux 平台下面运行命令。

make build

就可以完成了。