npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

webpack-alioss-plugin

v2.4.2

Published

Ali oss-webpack auto upload files plugin

Downloads

384

Readme

webpack-alioss-plugin

Travis CI node version 更新记录 测试报告 eslint 报告

阿里云 OSS 上传插件, 可在 webpack 打包结束后将来 webpack 生成的文件自动上传到 OSS 中。

支持 webpack 3、4、5

特色

  • 上传文件后, 可删除该文件(默认开启) - 避免将无用文件上传至服务器
  • 上传失败后自动重试 (默认重试3次)
  • gzip 压缩后再上传 (默认开启)
    • CDN 全局 gzip 是否开启不影响该功能 - 若上传的文件的 header 设置为 gzip, 则 CDN 不会再次对该文件进行 gzip 压缩
  • 上传前添加检测机制
    • 若已存在, 则可不重复上传
    • 对于类似 abc.js 这种不带 hash 值的文件, 可通过 existCheck: false 来取消该功能

最佳实践:

  • 将 webpack 生成的所有文件 (除了 html、mainfest 文件外) 自动上传至 OSS 中, 并通过阿里 CDN 来访问上传的文件
  • webpack 自动生成的 jscss 文件设置 hash 值, eg: detail-question.34d71b4.js
  • CDN 可设置为允许使用缓存, 提高加载速度
  • 个人服务器或企业服务器只发布 html 文件
  • 体积较小的图片(300KB 以下)直接使用 webpack 的 url-loader 自动打包到 js 文件中(base64)
  • 体积较大的图片(300KB 以上)手动上传至 OSS 中, 或通过服务端接口自动上传至 OSS
  • OSS 安全: 使用阿里推荐的访问控制 ACL 来限制某个 accessKey 只能访问指定文件夹

安装

npm install -D webpack-alioss-plugin

使用示例

注意: 需修改 webpackConfig.output.publicPathprefix oss 路径对应的访问 url, eg: '//res.xueboren.com/auto_upload_ci/your-project-name/'

用法一: 结合环境变量 (推荐)

// 先在 CI 的构建环境中设置以下环境变量:

// WEBPACK_ALIOSS_PLUGIN_ACCESS_KEY_ID 对应配置项 accessKeyId
// WEBPACK_ALIOSS_PLUGIN_ACCESS_KEY_SECRET 对应配置项 accessKeySecret
// WEBPACK_ALIOSS_PLUGIN_BUCKET 对应配置项 bucket
// WEBPACK_ALIOSS_PLUGIN_REGION 对应配置项 region
// (可选, 默认为 'auto_upload_ci') WEBPACK_ALIOSS_PLUGIN_OSS_BASE_DIR 对应配置项 ossBaseDir

const AliOSSPlugin = require('webpack-alioss-plugin')

webpackConfig.plugins.push(new AliOSSPlugin())

用法二: 设置配置项

const AliOSSPlugin = require('webpack-alioss-plugin')

webpackConfig.plugins.push(new AliOSSPlugin({
  auth: {
    accessKeyId: '', // 在阿里 OSS 控制台获取
    accessKeySecret: '', // 在阿里 OSS 控制台获取
    region: 'oss-cn-hangzhou', // OSS 服务节点, 示例: oss-cn-hangzhou
    bucket: 'abc', // OSS 存储空间, 在阿里 OSS 控制台获取
  },
  ossBaseDir: 'auto_upload_ci',
  project: 'my-project-name', // 项目名(用于存放文件的直接目录)
}))

使用示例 - vue.config.js 示例

const WebpackAliossPlugin = require('webpack-alioss-plugin');

const isProduction = process.env.NODE_ENV === 'production';

module.exports = {
  publicPath: isProduction ? '//res.xueboren.com/auto_upload_ci/your-project-name/' : '',
  configureWebpack: {
    plugins: isProduction ? [
      new WebpackAliossPlugin(),
    ] : [],
  },
};

参数说明

为了防止 OSS 的 accessKey 及 accessKeySecret 被提交到代码仓库, 本插件提供了环境变量的支持, 所有参数及其环境变量对应关系参考下表。 构建函数中的参数优先级大于环境变量

参数列表如下所示:

构造参数 | 环境变量 | 默认值 | 说明 | --- | --- | --- | --- | accessKeyId | WEBPACK_ALIOSS_PLUGIN_ACCESS_KEY_ID | 空 | OSS 访问 key | accessKeySecret | WEBPACK_ALIOSS_PLUGIN_ACCESS_KEY_SECRET | 空 | OSS 访问 secret | bucket | WEBPACK_ALIOSS_PLUGIN_BUCKET | 空 | OSS 存储空间 | region | WEBPACK_ALIOSS_PLUGIN_REGION | 空 | OSS 服务节点 | exclude | - | /.*\.html$/ | 即匹配该正则的文件名 不会被上传到 OSS | retry | - | 3 | 上传失败后重试次数, 0 代表不重试 | gzip | - | true | 是否在上传前进行 gzip 压缩 | existCheck | - | true | 上传前是否先检测已存在(已存在则不重复上传, 不存在才进行上传) | enableLog | WEBPACK_ALIOSS_PLUGIN_ENABLE_LOG | false | 是否输出详细的日志信息 | ignoreError | WEBPACK_ALIOSS_PLUGIN_IGNORE_ERROR | false | 上传过程中出现错误是否继续 webpack 构建 | removeMode | WEBPACK_ALIOSS_PLUGIN_REMOVE_MODE | true | 生成的文件自动上传至 OSS 后, 是否删除本地的对应文件 | ~~prefix~~(已弃用) | ~~WEBPACK_ALIOSS_PLUGIN_PREFIX~~ | ~~false~~ | ~~目录前缀, 文件会上传到该指定目录下, 请确保 accessKey 有该目录的写权限~~ | ossBaseDir | WEBPACK_ALIOSS_PLUGIN_OSS_BASE_DIR | auto_upload_ci | OSS 中存放上传文件的一级目录名 | project | - | 默认会自动读取 package.json 中的 name | OSS 中存放上传文件的二级目录, 一般为项目名 | options | - | undefined | 对象类型. 可用于设置文件的请求头、超时时间等 | envPrefix | - | '' | 字符串类型. 环境变量key的前缀(针对所有相关的环境变量) |

  • ~~prefix~~: ~~出于安全考虑推荐不使用根目录, 只给该 accessKey 赋予某个子文件夹的权限~~
  • ignoreError: 如果上传过程中出现错误是否继续 webpack 构建
    • true: 忽略错误, 继续构建, webpack 不会报错
    • false: 中止构建, webpack 构建会以失败结束
  • removeMode: 生成的文件自动上传至 OSS 后, 是否删除本地的对应文件
    • true: 删除 (默认删除)
    • false: 不删除