baidu-bos

1.0.6 • Public • Published

baidu-bos

npm (scoped with tag) Build Status Coverage Status

项目背景

将静态资源上传到 BOS (Baidu Object Storage,一个由百度云服务提供的 CDN 存储)

本项目的目的主要有 2 个:

  1. 原命令 edp bos 在开发中颇为方便,但随着 edp 本身的消亡,现在为了使用 edp bos 不得不安装 edp 是本末倒置的;如果你不想改变习惯了的命令参数格式,可以尝试使用 baidu-bos,它的参数格式和 edp bos 完全相同。

  2. 原命令 edp bos 对通配符的支持相当有限,基本上只支持 . 表示当前目录的所有文件,无法支持例如 package 开头的文件,目录中包含子目录的所有文件,文件和目录同时上传等需求。baidu-bos 扩展了通配符的支持,且语法和主流类库相同。

安装

npm i baidu-bos -g

重要提示

  1. 如果您是初次使用,请先使用 baidu-bos config set 命令配置 bos.ak, bos.sk 和 bos.endpoint。具体取值可以咨询百度云服务
  2. 如果您是从 edp bos 迁移而来,请使用 baidu-bos config import-from-edp 命令直接从 edp 导入配置,可以省去分别设置的麻烦
  3. 设置 bos.endpoint 时必须加上协议头,例如 http://bos.nj.bpc.baidu.com,否则可能会有网络连接的错误出现

上传文件

  • 普通上传

    使用本地的文件路径和文件名,拼接在 CDN 路径之后

    baidu-bos dir/a.js bos://<bucket>/path
    # 目标地址:<bucket>/path/dir/a.js 
  • 指定 CDN 地址

    无视本地的文件路径和文件名,指定 CDN 上的远程路径和文件名

    baidu-bos dir/b.js bos://<bucket>/path/b-2.js
    # 目标地址:<bucket>/path/b-2.js 
  • 使用通配符 (minimatch)

    使用通配符 (minimatchglob) 匹配多个文件

    baidu-bos dir/**/*.js bos://<bucket>/path
    # 上传所有 dir 目录(包括子目录) 下的 js 文件。目标 URL 维持原有的层级结构 
     
    baidu-bos pack* bos://<bucket>/path
    # 上传当前目录所有 pack 开头的文件 
  • 上传当前目录下所有文件 (快捷操作)

    将当前目录下 (包含子目录) 的所有文件上传。按照通配符的写法应当是 **,但为了简便,您可以直接写 .,效果等价。

    baidu-bos . bos://<bucket>
    # 等价于 baidu-bos ** bos://<bucket> 
  • 上传目录 (快捷操作)

    上传目录时,按照通配符的写法应当是 src/**,但为了简便,您可以省略 **,直接使用 src/

    特别地,如果目录参数 不包含 通配符,则可以省略最后的 /,直接使用 src

    baidu-bos dir bos://<bucket>/dir
    # 等价于 baidu-bos dir/** bos://<bucket> 
     
    baidu-bos user*/static/ bos://<bucket>/dir
    # 等价于 baidu-bos user*/static/** bos://<bucket>/dir 
    # 此时 static 后面的 / 不能省略! 
  • 混合使用

    上述目录参数均可以空格为间隔,混合使用。

    baidu-bos dir/a.js dir/b.js dir-2 bos://<bucket>
    # 分别上传 dir/a.js, dir/b.js 和 dir-2 目录(及子目录)的全部内容 

输出形如:

baidu-bos INFO url:     http://bos.nj.bpc.baidu.com/<bucket>/a.js

控制 Header

使用 -H 或者 --header 可以控制响应头,目前支持的参数有:

  • nocache 为上传的所有文件添加响应头 Cache-Control: 'max-age=0,nocache',提示浏览器不要缓存该文件。
  • download 为上传的所有文件添加响应头 `Content-Disposition': 'attachment; filename="[file-name]"',直接访问时可让浏览器下载该文件。

使用举例

baidu-bos dir/a.js bos://<bucket>/path -H nocache
# 上传 dir/a.js 并设置响应头,忽略缓存 
 
baidu-bos . bos://<bucket>/path -H download,nocache
# 上传当前目录下所有文件,并设置响应头,忽略缓存且使用下载处理 

配置相关

在首次使用时,您可能需要配置 bos.ak, bos.sk 和 bos.endpoint。此外,您也可能会在使用过程中切换/修改某个配置项,可以使用 baidu-bos config 命令。

  • 写入配置

    可初次写入 / 覆盖某项配置

    baidu-bos config set [key] [value]
    # 如 baidu-bos config set bos.ak 12345 
  • 读取配置

    baidu-bos config get [key]
    # 如 baidu-bos config get bos.ak 
  • 列出所有配置

    baidu-bos config list
  • 删除一项配置

    baidu-bos config remove [key]
    # 如 baidu-bos config remove bos.ak 
  • 删除全部配置

    baidu-bos config remove-all
  • 从 edp 导入配置

    baidu-bos config import-from-edp
    # 根据 edp config 的输出内容获取 bos.ak, bos.sk, bos.endpoint 并直接写入 

Readme

Keywords

Package Sidebar

Install

npm i baidu-bos

Weekly Downloads

0

Version

1.0.6

License

ISC

Unpacked Size

37.3 kB

Total Files

13

Last publish

Collaborators

  • easonyq