mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-23 06:05:11 +00:00
docs: improve netlify deployment (#4499)
Co-authored-by: Daniel Roe <daniel@roe.dev> Co-authored-by: Damian <48835293+DamianGlowala@users.noreply.github.com> Co-authored-by: pooya parsa <pyapar@gmail.com>
This commit is contained in:
parent
163b74f3f6
commit
4fe97389b6
@ -8,26 +8,34 @@ How to deploy Nuxt to [Netlify](https://www.netlify.com/).
|
|||||||
|
|
||||||
::list
|
::list
|
||||||
|
|
||||||
- Support for serverless SSR build
|
- Support for serverless SSR using Netlify Functions and Edge
|
||||||
- Auto-detected when deploying
|
- Auto-detected when deploying
|
||||||
- No configuration required
|
- No configuration required
|
||||||
|
|
||||||
::
|
::
|
||||||
|
|
||||||
## Setup
|
## Setup
|
||||||
|
|
||||||
Nitro will auto-detect that you are in a [Netlify](https://www.netlify.com) environment and build the correct version of your Nuxt server. For new sites, Netlify will detect that you are using Nuxt 3 or bridge and set the publish directory to `dist` and build command to `npm run build`. If you are upgrading an existing site you should check these and update them if needed.
|
Normally, the deployment to Netlify does not require any configuration. Nuxt will auto-detect that you are in a [Netlify](https://www.netlify.com) build environment and build the correct version of your Nuxt server. For new sites, Netlify will detect that you are using Nuxt and set the publish directory to `dist` and build command to `npm run build`. If you are upgrading an existing site, you should check these and update them if needed.
|
||||||
|
|
||||||
Normally, the deployment to Netlify does not require any configuration.
|
To trigger a deploy, just push to your git repository [as you would normally do for Netlify](https://docs.netlify.com/configure-builds/get-started/).
|
||||||
However, if you want to add custom redirects, you can do so by adding a [`_redirects`](https://docs.netlify.com/routing/redirects/#syntax-for-the-redirects-file) file in the [`public`](/guide/directory-structure/public) directory.
|
|
||||||
|
|
||||||
## Deployment
|
By default, Nuxt will server-render each page on server hit using [Netlify Functions](https://docs.netlify.com/functions/overview/). You can optionaly configure deployment to use [Netlify Edge Functions](https://docs.netlify.com/netlify-labs/experimental-features/edge-functions/) or [Netlify On-demand Builders](https://docs.netlify.com/configure-builds/on-demand-builders/).
|
||||||
|
|
||||||
Just push to your git repository [as you would normally do for Netlify](https://docs.netlify.com/configure-builds/get-started/).
|
## Netlify Edge Functions
|
||||||
|
|
||||||
## Deploy to Netlify Edge
|
[Netlify Edge Functions](https://docs.netlify.com/netlify-labs/experimental-features/edge-functions/) use [Deno](https://deno.land) and the powerful V8 JavaScript runtime to let you run globally distributed functions for the fastest possible response times. Nuxt output can directly run the server at the edge - closer to your users!
|
||||||
|
|
||||||
By setting `NITRO_PRESET` environement variable to `netlify_edge` you can use [Netlify Edge Functions](https://docs.netlify.com/netlify-labs/experimental-features/edge-functions/) to render Nuxt app!
|
Read more in the [Netlify Edge Functions announcement](https://www.netlify.com/blog/announcing-serverless-compute-with-edge-functions).
|
||||||
|
|
||||||
## Learn more
|
## On-demand Builders
|
||||||
|
|
||||||
|
[Netlify On-demand Builders](https://docs.netlify.com/configure-builds/on-demand-builders/) are serverless functions used to generate web content as needed that’s automatically cached on Netlify’s Edge CDN. They enable you to build pages for your site when a user visits them for the first time and then cache them at the edge for subsequent visits (also known as Incremental Static Regeneration).
|
||||||
|
|
||||||
|
## Custom Redirects
|
||||||
|
|
||||||
|
If you want to add custom redirects, you can do so by adding a [`_redirects`](https://docs.netlify.com/routing/redirects/#syntax-for-the-redirects-file) file in the [`public`](/guide/directory-structure/public) directory.
|
||||||
|
|
||||||
|
## Learn More
|
||||||
|
|
||||||
:ReadMore{link="https://nitro.unjs.io/deploy/providers/netlify.html" title="the Nitro documentation for Netlify deployment"}
|
:ReadMore{link="https://nitro.unjs.io/deploy/providers/netlify.html" title="the Nitro documentation for Netlify deployment"}
|
||||||
|
Loading…
Reference in New Issue
Block a user