如何构建 next.js 项目并将其手动部署到 Netlify？

Question

According to the docs, Netlify supports next.js through the Essential Build Plugin and manual deployments through a CLI command , but how can I use the two together to build a next.js project in my own CI and deploy only the build output to Netlify?

插件页面提到了“链接”，即它假设项目是通过 Git 存储库连接并由 netlify 构建的，而不是由我自己的 CI 在本地构建的。

Answer 1

OK，终于搞定了。 将其包装起来以防其他人发现它有用：

• 安装包netlify-cli和@netlify/plugin-nextjs
• 如插件 README 的本节所述，在项目根目录中创建netlify.toml （确保具有publish和functions的路径；服务器端渲染和 API 处理程序需要functions ；这两个目录将用于构建 output构建）
• 如果使用 Git，请将路径和.netlify （另一个“临时”目录）添加到.gitignore以从您的存储库中排除构建 output
• 重要（ 在以前/过时的 next-on-netlify 项目的文档中找到信息，没有这个就无法部署）：将target: "experimental-serverless-trace"添加到next.config.js
• 初始设置： netlify login到您的帐户，运行netlify deploy --build一次，选择一个站点名称
• 如果要在 CI 中运行部署，请配置环境变量NETLIFY_AUTH_TOKEN （带有来自 Netlify UI 的“个人访问令牌”）和NETLIFY_SITE_ID （在选择名称并成功完成第一次成功部署后显示在 Netlify UI 中）以绕过以后登录和选址

Answer 2

安装netlify-cli和@netlify/plugin-nextjs

yarn add -D @netlify/plugin-nextjs
yarn add -D @netlify/plugin-nextjs

---

设置netlify.toml文件

[[plugins]]
package = "@netlify/plugin-nextjs"

[build]
command = "yarn next build"
publish = ".next"

---

配置NETLIFY_AUTH_TOKEN和NETLIFY_SITE_ID环境变量

在个人访问令牌的 Netlify 用户设置中手动生成访问令牌。 这也可以通过命令行来完成。 在终端设置或持续集成 (CI) 工具的 UI 中将令牌保存为NETLIFY_AUTH_TOKEN环境变量。

站点 ID 在 Netlify UI 中找到：Go 到站点设置 > 常规 > 站点详细信息 > 站点信息，然后复制API ID的值，将 ID 分配给NETLIFY_SITE_ID环境变量。

这也可以通过netlify link命令来完成。

---

构建 Next.js 应用程序并将其部署到 Netlify

可以通过以下命令部署到生产环境：

netlify deploy --build --prod

---

---

文档

• https://docs.netlify.com/configure-builds/file-based-configuration/
• https://github.com/netlify/netlify-plugin-nextjs
• https://docs.netlify.com/cli/get-started/#run-builds-locally
• https://docs.netlify.com/cli/get-started/#manual-deploys

更长的文章

https://paulonteri.com/thoughts/deploy-nextjs-to-netlify-manually