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 了项目到本地后进行后续的工作。
准备
pulumi 文档的部署使用的是静态文件,因此你可以非常容易的将编译后的静态文件部署到任何服务器上。
我们经过研究后发现 pulumi 的官方使用的 AWS S3 来存储文件的。
为了能够更多的提示自动性,我们使用了 Google 的 Firebase 来进行部署。
我们使用了 Jenkins 在服务器上进行 CI。
在进行编译之前,你需要确定你的机器上安装了下面的工具:
- Go 语言编译器
- Hugo 文档工具
- Node.JS 最新稳定版
- Yarn
- Make 工具
因为 make 工具通常没有办法在 Windows 上使用,因此我们强烈建议你的编译过程放在 Linux 平台上进行。
同时 pulumi 的编译需要使用比较新版本的 NodeJs 和 Go 语言编译器,你可能需要手动配置不同的语言版本。
编译
Pulumi 的文档的编译,在 Linux 平台下面运行命令。
make build
就可以完成了。