Strapi plugin logo for Netlify Deployments

Netlify Deployments

Strapi v4 plugin to trigger, monitor and cancel a deployment on Netlify.

thumbnail for Netlify Deployments

Netlify Deployments

npm version strapi market link

Strapi v4 plugin to trigger, monitor and cancel a deployment on Netlify.

Plugin Preview

Home Page:

Plugin Home Page

Settings Page:

Plugin Settings Page

Installation

Install dependency

Run the following command in your Strapi project to install netlify-deployments:

yarn add strapi-plugin-netlify-deployments
# or
npm i -S strapi-plugin-netlify-deployments

Enable plugin configuration

Open config/plugins.js file and add the netlify-deployments entry:

module.exports = ({ env }) => ({
  "netlify-deployments": {
    enabled: true,
  },
});

Run

You can now run Strapi:

yarn develop

You should see the Netlify menu in the left panel.

N.B. You may need to run yarn build in order to see the new menu entries.

Then you can proceed with the plugin configuration.

Plugin Configuration

Config properties

Example:

module.exports = ({ env }) => ({
  "netlify-deployments": {
    enabled: true,
    config: {
      buildHook: "https://api.netlify.com/build_hooks/<hook_id>",
      accessToken: "<netlify-access-token>",
      siteId: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    },
  },
});

The plugin is reading the following configuration variables to work:

  • buildHook: Url of the build hook in Netlify.

    • You can follow this guide to create a build hook on Netlify
  • accessToken: Access token of your Netlify account used to fetch the list of deployments

    • Access tokens can be created and managed inside your user settings
  • siteId: Site ID of your Netlify site used to filter the list of deployments

    • Set the Site ID of your Netlify Site to see only the deployments you need. This can be found at Site settings > General.

Environment Configuration

You shouldn't disclose the api token and the deploy hook url for security reasons. Therefore, you shouldn't add these values to versioning in a public git repository. A suggested solution is to use environment variables. Example:

module.exports = ({ env }) => ({
  "netlify-deployments": {
    enabled: true,
    config: {
      buildHook: process.env.NETLIFY_DEPLOYMENTS_PLUGIN_BUILD_HOOK,
      accessToken: process.env.NETLIFY_DEPLOYMENTS_PLUGIN_ACCESS_TOKEN,
      siteId: process.env.NETLIFY_DEPLOYMENTS_PLUGIN_SITE_ID
    },
  },
});

Local development

For local development, you can add the config properties in your .env file:

NETLIFY_DEPLOYMENTS_PLUGIN_BUILD_HOOK="https://api.netlify.com/build_hooks/xxxxxxxxxxxxxxxxxxxxxxxx"
NETLIFY_DEPLOYMENTS_PLUGIN_ACCESS_TOKEN="<netlify-access-token>"
NETLIFY_DEPLOYMENTS_PLUGIN_SITE_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Server

You can save these values as process env variable on your server (e.g. this guide is for Heroku).

Credits

Thanks to gianlucaparadise for making strapi-plugin-vercel-deploy which this heavily built from.

Install now

npm install strapi-plugin-netlify-deployments

Last updated

104 days ago

Strapi Version

4.0 and above

Author

github profile image for Jarrett Lusso
Jarrett Lusso

Useful links

Create your own plugin

Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.