/webpack-deploy-plugin

The webpack plugin handles various uploads of front-end files

Primary LanguageTypeScript

webpack-deploy-plugin

npm test

The plugin currently only supports rsync and oss-upload-tool. If it is rsync, you need to confirm whether the environment supports rsync.

Install

Using npm:

npm install @planjs/webpack-deploy-plugin --save-dev

Usage

webpack.Stats All output content will be uploaded to the server, or oss. webpack.config.js

const WebpackDeployPlugin = require('@planjs/webpack-deploy-plugin')

module.exports = {
    plugins: [
      new WebpackDeployPlugin({
        targets: {
          oss: {
            type: 'oss',
            // oss deploy folder
            dest: '/app/test1/',
            patterns: ['**', '!**.js.map'],
            OSSUploadOptions: {
              type: 'COS',
              COSOptions: {
                SecretId: 'xxx',
                SecretKey: 'xxx'
              },
              uploadParams: {
                Bucket: 'xxx',
                Region: 'xxx'
              }
            }
          },
          rsync: {
            type: 'rsync',
            patterns: ['**', '!**.js.map'],
            dest: 'root@xx.xx.xx.xx:/www/deploy folder'
          }
        },
        // The key of the `targets` used
        env: 'oss'
      })
    ]
};

Options

targets

Upload configuration collection.
Type: Record<any, TargetItem> | TargetItem

env

If there are multiple upload configurations, it will be switched according to this as the key.
Type: string

TargetItem

type

Type: rsync | oss
How to upload files.

dest

Upload to server folder.

type oss folder default ''
type rsync server connection string root@xx.xx.xx.xx:/www/deploy folder

Type: string

patterns

Type: string | string[] multimatch
The paths to match against will be uploaded.

rsyncOptions

Rsync args.
Type: { args: string[][] }

eg: ['bwlimit', 10] rsync

OSSUploadOptions

Type: object

Detailed reference oss-upload-tool

onUploadStart

Type: (stats: Stats) => void | Promise<void>
Before upload event.

onUploadFinish

Type: (stats: Stats) => void | Promise<void>
Upload complete event.

execUploadStartScripts

Type: string[][] | string[]
before Upload start exec script.

Detailed reference execa

execUploadFinishScripts

Type: string[][] | string[]
before Upload finish exec script.

Detailed reference execa

FQA

Window Rsync error: The command line is too long

By default, window will use 8191 as the longest length, leave 100 for other parameters, and if the remaining length is too long, it will become multiple rsync commands.
If it still fails, it may be an environment problem, change the cutting rules through the variable MAX_COMMAND_LINE_LIMIT.

License

MIT © fupengl