@pageproof/azure-functions-webpack-plugin

@pageproof/azure-functions-webpack-plugin

This plugin makes it simple to create Azure Function Apps using webpack. It automatically emits files that can be easily deployed as an Azure Function App.

This plugin was inspired by funcpack - which is no longer maintained.

Requirements

This plugin requires a minimum of Node v6 and Webpack v4.

Getting Started

To begin, you'll need to install @pageproof/azure-functions-webpack-plugin:

$ npm install --save-dev @pageproof/azure-functions-webpack-plugin

Then add the plugin to your webpack config. For example:

webpack.config.js

const AzureFunctionsWebpackPlugin = require('@pageproof/azure-functions-webpack-plugin');

module.exports = {
  entry: './src',
  plugins: [
    new AzureFunctionsWebpackPlugin(),
  ],
};

Pay attention to the entry option; this option must point to a folder that contains your functions. Your functions can be located any number of levels deep (the plugin simply looks for function.json files) - this way you have full control over your folder structure.

The plugin will automatically copy across your function app's host.json, proxies.json and extensions.csproj files to the output directory. Make sure these files are placed within the same folder as your webpack.config.js file.

When you run webpack with the mode set to development, your local.settings.json file will also be copied to the output directory.

After you run webpack, the output directory will include your main bundle (containing all of your functions), all of your Azure Function App configuration files, and multiple directories containing your function definitions.

$ webpack --mode production

Hash: 20d0a0214bb589326486
Version: webpack 4.27.1
Time: 119ms
Built at: 12/08/2018 9:09:31 PM
                   Asset       Size  Chunks             Chunk Names
HelloWorld/function.json  285 bytes          [emitted]
               host.json   23 bytes          [emitted]
                 main.js   1.09 KiB       0  [emitted]  main
Entrypoint main = main.js
[0] ./src/index.js 294 bytes {0} [built]
[1] ./src/HelloWorld/index.js 106 bytes {0} [built]

Known problems

• Your functions are scanned when the plugin is initialized, so if you're running webpack in watch mode, you will need to remember to restart webpack every time you add a new function.

Examples

You can take a look at the examples folder for examples.

Special thanks

This plugin could not have been made without the work of the people who maintain these amazing plugins;

• copy-webpack-plugin
• virtual-module-webpack-plugin

License

MIT