如何将通过docusaurus build构建的Docusaurus网站部署至Google App Engine？

前提 #

已通过docusaurus build（或npm run build）生成build目录下的生产环境静态文件。

步骤1：创建GAE配置文件 #

在项目根目录新建app.yaml文件，写入以下配置：

runtime: python39
handlers:
  - url: /
    static_files: build/index.html
    upload: build/index.html
  - url: /(.*)
    static_files: build/\1
    upload: build/(.*)

该配置会将所有请求映射到build目录下的对应静态文件，同时适配Docusaurus的单页应用路由逻辑，将非根路径请求转发到index.html，由前端路由处理。

步骤2：配置Google Cloud CLI #

• 确保本地已安装Google Cloud SDK（gcloud CLI）。
• 登录Google Cloud账号：

  gcloud auth login
  

• 设置默认GAE项目ID（替换为你的实际项目ID）：

  gcloud config set project YOUR_PROJECT_ID
  

步骤3：执行部署 #

在项目根目录运行部署命令：

gcloud app deploy

部署完成后，终端会输出网站访问地址，也可通过以下命令直接打开网站：

gcloud app browse

额外注意事项 #

• 若出现静态资源加载失败，检查app.yaml中的路径是否与build目录结构匹配。
• 如需自定义域名，登录Google Cloud控制台，进入App Engine的「设置」页面配置域名映射即可。

内容的提问来源于stack exchange，提问作者Tzach