Windows系统使用CLI客户端工具接入云开发环境

操作场景

使用Windows操作系统的开发者可以通过hdspace在本地PC端的创建和管理云开发环境，通过该工具建立与云开发环境的连接，进而实现对云开发环境的远程操作(上传下载文件、编码编译执行等)。

前提条件

登录华为开发者空间
已创建虚机

操作步骤

安装CLI工具包

在虚机列表中，选择“远程连接”，将弹出虚拟机开发环境支持的CLI客户端工具列表。

点击放大

可按照对应的操作系统点击“立即下载”CLI客户端工具。

配置环境变量，以Windows11为例，在搜索栏搜索环境变量，或者在控制面板中找到环境变量，点击系统变量中的path，新增环境变量。

把hdspace.exe文件所在路径，添加到新增的环境变量中并保存确认。

点击放大

确认cli工具包安装成功

进入终端执行命令hdspace，查看安装结果。

hdspace

显示如下，则为安装成功。

查看支持的cli命令行列表，执行help命令可查看cli命令行列表。

hdspace --help

含义	命令
云开发环境顶层帮助	hdspace devenv --help
开发者空间配置帮助	hdspace config --help
开发者空间版本帮助	hdspace version --help
云开发环境列表帮助	hdspace devenv list --help
创建云开发环境帮助	hdspace devenv create --help
启动云开发环境帮助	hdspace devenv start –help
关闭云开发环境帮助	hdspace devenv close --help
删除云开发环境帮助	hdspace devenv delete --help
建立隧道帮助	hdspace devenv start-tunnel --help

至此，我们成功安装了CLI客户端工具并已配置环境变量，后续可通过CLI命令行来配置和管理云开发环境。

配置云开发环境访问密钥

在使用cli客户端工具包创建和管理云开发环境之前，需要先在本地配置用户的AK/SK，获取用户远程操作权限，保证操作的安全性。
1. 获取AK/SK：
  AK是Access Key（访问密钥）的缩写, 用于标识用户身份的唯一ID, 通常公开传输;SK是Secret Key（秘密密钥）的缩写，用于生成请求签名的保密密钥，仅用户和服务端持有。其核心功能是通过对称加密机制验证请求发送者的合法性，防止未授权访问。开发者配置AK/SK，等同于在cli中进行身份信息认证，从而可以在cli端对云开发环境进行操作。
  
  操作步骤：
  
  1.1 进入华为云控制台。
  
  1.2 将鼠标移至页面右上角的用户名处，在下拉列表中单击“我的凭证”。
  
  1.3 单击“访问密钥”。
  
  1.4 单击“新增访问密钥”，进入“新增访问密钥”页面。
  - 每个用户最多可创建2个访问密钥，不支持增加配额。如果您已拥有2个访问密钥，将无法创建访问密钥。
  - 如需修改访问密钥，请删除访问密钥后重新创建。
  - 为了保证历史兼容性，系统会使用访问密钥创建时间作为最近使用时间的初始值。在您使用该访问密钥时，系统将自动刷新最近使用时间。
  1.5 输入描述信息，单击“确定”。
  
  1.6 创建成功后，在“创建成功”弹窗中，单击“立即下载”下载密钥，并妥善保管。
  
  您可以在访问密钥列表中查看访问密钥ID（AK），在下载的.csv文件中查看访问密钥（SK）。
  - 获取临时AK/SK，请参考IAM接口文档。
  - 请及时下载保存，弹窗关闭后将无法再次获取该密钥信息，但您可重新创建新的密钥。
  - 当您下载访问密钥后，可以在浏览器页面左下角打开格式为.csv的访问密钥文件，或在浏览器“下载内容”中打开。
  - 为了账号安全性，建议您妥善保管并定期修改访问密钥，修改访问密钥的方法为删除旧访问密钥，然后重新生成。
2. 配置AK/SK
输入命令：
```
hdspace config
```
注意：按照提示输入AK/SK，SK输入后并不会回显，并且需要再次输入确认。

如上图显示，则配置AK/SK成功。
创建云开发环境
1. 查看可用云开发环境信息
   输入命令：
```
hdspace devenv list
```
  说明：因本章节开始已经创建云开发环境，所以可以看到已经有一个环境存在。若是开发者想体验使用CLI创建，则先去网页端执行删除即可。
  
  删除成功后，再次执行如下命令：
```
hdspace devenv list
```
  可以看到已经没有云开发环境
2. 通过cli创建云开发环境
   命令如下：
```
hdspace devenv create --name=【用户自定义的云开发环境名称】 --type=【类型】
```
  参数说明：
  - hdspace devenv create：固定创建命令
  - name(必选) : 自定义，可包含数字、字母、下划线，长度不超过15个字符，不能以数字开头。
  - type(必选): 云开发环境有2种类型可选，一种虚机vm，一种容器container，本次选择虚机vm。
  创建成功之后，再次使用如下命令查看创建是否成功：
```
hdspace devenv list
```
  可以看到 NAME 为 test1 且 TYPE 为 Vm 的虚机已创建成功，状态为 Creating。
启动云开发环境
1. 开机
   可以通过help命令查看开机相关命令，具体开机命令如下:
  
  注意：instanceId与name必须选填一个
```
hdspace devenv start --instance-id=【instanceId】 --name=【name】
```
  参数说明：
  - hdspace devenv start：固定开机命令
  - instance-id(可选) : 创建云开发环境成功后的ID。
  - name(可选): 创建云开发环境成功后的NAME。
  启动命令执行后，可以看到 NAME 为 test1 且 TYPE 为 Vm 的虚机已启动成功，状态为 Running。
连接云开发环境

建立隧道连接云开发环境

通过创建本地PC和远程云开发环境的隧道链接，可在本地设备与云端虚机之间搭建安全的加密通信通道。

建立隧道连接命令如下：
```
hdspace devenv start-tunnel --instance-id=【instanceId】 --name=【name】 --ports=【ports】 --local-addr=【localAddr】
```
参数说明：
- hdspace devenv start-tunnel：固定建立隧道命令
- instance-id(可选)： 字符串，即为上述步骤中创建的云开发环境ID，与name之间必选一个。
- name(可选): 创建云开发环境成功后的NAME，与instance-id之间必选一个。
- ports(必选)：映射端口（0-65535），用’,‘和’:'分隔，格式为local-port11:remote-port1,local-port12:remote-port2，如果映射端口只有一个，则本地和远程端口相同，如10022:22,10380:8080,8087等。
- local-addr(可选)：字符串，本地地址(IPV4), 如果不设置, 默认localhost(127.0.0.1)。
至此，成功建立隧道连接至云开发环境。
关闭云开发环境

如要关闭云开发环境，需退出云开发环境，返回本地终端目录后进行操作：

关闭云开发环境命令如下，instanceId与name必须选填一个：
```
hdspace devenv close --instance-id=【instanceId】 --name=【name】
```
参数说明：
- hdspace devenv close：固定关闭命令
- instance-id(可选) : 创建云开发环境成功后的ID。
- name(可选): 创建云开发环境成功后的NAME。
可以看到 NAME 为 test1 的虚机已经关闭了，状态为 Closing。

注：关机后，【关机中】状态无需做任何操作，等关机（耗时1~3分钟）完成后，状态会变成【已就绪】，如下图所示：

至此，云开发环境的虚机重新回到了Ready准备状态。
删除云开发环境

当有需要删除云开发环境时，可使用删除命令进行云开发环境的虚拟机删除，命令如下，instanceId与name必须选填一个：
```
hdspace devenv delete --instance-id=【instanceId】 --name=【name】
```
参数说明：
- hdspace devenv delete：固定删除命令
- instance-id(可选) : 创建云开发环境成功后的ID。
- name(可选): 创建云开发环境成功后的NAME。
删除后，【删除中】状态无需做任何操作，耗时1~3分钟完成。

至此，完成了云开发环境虚机的删除操作。