tencent cloud

文档反馈

下载与安装配置

最后更新时间:2022-05-05 15:11:21

    COSCLI 工具提供 Windows、Mac、Linux 操作系统的二进制包,通过简单的安装和配置后即可使用。

    下载地址

    Windows
    Mac
    Linux

    说明:

    当前版本号为v0.11.0-beta,如需获取工具的最新版本、历史版本和更新日志,请前往 release 进行查看。

    安装

    Windows

    1. 下载 Windows 版本 COSCLI
    2. 将已下载的 COSCLI 可执行文件移动至C:\Users\<用户名>目录下。
    3. coscli-windows.exe重命名为coscli.exe
    4. win+r键打开运行程序。
    5. 在对话框中,输入cmd,按 Enter 打开命令行窗口。
    6. 在命令行窗口中,输入coscli --version,若打印出以下信息则代表安装成功:
      说明:

      Windows系统下,在不同的命令行客户端中使用 COSCLI 的方式可能略有不同,若输入coscli [command]后 COSCLI 无法正常工作,请尝试./coscli [command]的格式。

      coscli version v0.11.0-beta
      

    Mac

    1. 运行以下命令下载 COSCLI:

      wget https://github.com/tencentyun/coscli/releases/download/v0.11.0-beta/coscli-mac
      
    2. 运行以下命令重命名文件:

      mv coscli-mac coscli
      
    3. 运行以下命令修改文件执行权限:

      chmod 755 coscli
      
    4. 在命令行中输入./coscli --version,若打印出以下信息则代表安装成功:

      coscli version v0.11.0-beta
      
    说明:

    在 Mac 系统下使用 COSCLI 时,若弹出无法打开“coscli”,因为无法验证开发者的提示,可以前往设置 > 安全性与隐私 > 通用中选择仍要打开 coscli,之后即可正常使用 COSCLI。

    Linux

    1. 单击 下载 Linux 版本 COSCLI,或运行以下命令下载 COSCLI:

      wget https://github.com/tencentyun/coscli/releases/download/v0.11.0-beta/coscli-linux
      
    2. 运行以下命令重命名文件:

      mv coscli-linux coscli
      
    3. 运行以下命令修改文件执行权限:

      chmod 755 coscli
      
    4. 在命令行窗口中输入./coscli --version,若打印出以下信息则代表安装成功:

      coscli version v0.11.0-beta
      

    配置参数

    您可以使用./coscli --help命令来快速查看 COSCLI 的使用方法。

    初次使用时,COSCLI 会默认在~/.cos.yaml的位置生成配置文件,后续您也可以使用./coscli config init命令在其他位置为 COSCLI 交互式地生成配置文件。

    配置文件中各配置项的说明如下:

    配置项 说明
    Secret ID 密钥 ID,可从 访问管理控制台 中创建并获取。
    Secret Key 密钥 Key,可从 访问管理控制台 中创建并获取。
    Session Token 临时密钥 token,当使用临时密钥时需要配置,若不使用可以直接按 Enter 跳过。
    APP ID APP ID 是您在成功申请腾讯云账户后所得到的账号,由系统自动分配,可从 账号信息 中获取。一个存储桶的全称由Bucket NameAPP ID这两个元素组成,格式为<bucketname-appid>,详情请参见 存储桶命名规范
    Bucket Name 存储桶名称,和 APP ID 一起构成存储桶全称,格式为<bucketname-appid>,详情请参见 存储桶命名规范
    Bucket Region 存储桶所在地域,详情请参见 地域与访问域名
    Bucket Alias 存储桶别名,配置后可以在使用时用BucketAlias代替BucketName-APPID,减少所需输入的命令长度,如果不配置此项,BucketAlias的值是BucketName-APPID的值。

    其他配置方法

    除了使用./coscli config init交互式地生成配置文件外,您也可以直接手动编写 COSCLI 的配置文件,COSCLI 的配置文件格式是yaml格式,配置文件示例如下:

    cos:
    base:
      secretid: XXXXXXXXXXXXXXX
      secretkey: XXXXXXXXXXXXXXXXX
      sessiontoken: ""
    buckets:
    - name: examplebucket1-1250000000
      alias: bucket1
      region: ap-shanghai
    - name: examplebucket2-1250000000
      alias: bucket2
      region: ap-guangzhou
    - name: examplebucket3-1250000000
      alias: bucket3
      region: ap-chengdu
    
    注意:

    COSCLI 默认从 ~/.cos.yaml 处读取配置项,若用户想要使用自定义的配置文件,请在命令后使用 -c (--config-path)选项。

    配置多个存储桶

    COSCLI 支持多个存储桶,然而在初次配置时,COSCLI 只会要求您配置一个存储桶的信息,您后续可以使用./coscli config add命令添加存储桶配置。

    说明:

    更多有关配置文件的操作,请参考 config 命令

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持