vs code toolkit连接notebook-九游平台

vs code toolkit功能介绍

前提条件

已下载并安装vs code。详细操作请参考安装vs code软件。

step1 安装vs code插件

1. 在本地的vs code开发环境中，如图1所示，在vs code扩展中搜索“modelarts-huaweicloud”并单击“安装”。
   图1 安装vs code插件
   
2. 安装过程预计1~2分钟，如图2所示，请耐心等待。
   图2 安装过程
   
3. 安装完成后，系统右下角提示安装完成，导航左侧出现modelarts图标和ssh远程连接图标，表示vs code插件安装完成。
   图3 安装完成提示
   
   图4 安装完成
   

step2 登录vs code插件

1. 在本地的vs code开发环境中，单击modelarts图标，单击“user settings”，配置用户登录信息。
   图6 登录插件
   
   输入如下用户登录信息，单击“登录”。

   • name：自定义用户名，仅用于vs code页面展示，不与任何华为云用户关联。
   • ak、sk：在“账号中心 > 我的凭证 > 访问密钥”中创建访问密钥，获取ak、sk（参考链接）。
   • 选择站点：此处的站点必须和远程连接的notebook在同一个站点，否则会导致连接失败。
2. 登录成功后显示notebook实例列表。
   

   此处仅显示modelarts控制台default工作空间下的notebook实例。

   图7 登录成功
   

step3 创建notebook实例

• 创建实例时，需开启“ssh远程开发”，并下载保存密钥对至本地如下目录。

  windows：c:\users\{{user}}

  macos/linux: users/{{user}}

• 密钥对在用户第一次创建时自动下载，之后使用相同的密钥时不会再有下载界面（请妥善保管），或者每次都使用新的密钥对。

创建一个notebook实例，并开启远程ssh开发，具体参见创建notebook实例。

step4 连接notebook实例

1. 在本地的vs code开发环境中，右键单击实例名称，单击“connect to instance”，启动并连接notebook实例。

   notebook实例状态处于“运行中”或“停止”状态都可以，如果notebook实例是停止状态，连接notebook时，vs code插件会先启动实例再去连接。

   图8 连接notebook实例
   
   或者单击实例名称，在vs code开发环境中显示notebook实例详情页，单击“连接”，系统自动启动该notebook实例并进行远程连接。

   图9 查看notebook实例详情页
   
2. 第一次连接notebook时，系统右下角会提示需要先配置密钥文件。选择本地密钥pem文件，根据系统提示单击“ok”。
   图10 配置密钥文件
   
3. 单击“确定”后，插件自动连接远端notebook实例。首次连接大约耗时1~2分钟，取决于本地的网络情况。vs code环境左下角显示类似下图即为连接成功。
   图11 连接成功
   

远程调试代码

1. 在vs code界面，上传本地代码到云端开发环境。
   1. 单击“file > openfolder”，选择要打开的路径，单击“ok”。
      图12 open folder
      
      图13 选择文件路径
      
   2. 此时，会在ide左侧出现该开发环境下的目录结构，选择想要上传的代码及其他文件，拖拽至目录对应的文件夹内即完成本地代码上传至云端。
   3. 在vs code中打开要执行的代码文件，在执行代码之前需要选择合适的python版本路径，单击下方默认的python版本路径，此时在上方会出现该远程环境上所有的python版本，选择自己需要的版本即可。
      图14 选择python版本
      
2. 对于打开的代码文件，单击run按钮，即可执行，可以在下方的terminal中看到代码输出信息。
   • 如果执行较长时间的训练作业，建议使用nohup命令后台运行，否则ssh窗口关闭或者网络断连会影响正在运行的训练作业，命令参考：

     nohup your_train_job.sh > output.log 2>&1  &  tail -f  output.log

   • 如果要对代码进行debug调试，步骤如下：
     1. 单击左侧“run > run and debug”。
     2. 选择当前打开的默认的python代码文件进行调试。
     3. 对当前代码进行打断点，即在代码左侧进行单击，就会出现小红点。
     4. 此时，即可按照正常的代码调试步骤对代码调试，在界面左边会显示debug信息，代码上方有相应的调试步骤。

相关操作

卸载vs code插件操作如图15所示。

图15 卸载vs code插件

常见问题

报错“permissions for 'x:/xxx.pem' are too open”如何解决？

报错“ssh: connect to host modelarts-xxx port xxx: connection timed out”如何解决？

报错“host key verification failed.'或者'port forwarding is disabled.”如何解决？