netlify

使用netlifyCLI 来创建项目（“站点”）、链接本地文件夹，并配置来自 GitHub 的 CI/CD。

前提条件

• netlify --version
• 已登录（netlify login）或提供--auth $NETLIFY_AUTH_TOKEN。
• 了解您想要在其下创建站点的 Netlify 团队/账户 slug（可选但推荐）。

有用的检查：

netlify status
netlify sites:list

Monorepo 模式（推荐）

对于一个包含多个站点的仓库（例如：sites/seattlecustomboatparts.com、sites/floridacustomerboatparts.com）：

• 创建每个域名对应一个 Netlify 站点.
• 将站点的基础目录设置为该子文件夹。
• 在该子文件夹内放置一个netlify.toml 文件.

这使得每个域名的构建配置自成一体。

Hugo 子文件夹netlify.toml

创建sites/<域名>/netlify.toml：

[build]
  command = "hugo --minify"
  publish = "public"

[build.environment]
  HUGO_VERSION = "0.155.1"

（根据需求调整 HUGO_VERSION。）

快速工作流程：创建 + 关联 + 初始化 CI/CD

1) 创建一个 Netlify 站点（项目）

在你要部署的站点文件夹（基础目录）内运行：

cd sites/<domain>
netlify sites:create --name <netlify-site-name> --account-slug <team> --with-ci

备注：

• --with-ci启动 CI 钩子设置。
• 如果需要手动控制，请添加--manual2) 将本地文件夹链接至已创建的站点

若尚未链接：

3) 连接GitHub以实现持续部署

netlify link

此步骤通常为交互式操作（选择Git远程仓库/代码库 + 构建设置）。为实现自动化，我们可以预先创建

netlify init

netlify.toml文件并采用默认配置。环境变量

设置站点专属变量：

适用于单体仓库：

netlify env:set VAR_NAME value
netlify env:list

CONTACT_EMAIL

• （或其他共享配置）部署

手动部署（便于快速预览）：

包含脚本

netlify deploy            # draft deploy
netlify deploy --prod     # production deploy

scripts/hugo_netlify_toml.sh

• ：在Hugo子文件夹中创建netlify.toml配置文件scripts/netlify_monorepo_site.sh
• ：用于为子文件夹创建/链接/初始化站点的辅助脚本使用脚本时，建议通过参数传递

When using scripts, prefer passingNETLIFY_AUTH_TOKEN通过环境变量用于非交互式运行。