# 使用手册
## 1.申请资源
1）注意事项
>注意：如果登录网页时 提示 “你的连接不是专用连接” 时，点击“高级” ---> 继续访问xxxx网址

由于测试环境域名没有证书需要先登录证书

![Alt text](image.png)

![Alt text](image-1.png)

2）打开证书网站

https://login.gaoxinai.com/
先打开证书网站https://login.gaoxinai.com/（证书网站在首次打开云星平台时必须处于打开状态，进入后报404为正常情况）

![Alt text](image-2.png)

3）登录uconsole平台

https://uconsole.gaoxinai.com/
（如已经通过邮件申请获取了测试账号，请直接登录）
输入邮箱/用户名和密码进行登录

![Alt text](image-3.png)

4）实名认证和申请资源

a）点击右上角头像，找到待认证，点击进入

![Alt text](image-4.png)

b) 按照实际情况进行填写，并提交相关资料

![Alt text](image-5.png)

c) 提交完毕后等待审核通过

![Alt text](image-6.png)

d) uconsole平台-->云资源—>ModelArts—>申请资源
>注意：申请modelarts云资源需要主账户，子账户无法申请

![Alt text](image-7.png)


## 2.ModelArts使用
1）镜像注册

a) 云资源 --> ModelArts --> ModelArts控制台

![Alt text](image-8.png)

b) 	ModelArts --> 镜像管理 --> 注册镜像

![Alt text](image-9.png)

镜像源输入以下内容：
参考文件，选择合适的镜像：[镜像地址](http://39.171.244.84:30011/image.txt)

![Alt text](image-10.png)

例：该镜像内置了python3.10/pytorch2.1/torch_npu，如有其他环境需求跟华为工程师咨询。

如需安装指定框架请用镜像地址里提供镜像搭配安装脚本：[脚本地址](http://39.171.244.84:30011/package_dependencies/script/)

2）创建开发环境Notebook

a）ModelArts开发环境Notebook

![Alt text](image-11.png)

b）点击“创建”，选择自定义镜像创建Notebook

![Alt text](image-28.png)

**<font color=#FF0000 >注意：1.注意选择资源类型，以免产生额外费用；2.费用用完即停，卡数按需选择，建议选1卡；3.Notebook停止后：/home/ma-user/work目录下的数据会保存，其余目录下内容会被清理。如果需要保存开发环境，可以通过保存镜像的方式保留开发环境设置。</font>**


![Alt text](image-13.png)


3)通过SSH远程连接开发环境

a）创建Notebook时勾选（SSH远程开发）

![Alt text](image-14.png)

b）创建密钥对

![Alt text](image-15.png)

c）具体远程连接配置参考（例）

![Alt text](image-16.png)

![Alt text](image-17.png)

```
HostName：authoring-ssh-cneast292.gaoxinai.com
Port：30380
User：ma-user
IdentityFile： ~/.ssh/KeyPair-f2ca.pem （本地密钥对路径）
```
SSH连接实例

![Alt text](image-18.png)

VSCODE实例

```
Host xmd
    HostName authoring-ssh-cneast292.gaoxinai.com
    port 30380
    User ma-user
    IdentityFile ~/.ssh/KeyPair-f2ca.pem
    StrictHostKeyChecking no
    UserKnownHostsFile /dev/null
    ForwardAgent yes
```

## 3.OBS使用及数据上传
1）桶创建及数据上传

a) uconsole平台-->云资源-->对象存储控制台

![Alt text](image-20.png)

b) 创建OBS桶（建议账户使用自己的桶）

![Alt text](image-21.png)

c) 下载OBS Browser 客户端，并安装

![Alt text](image-22.png)

d) 云星平台处获取AK/SK 

![Alt text](image-23.png)

>点击“创建”手机短信验证后会下载一个包含AK/SK的Excel文件《密钥》到本地，只能下载一次，请妥善保存！

e) 登录 OBS客户端

![Alt text](image-24.png)

>（杭州智算中心服务器地址：obs.cn-east-292.mygaoxinai.com）

f) 创建对应文件夹，并且上传数据集和算法到 OBS桶里

![Alt text](image-25.png)

2）将OBS中的数据文件导入到notebook

* 小文件直接本地上传(notbook拖拽或远程服务连接工具:xshell,crt,vscode … 的方式)
* 大文件使用obsutil工具上传，[工具下载](https://gitee.com/csw-assdasd8sa8d7as78/aicc-mind-speed-llm-document/blob/master/%E5%A4%9A%E6%9C%BA%E8%AE%AD%E7%BB%83%E4%BD%9C%E4%B8%9A%E6%B5%81%E7%A8%8B/Untitled-1_files/obsutil)
```
1.登陆obs
chmod +x obsutil
./obsutil config -i=AK(详见三1)d)) -k=SK(详见三1)d)) -e=obs.cn-east-292.mygaoxinai.com

2.传输，notebook和obs可以双向，类似于cp/scp 
拷贝文件
./obsutil cp obs://XXX/   XXX
拷贝目录
./obsutil sync obs://XXX/   XXX
```
## 4.上传镜像
不建议上传自定义镜像，我们提供做好的镜像，使用前请咨询华为工程师。

1）下载镜像
```
docker pull 所选镜像XXX
vi /etc/docker/daemon.json
在’registry-mirrors’字段里，添加https://swr.cn-east-292.mygaoxinai.com
在’ insecure-registries’字段里，添加https://swr.cn-east-292.mygaoxinai.com
```
2）上传镜像

![Alt text](image-26.png)
![Alt text](image-27.png)
```
sudo docker tag 镜像XXX swr.cn-east-292.mygaoxinai.com/{组织名称}/{镜像名称}:{版本名称}
sudo docker push swr.cn-east-292.mygaoxinai.com/{组织名称}/{镜像名称}:{版本名称}
```
3）注册镜像

![Alt text](image-9.png)
![Alt text](image-10.png)
## 5.其他资料
FTP资源下载：

http://122.233.93.251:6868/ascend/

智算平台ModelArts用户手册：

https://docs.gaoxinai.com/zh-cn/modelarts/index.html

CANN使用手册：

https://www.hiascend.com/document/detail/zh/canncommercial/601/overview/index.html

昇腾开源代码仓：

https://gitee.com/ascend