云服务器内容精选

  • 概述 针对不同的环境,您可以参考如下方式完成快速安装: 在Windows系统上安装KooCLI 在Linux系统上安装KooCLI 在MacOS系统上安装KooCLI 在Docker中配置和使用KooCLI 您也可以从下表中直接下载适配您目标系统的KooCLI到本地,再将其上传至您的目标机器,解压后即可使用: 表1 下载地址 操作系统 下载地址 隐私声明 Windows 64位 KooCLI-windows-amd64.zip KooCLI-windows-amd64.zip_sha256 详见《隐私政策声明》 Linux AMD 64位 KooCLI-linux-amd64.tar.gz KooCLI-linux-amd64.tar.gz_sha256 Linux ARM 64位 KooCLI-linux-arm64.tar.gz KooCLI-linux-arm64.tar.gz_sha256 macOS AMD 64位 KooCLI-mac-amd64.tar.gz KooCLI-mac-amd64.tar.gz_sha256 macOS ARM 64位 KooCLI-mac-arm64.tar.gz KooCLI-mac-arm64.tar.gz_sha256 KooCLI下载地址是不带sha256后缀结尾的链接,带sha256后缀结尾的下载链接仅为对应软件包的校验文件。 例如:Windows 64位的下载链接是KooCLI-windows-amd64.zip,它的校验文件下载链接则是KooCLI-windows-amd64.zip_sha256。 父主题: 步骤二:快速安装
  • 在Docker中配置和使用KooCLI 在Docker中配置和使用KooCLI,请遵循如下步骤(以创建Linux系统ubuntu发行版的Docker容器为例): 在按步骤执行之前,请确保您已经安装Docker。有关安装说明,请参阅 Docker 网站。可运行以下命令确认是否安装Docker: docker --version 创建Dockerfile文件 新建目录并在该目录下创建名为Dockerfile的纯文本文件,文件内容如下: FROM ubuntu:latestRUN apt-get update -y && apt-get install curl -y# 一键式安装KooCLIRUN curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -yWORKDIR hcloud Dockerfile文件名带有大写字母D,且没有文件扩展名,每个目录只能保存一个。 hcloud_install.sh文件为一键式安装KooCLI的脚本文件,其对应的软件包校验文件为hcloud_install.sh.sha256 可在上述Dockerfile文件中追加如下内容,指定启动容器时运行的程序为KooCLI: ENTRYPOINT ["/usr/local/bin/hcloud"] 其后,以该文件构建的docker镜像所启动的容器仅支持执行单条KooCLI命令,详情见后文所示。 构建镜像 在此目录下运行以下命令来构建名为“hcloudcli”的Docker镜像: docker build --no-cache -t hcloudcli . ... 命令末尾的“.”指在当前目录中构建Docker镜像,不可省略。 在Dockerfile文件中追加“ENTRYPOINT ["/usr/local/bin/hcloud"]”时,在构建镜像时会有如下提示: 镜像构建成功后使用以下命令查看构建的镜像: docker images 使用镜像 用法一:基于“hcloudcli”镜像创建后台运行容器,并在容器中执行命令。 docker run -it -d --name hcloudcli hcloudcli 运行如下命令查看已启动的Docker容器: docker ps 运行如下命令进入Docker容器,进入到容器后KooCLI的使用方式与直接在宿主机上使用相同: docker exec -it hcloudcli /bin/bash 使用完成后,执行如下命令退出“hcloudcli”容器: exit 要完全停止“hcloudcli”容器运行,可执行如下命令: docker stop hcloudcli 用法二:基于“hcloudcli”镜像创建临时容器,并执行命令。 创建临时容器,并执行命令: docker run --rm -it hcloudcli ${command} 使用未追加“ENTRYPOINT ["/usr/local/bin/hcloud"]”的Dockerfile创建的Docker镜像,在执行“docker run”命令时需指定运行的程序为“hcloud”。如下所示: 使用追加了“ENTRYPOINT ["/usr/local/bin/hcloud"]”的Dockerfile创建的Docker镜像,则不需要指定运行程序。此时“docker run --rm -it hcloudcli”命令等效于在宿主机上直接执行“hcloud”命令。如下所示: 使用追加了“ENTRYPOINT ["/usr/local/bin/hcloud"]”的Dockerfile创建的Docker镜像,执行“docker run”时仅支持KooCLI相关命令。 创建临时容器,向容器共享宿主机文件(以Linux系统的宿主机为例),并执行命令: 通过宿主机系统目录和容器目录的挂载,将宿主机文件共享到容器: 示例1:通过将宿主机系统的/root/.hcloud/目录挂载到容器的/root/.hcloud/目录下,将宿主机配置文件共享到容器: docker run --rm -it -v /root/.hcloud/:/root/.hcloud/ hcloudcli ${command} 示例2:通过将宿主机系统的目录/cli挂载到容器的当前目录下,将宿主机该目录下的“test.json”文件共享到容器: docker run --rm -it -v /root/.hcloud/:/root/.hcloud/ -v /cli:$(pwd) hcloudcli ${command} 创建临时容器,向容器共享宿主机环境变量(以Linux系统的宿主机为例),执行命令: 通过“-e”标志共享宿主机的环境变量到容器中: docker run --rm -it -e ${envName} hcloudcli ${command} 给命令起别名(以Linux系统的宿主机为例),以简化命令。以使用追加了“ENTRYPOINT ["/usr/local/bin/hcloud"]”的Dockerfile创建的Docker镜像为例,执行如下命令,给原命令起别名为“hcloud”: alias hcloud='docker run --rm -it hcloudcli' 后续可使用别名执行原命令。如下所示: 更新镜像 已构建的镜像,其中的KooCLI版本为镜像构建时的最新版本。若要保证镜像中使用最新版本,重新构建镜像即可。 卸载镜像 执行如下命令卸载“hcloudcli”镜像: docker rmi hcloudcli 父主题: 步骤二:快速安装
  • 步骤三:初始化配置(可选) 本节以Windows系统为例介绍KooCLI的使用,Linux和Mac系统的使用基本相同,可参考。 如果您希望以无配置方式使用KooCLI,可跳过此步骤;若您希望以非交互方式添加配置项,请参考新增或修改配置项。 KooCLI初始化命令用于将常用的永久AK/SK和区域信息存储在配置文件中,如下表所示,避免使用时频繁输入这些固定信息: 表1 初始化时的参数 参数 说明 Access Key ID 访问密钥(永久AK/SK)中的访问密钥ID,简称AK,初始化时必填。 Secret Access Key 访问密钥(永久AK/SK)中的密码访问密钥,简称SK,初始化时必填。 Region 区域,如cn-north-4,初始化时选填。 可通过如下命令进行初始化配置,输入命令后按回车进入交互模式,根据界面提示输入各参数值: hcloud configure init hcloud configure init开始初始化配置,其中"Secret Access Key"输入内容匿名化处理,获取参数可参考'https://support.huaweicloud.com/usermanual-hcli/hcli_09.html'Access Key ID [required]: ********Secret Access Key [required]: ****Secret Access Key (again): ****Region: cn-north-4************************************************************* ********** 初始化配置成功 ********** ************************************************************* 初始化过程中,“Secret Access Key”的值需要二次确认。为保障您的账号安全,对您输入的“Secret Access Key”进行了匿名化处理。在您输入过程中不会显示输入的字符,在输入结束回车至下一行时,会以“*”回显您的输入内容。在配置完成后,KooCLI会在本地加密保存配置项中的认证相关的敏感信息。 如果重新执行初始化命令,则会在删除原配置文件后重新生成新的配置文件,配置文件保存地址如下: Windows系统: C:\Users\{您的Windows系统用户名}\.hcloud\config.json Linux系统: /home/{当前用户名}/.hcloud/config.json Mac系统: /Users/{当前用户名}/.hcloud/config.json 完成初始化后,可通过如下命令查询配置信息。KooCLI1.2.7以前的版本密文显示查询结果中的敏感信息;1.2.7及以后的版本匿名化显示查询结果中的敏感信息。 hcloud configure show --cli-profile=default hcloud configure show --cli-profile=default{ "name": "default", "mode": "AKSK", "accessKeyId": "********", "secretAccessKey": "****", "securityToken": "", "region": "cn-north-4", "projectId": "", "domainId": "", "skipSecureVerify": "false", "readTimeout": 10, "connectTimeout": 5, "retryCount": 0}
  • 在Windows系统上安装KooCLI 点此下载适配Windows系统的KooCLI。 解压后得到hcloud.exe文件,如下图所示。 图1 在Windows系统下载并解压后的hcloud.exe文件 (可选)将KooCLI所在目录加入到系统环境变量Path中,方便在cmd窗口的任意目录下使用hcloud命令。 Windows 10 和 Windows 8 搜索并选择“查看高级系统设置”,然后单击“环境变量”; Windows 7 右键单击桌面上的“计算机”图标,从菜单中选择“属性”。单击“高级系统设置”链接,然后单击“环境变量”。 进入环境变量图形界面,在“用户变量”列表中,选中变量名为“Path”的环境变量,单击“编辑”。 在编辑环境变量界面中单击“新建”,输入hcloud.exe文件所在目录的路径。 单击三次“确定”,即可保存该修改。 (可选)打开cmd窗口,执行如下命令查看环境变量是否包含hcloud.exe文件所在目录,存在即说明配置成功。 set path (可选)打开Windows系统的cmd窗口(若您未执行如上步骤3,需要进入到工具所在的目录中),输入并执行如下命令,验证KooCLI是否安装成功。 hcloud version 系统显示类似如下版本信息,表示安装成功: hcloud version当前KooCLI版本:3.2.8 父主题: 步骤二:快速安装
  • 入门流程 本节以Windows系统为例介绍KooCLI的使用,Linux和MacOS系统的使用基本相同,可参考。 KooCLI最基础的入门操作包括:快速安装、初始化配置信息,查看与执行云服务操作命令。 图1为KooCLI大致的入门流程,本入门指导旨在帮助您对其操作有初步的认识。 图1 入门流程 注册华为帐号,创建 IAM 用户并授权,获取访问密钥等,请参见步骤一:准备工作。 使用KooCLI调用 API Explorer 中各云服务开放的API,管理和使用您的各类云服务资源前,需要先下载对应操作系统的KooCLI,请参见步骤二:快速安装。 使用KooCLI时,需要获取调用者的身份信息用以认证鉴权。如您不是以无配置方式使用,那么您需要先配置相关的认证信息,具体配置方法请参见步骤三:初始化配置。 完成配置后,即可使用KooCLI管理和使用您的各类云服务资源,方法请参见步骤四:查看与执行云服务操作命令。
  • 修改已初始化的配置项 KooCLI目前支持在配置项中以如下组合方式配置认证参数:访问密钥(永久AK/SK),临时安全凭证(临时AK/SK和SecurityToken)两种。 其中,临时安全凭证(临时AK/SK和SecurityToken)具有时效性。 初始化配置信息时,配置项的名称为“default”,且初始化时配置项中只允许配置永久AK/SK。如果您要使用其他认证方式,或修改初始化的配置项中的参数值,可使用“hcloud configure set --cli-profile=default --key1=value1...”命令,详情请参考新增或修改配置项。
  • 一键式安装 请使用如下命令一键式安装KooCLI: curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh 如上命令默认将KooCLI下载至“/usr/local/hcloud/”目录,并移动到“/usr/local/bin/”目录下,方便在任意目录下使用hcloud命令(完成本步骤之前,请确保PATH系统变量值中存在“/usr/local/bin/”路径)。 您可在该命令执行过程中根据交互信息修改文件下载目录等。如执行过程中提示权限不足,您可切换至root用户重新执行安装命令。 若您希望使用其默认配置且跳过交互模式,可在该命令末尾添加“-y”,如下: curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -y hcloud_install.sh文件为一键式安装KooCLI的脚本文件,其对应的软件包校验文件为hcloud_install.sh.sha256
  • 一键式安装 请使用如下命令一键式安装KooCLI: curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh 如上命令默认将KooCLI下载至“/usr/local/hcloud/”目录,并移动到“/usr/local/bin/”目录下,方便在任意目录下使用hcloud命令(完成本步骤之前,请确保PATH系统变量值中存在“/usr/local/bin/”路径)。 您可在该命令执行过程中根据交互信息修改文件下载目录等。如执行过程中提示权限不足,您可切换至root用户重新执行该安装命令。 若您希望使用其默认配置且跳过交互模式,可在该命令末尾添加“-y”,如下: curl -sSL https://cn-north-4-hdn-koocli.obs.cn-north-4.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -y hcloud_install.sh文件为一键式安装KooCLI的脚本文件,其对应的软件包校验文件为hcloud_install.sh.sha256 命令执行过程中,如遇报错“sha256sum:command not found”,请安装“sha256sum”后再次执行命令。
  • 创建IAM用户并授权 使用KooCLI管理和使用您的各类云服务资源时,需提供调用者(IAM用户)的身份信息用于认证鉴权。 IAM用户是由华为帐号在IAM中创建的用户,是云服务的使用人员,具有独立的身份凭证,根据华为帐号授予的权限使用资源,可以确保华为帐号及资源的安全性。IAM用户不进行独立的计费,由所属华为帐号统一付费。 您注册华为云后,系统自动创建华为帐号对应的IAM用户,该用户在IAM中标识为“企业管理员”,其权限无法修改。出于业务需要,您可以另外创建IAM用户,并根据实际需要给IAM用户授权。
  • 责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击,华为云在遵从法律法规业界标准的基础上,以安全生态圈为护城河,依托华为独有的软硬件优势,构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任,如图1所示。 华为云:负责云服务自身的安全,提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS类云服务自身的安全,涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身,也包括运维运营安全,以及更广义的安全合规遵从。 租户:负责云服务内部的安全,安全地使用云。华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理,包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统,虚拟防火墙、API网关和高级安全服务,各项云服务,租户数据,以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施,包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题: 安全
  • 如何使用KooCLI 下载KooCLI。 KooCLI绿色免安装,下载到本地后解压即可使用。KooCLI支持Windows 64位、Linux AMD 64位、Linux ARM 64位、macOS AMD 64位、macOS ARM 64位,请根据您本地系统下载对应的版本。 配置KooCLI环境。 环境配置请参考快速初始化配置。 获取云服务API调用命令。 获取云服务API调用命令有两种方式: (推荐)API Explorer上获取 云服务的API可在API Explorer上查看。您可以在API Explorer上先填写好各参数的值,即可从“CLI示例”页签中直接获取命令。 KooCLI帮助信息查询 具体查询方法可参考查看与执行云服务操作命令,Mac和Linux系统下查询方法类似。 通过KooCLI调用云服务API。 输入完整的API调用命令后回车,即完成调用。 (可选)将KooCLI命令集成到您的自定义脚本中,实现云服务资源的自动化管理。
  • 什么是KooCLI 华为云命令行工具服务(Koo Command Line Interface,KooCLI,原名HCloud CLI)是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中各云服务开放的API,管理和使用您的各类云服务资源。 KooCLI只提供了一种通过CLI调用云服务API的方法。在使用KooCLI之前,您需要熟悉该API。KooCLI无法为您提供云服务API的具体使用方面的专业帮助,相关问题请咨询服务oncall。 在使用KooCLI之前,您可以使用API Explorer平台查找所需的API、查看在线文档和调试API。 KooCLI灵活性高且易于扩展: 单一可执行文件,绿色免安装,下载解压后即可使用。 多操作系统支持,包括Linux、Windows、Mac。 扩展性强,您可基于此工具对云服务API进行封装,扩展出您想要的功能,实现脚本化管理云服务资源。 下载KooCLI,请参考《快速入门》。 您也可以在线体验KooCLI。 在Windows系统使用KooCLI时,请勿双击执行hcloud.exe文件,正确的用法是在hcloud.exe文件所在目录下打开命令行工具(支持CMD、PowerShell)后执行相应命令。
  • 无配置方式使用概述 KooCLI既可以使用配置项调用云服务API,也提供了无配置的操作方式,无配置方式使用是指在使用KooCLI时不通过已有配置项传入当前用户的认证信息,而是直接在命令中传入当前用户认证相关的参数。此方式可使用户免于添加配置项,方便快捷地使用KooCLI。用户可以通过如下认证方式直接调用云服务API: 无配置方式AKSK 无配置方式ecsAgency 无配置方式使用KooCLI时,需留意这些注意事项,也需了解各认证方式的优先级。 父主题: 无配置方式使用KooCLI
  • 交互式提示 KooCLI支持功能强大的多平台支持的交互式提示,方便命令构建,在命令中添加“--interactive”参数即可进入交互式提示。交互式中根据用户当前输入的内容,提示云服务名称,API的operation,参数及其描述信息,也提供部分参数值的补全功能。 交互式的使用方式如下: 交互模式中使用“Tab”或向上箭头、向下箭头键实现待补全内容的上下选择。 选中待补全内容后,使用空格键将已选内容追加到当前命令中。 进入交互模式后,使用“Ctrl+C”可切换至新命令行,使用“Ctrl+D”可退出交互模式。 交互式可提示和补全如下内容: 云服务 初次进入交互模式后,会自动提示云服务及系统命令列表。 图1 交互式中提示云服务和系统命令列表 所提示的云服务列表中,左列展示云服务短名/系统命令,右列展示该云服务的服务名称/该系统命令的描述信息。 API 已输入的云服务/系统命令经校验无误后,会继续提示该服务的API列表/该系统命令的子命令(或参数)。 所提示的系统命令列表中,左列展示该系统命令的子命令(或参数),右列展示该子命令(或参数)的描述信息。 图2 交互式中提示云服务的API列表 所提示的云服务API列表中,左列展示API的operation名称,右列展示该API的描述信息。 图3 交互式中提示系统命令的子命令 图4 交互式中提示系统命令的参数 若已输入的云服务/系统命令非法,则不再提示任何信息。 参数 已输入服务名与API的operation,或已输入系统命令及其子命令经校验无误后,会继续提示该API/系统命令子命令的参数列表。 图5 交互式中提示云服务API的参数列表 图6 交互式中提示系统命令子命令的参数列表 所提示的参数列表中,左列展示参数名称;右列展示该参数的描述信息。 若已输入API的operation/系统命令子命令非法,或已输入的参数名非法,则不再提示任何信息。 参数值 在交互式中,在部分参数名后输入等号,会提示该参数的可取值或默认值列表。例如:若调用API的命令中当前输入的参数是“--cli-region=”时,会提示该API的可选区域列表。 图7 交互式中提示已输入云服务API的可选区域列表 交互模式下的快捷键 Ctrl + W:将光标前的单词删除 Ctrl + K:将光标之后的内容删除 Ctrl + U:将光标之前的内容删除 Ctrl + L:清除屏幕 若用户尚未添加配置项,或默认配置项中的区域不被命令中的API所支持,用户需先根据提示,从目标API支持的cli-region列表中选择合适的区域值。确定区域后,KooCLI会继续提示该API的参数列表。 交互式提示参数时,除自定义map类型的参数(即:参数名中包含“{*}”的参数)外,已输入的参数不会重复提示;若提示的参数名中有“[N]”,其含义为索引位,请使用数字代替该字符;若提示的参数名中有“{*}”,其含义为自定义参数名称,请使用任意不含“.”的字符串代替该字符。 切换至新命令行后可使用向上箭头和向下箭头浏览已执行命令的历史记录。 父主题: 常用命令
  • 配置http_proxy环境变量 请根据您系统选择并执行如下命令,配置http_proxy环境变量。 Linux或MacOS系统 临时环境变量 配置http_proxy的命令为: export http_proxy="http://username:password@proxyServer:port" 其中,proxyServer为代理服务器的 域名 (如果能解析)或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问,需要填写上面的username和password部分,否则的话,可以省略这两部分,如下: export http_proxy="http://proxyServer:port" 永久环境变量 在~/.bashrc文件中添加如下内容,可将http_proxy永久配置在当前用户的环境变量中: export http_proxy="http://username:password@proxyServer:port" 其中,proxyServer为代理服务器的域名(如果能解析)或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问,需要填写上面的username和password部分,否则的话,可以省略这两部分,如下: export http_proxy="http://proxyServer:port" 请注意:永久环境变量配置完毕后,一般需要注销并重新登录,配置才可生效。 Windows系统 使用cmd: 临时环境变量 配置http_proxy的命令为: set http_proxy=http://username:password@proxyServer:port 其中,proxyServer为代理服务器的域名(如果能解析)或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问,需要填写上面的username和password部分,否则的话,省略这两部分,如下: set http_proxy=http://proxyServer:port 永久环境变量 将http_proxy永久配置在当前用户的环境变量中的命令为: setx "http_proxy" "http://username:password@proxyServer:port" 其中,proxyServer为代理服务器的域名(如果能解析)或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问,需要填写上面的username和password部分,否则的话,省略这两部分,如下: setx "http_proxy" "http://proxyServer:port" 请注意:永久环境变量配置完毕后,将在新打开的终端中生效,当前终端不会立即生效。 使用PowerShell: 临时环境变量 配置http_proxy的命令为: $env:http_proxy="http://username:password@proxyServer:port" 其中,proxyServer为代理服务器的域名(如果能解析)或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问,需要填写上面的username和password部分,否则的话,省略这两部分,如下: $env:http_proxy="http://proxyServer:port" 永久环境变量 将http_proxy永久配置在当前用户的环境变量中的命令为: [environment]::SetEnvironmentvariable("http_proxy", "http://username:password@proxyServer:port", "User") 其中,proxyServer为代理服务器的域名(如果能解析)或者IP。port为端口号。如果你的代理服务器需要用户名和密码才能访问,需要填写上面的username和password部分,否则的话,省略这两部分,如下: [environment]::SetEnvironmentvariable("http_proxy", "http://proxyServer:port", "User") 请注意:永久环境变量配置完毕后,将在新打开的终端中生效,当前终端不会立即生效。