介绍
在开发网站或应用时,我们通常会用到静态网站生成器。其中,Wintersmith 是一个简单易用的静态网站生成器,它基于 Node.js,可以使用 Markdown 和 Jade 等语言来编写网页和文章。
然而,如果你希望将生成的静态网站部署到 Google App Engine 上,则需要使用 npm 包 wintersmith-appengine。该包包含了一个 Wintersmith 插件,可以将你生成的站点打包成一个可以在 Google App Engine 上运行的 App。
本文将详细介绍如何使用 npm 包 wintersmith-appengine,让你可以方便快速地将你的静态网站部署到 Google App Engine,并享受其高效稳定的服务。
前置条件
Node.js 和 npm 包管理器已经安装。如果你还没有安装,可以从 Node.js 官网 下载并安装。
你需要有一个 Google Cloud 账号,并且已经创建好了一个项目。如果你还没有,请前往 Google Cloud Console 创建一个。
你需要在 Google Cloud Console 中启用 App Engine API。可以在 "API 和服务" -> "仪表盘" 页面中搜索 "App Engine Admin API" 并启用。
你需要在本地安装 Google Cloud SDK,并完成初始化和授权。可以参考 Google 的官方文档进行安装和初始化。
安装
使用 npm 包管理器安装 wintersmith-appengine:
npm install wintersmith-appengine --save-dev
配置
在 Wintersmith 的配置文件(一般为 config.json
)中添加以下内容:
-- -------------------- ---- ------- ---------- - ----------------------- -- ------------ - ------------ ------------------ ------------ ------------------ ---------- - ----------- ------------ - -展开代码
其中,projectId
和 versionId
分别为你在 Google Cloud Console 中创建的项目 ID 和版本号。envVars
中可以定义运行时环境变量,这里我们设定了 NODE_ENV
为 production
。
打包
使用 Wintersmith 生成你的静态网站:
wintersmith build
然后,运行以下命令,将你的静态网站打包成可以在 Google App Engine 上运行的 App:
gcloud app deploy
如果一切顺利,你的静态网站应该已经成功部署到了 Google App Engine 上了。
示例代码
以下是一个简单的示例,在本地生成一个包含了一篇文章的静态网站,并将其部署到 Google App Engine 上。
首先,在本地创建一个空的目录,并进入该目录:
mkdir mywebsite
cd mywebsite
然后,创建一个简单的 Wintersmith 的配置文件 config.json
:
-- -------------------- ---- ------- - --------- - -------- --- -------- -- ---------- - ---------------------- -- ------------ - ------------ ------------------ ------------ ------------------ ---------- - ----------- ------------ - - -展开代码
在该配置文件中,我们使用了 wintersmith-markdown 插件来支持 Markdown 语法的文章。
接下来,创建一个 Markdown 文件 blog/index.md
,其中包含了一篇文章:
--- title: My First Article date: 2020-12-01 --- Hello, world! This is my first article.
然后,安装 wintersmith-appengine 包:
npm install wintersmith-appengine --save-dev
现在,运行以下命令,生成静态网站:
wintersmith build
你应该可以看到如下输出:
$ wintersmith build building... running locals... processing index... processing blog/index... writing index/index.html... writing blog/index.html... done.
最后,运行以下命令,将你的静态网站打包成可以在 Google App Engine 上运行的 App:
gcloud app deploy
如果一切顺利,你的静态网站应该已经成功部署到了 Google App Engine 上了。
结论
使用 wintersmith-appengine,将静态网站部署到 Google App Engine 变得十分简单。我们只需要简单的配置和几个命令,即可轻松实现部署和管理静态网站。希望本文能对你有所帮助,愉快的部署吧!
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6006710f8dd3466f61ffe23c