1. 安装CLI管理工具
本节介绍如何安装CLI管理工具。
1.1. 安装方式说明
- 支持按步骤安装和一键安装两种方式。一键安装将依赖环境和CLI工具包整合成一个安装文件，通过一键执行的方式完成安装。目前一键安装支持的操作系统有限，请根据实际需要选择适合自己的安装方式。
1.2. 按步骤安装
1.2.1. 前提条件
- Python 2.6+ ；pip工具已安装。安装命令行工具前，请确保您的系统已经安装了满足版本要求的Python环境和pip工具。
支持的操作系统
- CentOS版本7.0及以上
- Ubuntu版本14.0及以上
- Windows
- MacOS
版本更新记录
新的版本包含更多更全面的功能及bug-fix，建议保持CLI持续更新，当前版本为1.3.0。
| 版本 | 更新内容 | 发布日期 |
|---|---|---|
| 1.3.0 | 新增归档存储类型： 1、创建/列举/删除Archive Bucket 2、上传/解冻/下载Archive Object 3、转换Object存储类型 4、生命周期管理支持存储类型转换 |
2021-09-18 |
| 1.2.0 | 新增管理子账号功能： 1、创建/查看/删除/列举子账号 2、创建/删除/列举/禁用/启用accesskey 3、创建/查看/删除桶策略 对象存储管理功能增加： 1、创建/查看/删除lifecycle 2、支持断点续传下载 3、文件夹递归操作参数简化 4、批量上传/下载操作返回汇总信息 5、列举Bucket返回信息优化 配置文件优化： 1、配置文件简化，合并config和credentials 2、支持指定配置文件，进行账号切换 |
2021-05-07 |
| 1.1.0 | 支持大文件断点续传 ProjectId解耦、文件上传下载支持进度展示 |
2020-12-15 |
| 1.0.0 | 管理项目（mp、lsp） 管理bucket（mb、ls、rb） 管理object（ls、cp、mv、rm、sync） |
2018-08-21 |
CLI安装包下载
| 版本 | 下载地址 | MD5 |
|---|---|---|
| 1.3.0 | ycloud-cli-1.3.0.zip | BF486EBE3192A157D7C852B0CA03F1B4 |
| 1.2.0 | ycloud-cli-1.2.0.zip | 13654D6805E17C5DE9DD55161A12B993 |
| 1.1.0 | ycloud-cli-1.1.0.zip | D793FEFDB9EC6016AD33A7EBB5166390 |
| 1.0.0 | ycloud-cli-1.0.0.zip | AFA2A16C720142C379B5147945EEB632 |
1.2.2. 安装CLI的方式
命令行工具的按步骤安装方式包括离线安装和在线安装两种。 说明：最新版本CLI工具的升级可以直接使用以下安装流程。
离线安装
下载安装包，请通过页面提供的MD5值校验安装包的完整性。解压安装包后进入cli_release目录下，执行下面的命令进行离线安装。
$ pip install --upgrade ycloudcli --no-index -f ycloudcli_offline
安装完成后输入ycloud --v或ycloud --version，显示ycloud版本信息则表明安装成功。
$ ycloud --version
ycloud-cli/<version> Python/2.7.5 Linux/3.10.0-693.el7.x86_64 botocore/1.12.55
在线安装
下载安装包，请通过页面提供的MD5值校验安装包的完整性。解压安装包后进入cli_release/ycloudcli_source目录下，执行下面的命令进行在线安装。
$ python install.py
安装完成后输入ycloud --v或ycloud --version，显示ycloud版本信息则表明安装成功。
$ ycloud --version
ycloud-cli/<version> Python/2.7.5 Linux/3.10.0-693.el7.x86_64 botocore/1.12.55
常见问题
1． 安装过程出现报错
请尝试重新安装CLI，推荐使用离线安装的方式重装。若持续报错，可手动安装对应的依赖包。
2． 安装完成后，输入ycloud提示命令不存在
请先确认正在使用的pip所属的python版本，并将该python加入到系统环境变量中。
1.3. 一键安装
1.3.1. 支持的操作系统
- CentOS版本7.0及以上
- Ubuntu版本14.0及以上
1.3.2. 版本更新记录
| 版本 | 更新内容 | 发布日期 |
|---|---|---|
| 1.3.0 | 新增归档存储类型 | 2021-08-18 |
| 1.2.0 | 支持一键安装 | 2021-05-07 |
1.3.3. CLI安装包下载
Centos版本
| 版本 | 操作系统 | 下载地址 | MD5 |
|---|---|---|---|
| 1.3.0 | Centos版本7.0以上 | ycloud-1.3.0-1.el7.centos.x86_64.rpm | 9B3403CACC18F7A6053C071FE4CD1290 |
| 1.2.0 | Centos版本7.0以上 | ycloud-1.2.0-1.el7.centos.x86_64.rpm | F43D66EF75736D01C7EBDA7D5D0DE103 |
Ubuntu版本
| 版本 | 操作系统 | 下载地址 | MD5 |
|---|---|---|---|
| 1.3.0 | Ubuntu版本14.0及以上 | ycloud_1.3.0_amd64.deb | 502FEC780F02CC19303EE8CD9E672616 |
| 1.2.0 | Ubuntu版本14.0及以上 | ycloud_1.2.0_amd64.deb | B34729BEC2AE748CA518F69C01AA720E |
1.3.4. 安装过程
下载安装包，请通过页面提供的MD5值校验安装包的完整性。下载完成后，执行下面的命令进行安装。
CentOS版本
$ rpm -i ycloud-1.3.0-1.el7.centos.x86_64.rpm
Ubuntu版本
$ dpkg -i ycloud_1.3.0_amd64.deb
安装完成后输入ycloud --v或ycloud --version，显示ycloud版本信息则表明安装成功。
$ ycloud --version
ycloud-cli/<version> Python/2.7.5 Linux/3.10.0-693.el7.x86_64 botocore/1.12.55