Skip to content

Commit

Permalink
chore(main): release 2.0.0 (#238)
Browse files Browse the repository at this point in the history
* chore(main): release 2.0.0

* chore: update changelog

* chore: use plugin path

Co-authored-by: token-generator-app[bot] <82042599+token-generator-app[bot]@users.noreply.github.com>
Co-authored-by: Matt Kane <m@mk.gg>
  • Loading branch information
token-generator-app[bot] and ascorbic authored Jan 31, 2022
1 parent a130914 commit 0915fdc
Show file tree
Hide file tree
Showing 4 changed files with 73 additions and 3 deletions.
1 change: 1 addition & 0 deletions .github/workflows/release-please.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ jobs:
token: ${{ steps.get-token.outputs.token }}
release-type: node
package-name: '@netlify/plugin-gatsby'
path: 'plugin'
- uses: actions/checkout@v2
if: ${{ steps.release.outputs.release_created }}
- uses: actions/setup-node@v2
Expand Down
69 changes: 69 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# Changelog

## [2.0.0](https://github.com/netlify/netlify-plugin-gatsby/compare/v2.0.0-zz-beta.0...v2.0.0) (2022-01-31)

Version 2 of the Essential Gatsby build plugin adds support for the new render
modes introduced in Gatsby 4, as well as improved support for Gatsby functions.
For best results it should be installed alongside
[`gatsby-plugin-netlify`](https://github.com/netlify/gatsby-plugin-netlify/).
Beta support was available since Gatsby 4 was released, but with this stable
release it is ready for production use for everyone.

### Features

This version adds full support for the new Gatsby 4 render modes on Netlify.
Gatsby 4 introduced two render modes, alongside its original SSG mode. For a
detailed comparison of each mode
[see this blog post](https://www.netlify.com/blog/2021/09/16/run-gatsby-4-with-dsg-and-ssr-on-netlify-today/).

To support these new modes, the Essential Netlify build plugin generates three
serverless Netlify Functions that are automatically deployed alongside your
site:

- `__api`: used for Gatsby Functions
- `__dsg`: an
[on-demand builder](https://docs.netlify.com/configure-builds/on-demand-builders/)
used for DSG pages.
- `__ssr`: used for server-side rendered pages.

You do not need to configure or deploy these functions yourself: they are
automatically generated and deployed whenever you build.

You can see the logs for these functions in the "Functions" tabs in the Netlify
dashboard.

It will also generate Netlify rewrites to ensure that each route is handled by
the correct function.

### Installing

This version of the plugin will soon be installed automatically for all Gatsby
sites on Netlify. If you can't wait, you can
[install it manually](https://github.com/netlify/netlify-plugin-gatsby#installation)
using file-based plugin installation.

You should also install `gatsby-plugin-netlify` to enable all features. **It is
required if you are using SSR pages**. See
[how to install](https://github.com/netlify/netlify-plugin-gatsby#install-the-gatsby-plugin)

### Deploying your site

You do not need to do anything different to deploy your site if building on
Netlify: it will automatically deploy the functions when you build. If you are
deploying manually using the Netlify CLI, you must ensure that instead of
running `netlify build` then `netlify deploy` as separate commands, you run them
together as `netlify deploy --build`.

### Caveats

Currently you cannot use `StaticImage` or `gatsby-transformer-sharp` in SSR or
DSG pages. The best workaround is to use an image CDN such as
[Cloudinary](https://www.gatsbyjs.com/docs/how-to/images-and-media/using-cloudinary-image-service/)
or [imgix](https://github.com/imgix/gatsby) to host your images. This will give
you faster builds too.

### Feedback

If you have feedback or bug reports, join
[the discussion](https://github.com/netlify/netlify-plugin-gatsby/discussions)
or [open an issue](https://github.com/netlify/netlify-plugin-gatsby/issues)
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "netlify-plugin-gatsby",
"version": "1.0.0",
"version": "2.0.0",
"description": "Netlify Build plugin gatsby - Run Gatsby seamlessly on Netlify.",
"directories": {
"test": "test"
Expand Down

0 comments on commit 0915fdc

Please sign in to comment.