使用直连方式远程连接DSW - 人工智能平台 PAI

当您想要在本地或者其它设备上，使用终端或VSCode远程连接DSW实例时，可以采用SSH直连的方式，其连接稳定并且快速。

使用限制

直连方式支持的DSW实例类型。
- 使用公共资源组创建的后付费DSW实例。
- 使用灵骏智算资源创建的DSW实例。
公网NAT网关支持DSW实例数量限制。
由于VPC的公网NAT网关的限制，当使用公网登录方式远程连接DSW实例时，PAI会为您的每个公网NAT网关配置最多100条DNAT规则，您无需手动配置。因此，一个公网NAT网关最多同时支持100个DSW实例。更多有关配额的详情，请参见配额。

准备工作

当使用公共资源组创建后付费DSW实例时，需要完成以下准备工作：
- 创建专有网络和交换机。具体操作，请参见创建和管理专有网络。
- 为专有网络创建安全组。具体操作，请参见创建安全组。
当使用灵骏智算资源创建DSW实例时，需要创建灵骏智算资源。具体操作，请参见灵骏智算资源配额。
如果需要通过公网登录方式（即从本地命令行或其他客户端）远程连接DSW实例，您需要为专有网络创建公网NAT网关并绑定EIP。具体操作，请参见创建公网NAT网关、绑定EIP。
开通内网DNS解析（PrivateZone），具体操作，请参见开通内网DNS解析。

步骤一：获取SSH公钥

首先需要在客户端上生成公钥，在生成过程中需要设置用于登录DSW实例的密码，如果您想要使用remote_ikernel工具连接实例（见本文场景示例），请不要设置密码，直接按回车键（Enter）。生成公钥的命令如下：

（推荐）将公钥生成到默认路径下：
```
ssh-keygen -m PEM -t rsa -b 4096
```
执行该命令后，默认在以下目录中生成4096位RSA类型的公钥（id_rsa.pub）和私钥（id_rsa）文件。如果当前位置已存在SSH密钥对，则这些文件将被覆盖。不同系统默认路径如下：
- Windows操作系统：保存在C:\Users\<username>\.ssh目录或C:\用户\<username>\.ssh目录。
- Linux操作系统：root用户保存在/root/.ssh目录；普通用户保存在 /home/<username>/.ssh目录。
- Mac操作系统：保存在/Users/<username>/.ssh目录。

将公钥生成到自定义目录下：

ssh-keygen -m PEM -t rsa -b 4096 -f /your/path/example_rsa # 将在/your/path下生成example_rsa.pub和example_rsa

步骤二：开启DSW实例的直连功能

在创建DSW实例时，对如下网络相关参数进行配置，其他参数配置详情，请参见创建DSW实例。对于已创建的实例，单击变更配置修改对应参数，然后单击确定，更新配置。

公共资源组后付费实例配置

参数		描述
网络配置	专有网络	选择已创建的专有网络、交换机和安全组。
	安全组
	交换机
	公网访问网关	请根据您的使用场景进行选择：公有网关：集群中的DSW实例使用共享的公网带宽。专有网关：独享带宽，您可以根据需求选择不同的带宽。选择该方式后，您需要为DSW实例关联的专有网络创建公网NAT网关、绑定EIP并配置SNAT条目，否则将无法通过DSW实例访问公网。具体配置方法，请参见DSW通过专有公网网关访问公网。
SSH配置说明打开网络配置后可见。	SSH公钥	打开SSH配置开关，将步骤一中生成的公钥文件`id_rsa.pub`的内容手动复制到该文本框中。说明如果您需要同时支持VPC内登录和公网登录方式，您需要同时添加多个客户端的公钥。请按照回车换行的方式逐个添加公钥，最多支持添加10个公钥。
SSH配置说明打开网络配置后可见。	登录方式	VPC内登录：默认支持该登录方式。您可以从VPC内的其他终端（例如ECS），通过SSH远程连接DSW实例。公网登录：您可以在支持VPC内登录的基础上，增加公网登录方式。选中公网登录，并配置以下参数，后续，您可以通过本地命令行或其他终端使用SSH远程连接到DSW实例。 NAT网关：选择为专有网络创建的公网NAT网关。弹性公网IP：选择在公网NAT网关中已创建的弹性公网IP。

灵骏资源组实例配置

参数		描述
SSH配置	SSH公钥	打开SSH配置开关，将步骤一中生成的公钥文件`id_rsa.pub`的内容手动复制到该文本框中。说明如果您需要同时支持VPC内登录和公网登录方式，您需要同时添加多个客户端的公钥。请按照回车换行的方式逐个添加公钥，最多支持添加10个公钥。
SSH配置	登录方式	VPC内登录：默认支持该登录方式。您可以从VPC内的其他终端（例如ECS），通过SSH远程连接DSW实例。公网登录：您可以在支持VPC内登录的基础上，增加公网登录方式。选中公网登录，并配置以下参数，后续您可以通过本地命令行或其他终端使用SSH远程连接到DSW实例。 NAT网关：选择为专有网络创建的公网NAT网关。弹性公网IP：选择在公网NAT网关中已创建的弹性公网IP。

步骤三：安装SSH Server

如果您的DSW实例使用的是官方预置镜像或基于官方预置镜像生成的自定义镜像，则已默认安装了SSH Server，您可以跳过该步骤。否则需要按照以下步骤来手动安装SSH Server。

打开需要操作的DSW实例。
在DSW的Terminal中，执行如下命令。
```
sudo apt-get update
sudo apt-get install openssh-server
sudo service ssh start
```
如果执行命令失败，返回结果为sudo，表示未找到命令，您可以尝试执行apt-get install sudo命令后，再次执行上述命令即可。
执行如下命令可以查看SSH Server状态。
```
service ssh status
```

步骤四：远程连接DSW实例

查看访问方式。
在DSW页面，单击实例名称进入实例详情页面。在实例配置页签的访问配置区域中，查看公网访问方式和VPC访问方式。
说明
如果SSH配置未选择公网登录，则此处将只显示VPC访问方式，不显示公网访问方式。
连接DSW实例。
通过SSH连接
- 公网访问
  在本地命令行或其他终端中，使用步骤1查询的公网访问方式远程连接到DSW实例。
```
ssh root@xx.xx.xx.xx -p 1024 
# 如果私钥不在默认路径上，需要指定私钥的位置
ssh -i /your/path/example_rsa root@xx.xx.xx.xx -p 1024 
```
- VPC访问
  在VPC内的其他终端（例如ECS实例），使用步骤1查询的VPC访问方式远程连接到DSW实例。
```
ssh root@dsw-notebook-xxxx.dsw-xxxx.dsw.pai.alibaba.com -p 22
# 如果私钥不在默认路径上，需要指定私钥的位置
ssh -i /your/path/example_rsa root@dsw-notebook-xxxx.dsw-xxxx.dsw.pai.alibaba.com -p 22
```
通过本地VSCode连接
1. 打开VSCode，在Extensions中安装Remote - SSH插件。
2. 单击左下角，唤出Remote-SSH弹窗，选择Connect to Host... > Add New SSH Host...。
3. 输入SSH连接命令。
```
ssh root@xx.xx.xx.xx -p 1024 
# 如果私钥不在默认路径上，需要指定私钥的位置
ssh -i /your/path/example_rsa root@xx.xx.xx.xx -p 1024 
```
4. 单击右下角Connect，左下角显示连接成功。
5. 打开DSW实例中的目录，开始远程开发和调试。
6. 运行时可连接DSW实例中的Kernel。

场景示例：在DSW实例上运行本地Notebook代码

前提条件

已按照本文步骤一到步骤三完成SSH直连配置，且生成SSH公钥时没有设置密码。

操作步骤

在本地Terminal安装remote_ikernel工具，做初始化配置，并添加一个remote kernel。

pip install remote_ikernel

remote_ikernel manage --add \
--kernel_cmd="ipython kernel -f {connection_file}" \  # 无需修改
--name="Remote Python" \
--interface=ssh \
--host=root@*.*.*.*:1024  # 此处修改为您的host地址，如果私钥不在默认路径上，则需要设置为 --host="-i /your/path/example_rsa root@*.*.*.*:1024"

如果回显提示如下，表示remote kernel添加成功。

Added kernel ['rik_ssh_root_121_40_*_*_1024_remotepython']: SSH root@121.40.*.*:1024 Remote Python.

查看remote kernel配置信息可执行如下命令。

remote_ikernel manage --show

在本地VSCode中，打开一个Notebook文件，右上角kernel切换，可在搜索框中选到Remote Python。

常见问题

是否支持使用PyCharm等本地WebIDE来远程连接到DSW实例？
原则上支持所有基于原生SSH协议实现的功能。但需要注意的是，如果您使用PyCharm作为客户端，则会在DSW实例中自动触发下载和安装服务端。因此，您需要确保您指定的DSW实例具有公网访问能力。
VPC地址访问不通，如何解决？
- 请确认您是否使用了自定义镜像，您的自定义镜像里是否安装并开启了SSH服务。详情请参见步骤三：安装SSH Server。
- 请确认您创建实例的安全组规则内，入方向是否允许TCP 22端口的访问。
- 如果上述方法无法解决您的问题，请联系您的商务经理进行进一步排查。
如何查看实例公网IP?
如果您已配置好公网NAT网关，可以通过以下步骤查看公网ip。
查看公网IP操作步骤
1. 在DSW实例列表页，单击实例名称进入实例配置页面。
2. 找到网络信息的区域，单击弹性公网IP，即可在弹性公网实例页面查看到IP。
公网地址访问不通，如何解决？
- 请先在VPC环境内，确认您的VPC地址是否可以访问DSW实例。
- 如果VPC地址可以访问，但公网地址无法访问。请确认在您选择的VPC中是否创建了多个公网NAT网关：
  - 如果创建了多个公网NAT网关，请参考同VPC内多公网NAT网关部署方案，检查您的NAT网关、vSwitch和路由表之间的关系是否正确。您在DSW中选择的vSwitch能够在路由表中正确路由到您选择的NAT网关，这样才能使您的SSH请求的返回结果返回到您的客户端。
  - 如果您只有一个公网NAT网关，请使用自助问题排查中的网络连通性问题进行排查。输入您本机的公网IP、您的公网EIP以及DSW实例分配给您的端口（即在DSW实例详情页查询的公网访问方式中配置的端口），分析网络可达性。

人工智能平台 PAI：SSH直连方式