Skip to content

Latest commit

 

History

History
88 lines (63 loc) · 3.25 KB

README_CN.md

File metadata and controls

88 lines (63 loc) · 3.25 KB

vite-plugin-ali-oss

license downloads npm stars

将项目中打包后生产文件上传到 Ali OSS,除了 html 以外

功能特性

  • 默认跳过已存在的文件(不会下载文件),加快上传速度
  • 几乎零配置,使用 vite outDir 路径,上传到 oss 的相同路径中

备注:除了所有 html 文件以外,上传所有文件。因为 html 文件没有哈希值,且通常放在服务器上

效果预览:

preview

安装

适用 vite 5 的 ESM 版本:

npm i -D vite-plugin-ali-oss@latest

其它情况请安装 v1 版本:

npm i -D vite-plugin-ali-oss@^1.0.0

# 基本使用

1. 在 vite.config.js 中注册本插件
2. 设置 base 开发或生产环境服务的公共基础 ***URL*** 路径

```javascript
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import vitePluginAliOss from 'vite-plugin-ali-oss'

const options = {
  region: '<Your Region>'
  accessKeyId: '<Your Access Key ID>',
  accessKeySecret: '<Your Access Key Secret>',
  bucket: '<Your Bucket>'
}

const prod = process.env.NODE_ENV === 'production'

// https://vitejs.dev/config/
export default defineConfig({
  base: prod ? 'https://foo.com/' : '/', // 打包时必须是 URL
  plugins: [vue(), vitePluginAliOss(options)]
})

上传到 oss 特定目录下,只要直接设置 base:

base: prod ? 'https://foo.com/yourpath/etc/' : '/'
  1. 打包发布生产代码
pnpm run build

插件将会在打包完成后,上传 vite 配置 outDir 路径下的所有资源文件。

配置项

options description type default
region 阿里云 oss 地域 string
accessKeyId 阿里云 oss 访问 ID string
accessKeySecret 阿里云 oss 访问密钥 string
bucket 阿里云 oss 存储空间名称 string
overwrite 如果文件已存在,是否覆盖 boolean false
ignore 文件忽略规则。如果你使用空字符串 '',将不会忽略任何文件 boolean '**/*.html'
headers 请求头设置,详细信息请见 https://www.alibabacloud.com/help/zh/doc-detail/31978.html object {}
test 仅测试路径,不会有文件上传 boolean false
enabled 是否启用本插件 boolean true
... 其他初始化 oss 的参数,详细信息请见 https://www.alibabacloud.com/help/zh/doc-detail/64097.html any