🚀 在 VS Code 中

使用 Visual Studio Code 远程 SSH

2019 年 7 月 25 日,作者:Sana Ajani,@sana_ajani

远程 - SSH:轻松、流畅,并且(像)本地一样

如果您错过了,Visual Studio Code 最近发布了远程开发扩展。 远程扩展允许您针对容器、远程机器或虚拟机 (VM) 或 Windows Subsystem for Linux (WSL) 进行开发,同时使用功能齐全的 VS Code 作为您的开发环境。

Remote SSH architecture

无限可能:您不受本地机器的束缚

越来越多的开发人员在大型且复杂的项目上工作,这些项目需要他们针对专门的开发虚拟机或服务器工作,这些虚拟机或服务器提供比普通笔记本电脑更多的存储或计算能力。

然而,这种开发方式也带来了一些挑战

  • 如果您正在使用远程访问软件(如 VNC),则在编辑时可能会遇到延迟,因为您的 UI 不再是本地的。
  • 如果您正在使用远程桌面协议 (RDP),则可能难以管理多个连接。
  • 挂载远程文件系统和执行批量操作可能会很慢。
  • 保持远程和本地环境同步很麻烦,而且您经常遇到在某个地方工作正常,但在另一个地方却不正常的问题。
  • 使用 SSH 和 Vim 远程编辑文件意味着您不再处于您首选的编码编辑器的舒适环境中。

如果能够在不放弃工具的情况下突破本地机器的物理限制,那不是很好吗? 现在,远程 - SSH 扩展的魔力来了。

使用 Linux 进行远程开发

只要您的 Linux 虚拟机支持 SSH,它就可以托管在任何地方; 在您的本地主机上、在本地、在 Azure 中或在任何其他云中。 您也可以在任何客户端上 - Windows、macOS 或 Linux。

注意:macOS 和 Windows SSH 主机尚不受支持。

在这篇博客文章中,我们将使用 Windows 客户端并以 Azure 上的 Linux 虚拟机为目标。

开始使用

要开始使用,您需要完成以下操作

  1. 安装OpenSSH 兼容的 SSH 客户端(不支持 PuTTY)。
  2. 安装 Visual Studio Code
  3. 拥有 Azure 订阅(如果您没有 Azure 订阅,请在开始之前创建一个免费帐户)。

创建虚拟机

如果您没有现有的 Linux 虚拟机,您可以通过Azure 门户创建一个新的虚拟机。 在 Azure 门户中,搜索“虚拟机”,然后选择添加。 从那里,您可以选择您的 Azure 订阅并创建一个新的资源组(如果您还没有)。

Create a virtual machine

现在您可以指定虚拟机的详细信息,例如名称、大小和基本映像。 在此示例中,我们将选择 Ubuntu Server 18.04 LTS,但您可以选择其他 Linux 发行版的最新版本,并查看我们的受支持的 SSH 服务器

Virtual machine instance details

设置 SSH

有多种虚拟机身份验证方法,包括 SSH 公钥/私钥对或用户名和密码。 我们强烈建议使用基于密钥的身份验证,这样您就不需要每次连接都输入密码。 如果您使用的是 Windows 并且已经使用 PuttyGen 创建了密钥,则可以重用它们

如果您没有 SSH 密钥对,请打开 bash shell 或命令行并键入

ssh-keygen -t ed25519

这将生成 SSH 密钥。 在以下提示符下按 Enter 键,将密钥保存在默认位置。

ssh-keygen output

然后系统将提示您输入安全密码,但您可以将其留空。

将 SSH 密钥添加到您的虚拟机

在上一步中,我们生成了一个 SSH 密钥对。 我们将获取公钥并将其粘贴到我们的虚拟机设置中,方法是复制 id_ed25519.pub 的内容。 您还需要允许您的虚拟机接受入站 SSH 流量。

Add SSH public key to VM

使用 Azure 虚拟机的一个很酷的功能是能够启用自动关机(因为让我们面对现实,我们都会忘记关闭虚拟机……)。 如果您转到管理选项卡,则可以设置您希望每天关闭虚拟机的时间。

Virtual machine auto-shutdown

选择查看 + 创建,Azure 将为您部署虚拟机!

使用远程 - SSH 连接

现在我们已经介绍了如何创建 SSH 主机,让我们连接到它!

VS Code Remote - SSH 扩展允许您从 VS Code 内部使用 SSH 连接到远程机器或虚拟机。 如果您尚未安装 Remote - SSH 扩展,则可以在扩展视图 (Ctrl + Shift + X) 中搜索“remote ssh”。

Remote SSH extension

您会注意到状态栏的左下角有一个指示器。 此指示器告诉您 VS Code 在哪个上下文中运行(本地或远程)。 单击指示器以调出远程扩展命令列表。

Remote extension commands

选择Remote-SSH: Connect to Host命令,并通过输入虚拟机的连接信息(格式为:user@hostname)连接到主机。

user 是您在向虚拟机添加 SSH 公钥时设置的用户名。 对于 hostname,返回到Azure 门户,并在我们创建的虚拟机的概述窗格中,复制公用 IP 地址

Virtual machine public IP address

在连接信息文本框中设置用户和主机名。

Set user and host name

VS Code 现在将打开一个新窗口(实例)。 然后您将看到一条通知,指出“VS Code Server”正在 SSH 主机上初始化。 一旦 VS Code Server 安装在远程主机上,它就可以运行扩展并与您的本地 VS Code 实例通信。

Initializing VS Code Server

您可以通过查看状态栏中的指示器来了解您是否已连接到虚拟机。 现在它显示了我们虚拟机的主机名!

SSH indicator in Status bar

Remote - SSH 扩展还在您的活动栏上贡献了一个新图标,单击它可以打开 SSH 资源管理器。 在这里,您可以配置您的 SSH 连接。 例如,您可以保存您最常连接的主机,并从此处访问它们,而无需输入用户和主机名。

Remote button on Activity bar

连接到 SSH 主机后,您可以与远程计算机上的文件进行交互并打开文件夹。 如果您打开集成终端,您将看到您正在在 Windows 上的 bash shell 中工作。 等等,我们已经连接到我们的虚拟机了吗? 这太容易了。 这就是重点。 这些扩展使远程开发感觉轻松、流畅,并且……嗯,不像是远程的。 😃

Checking uname in the terminal

您可以使用 bash shell 浏览虚拟机上的文件系统。 使用 mkdir demo 创建一个新文件夹“demo”,您可以使用文件 > 打开文件夹浏览和打开远程主目录中的文件夹。

Remote open folder

您还可以在远程 SSH 主机上专门安装扩展。 影响 UI 的扩展(如主题和代码片段)在本地安装,其余扩展将需要安装在远程 SSH 主机上。 您会注意到当您打开扩展视图时,有两个部分,一部分用于本地计算机上的扩展,一部分用于远程主机上的扩展。 即使您从不同的客户端 SSH 进入远程计算机,您的远程扩展和设置也将保持不变。 当您安装扩展时,VS Code 将自动将其安装在正确的上下文中。

Intellicode extension installed remotely

你好,世界

让我们将一个基本的“Hello World”Python 应用程序部署到我们的虚拟机。 我们将使用一个流行的 Python Web 框架,名为 Flask。 在您的 bash shell 中,运行以下命令。

sudo apt install python3-flask

在您之前创建的“Demo”文件夹中,创建一个名为 app.py 的新文件 (Ctrl + N),其中包含一个基本的 Hello world Flask 应用程序。

from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello Remote World! :)"

if __name__ == "__main__":
    app.run()

一旦 VS Code 将文件语言识别为 Python,您将看到一条通知,建议您安装 Microsoft Python 扩展(如果远程计算机上尚未安装)。

Python extension recommendation

选择安装,重新加载 VS Code,您将开始在我们的远程计算机上看到 VS Code 的 IntelliSense 和颜色化。

python IntelliSense

要运行该应用程序,请按 F5,然后选择 Flask 调试配置。 在 Python 调试控制台中,您将看到该应用程序正在端口 5000 上的 localhost 上运行。 但是,localhost 当前指的是远程服务器,而不是您的本地计算机。 为了能够在本地计算机上浏览 Web 应用程序,我们将利用另一个名为端口转发的功能。

为了能够访问远程计算机上可能未公开的端口,我们需要在本地计算机上的端口和服务器之间建立连接或隧道。 在应用程序仍在运行时,打开 SSH 资源管理器并找到转发的端口视图。 单击转发端口链接,并指示我们要转发端口 5000

Enter the port to forward

将连接命名为“browser”

Name the port

服务器现在会将端口 5000 上的流量转发到我们的本地计算机。 当您浏览到 https://127.0.0.1:5000 时,您将看到正在运行的 Web 应用程序。

Hello Remote World in a browser

现在,真正的问题是……我们可以在远程计算机上从 VS Code 进行调试吗? 是的! 在应用程序仍在运行时,在返回字符串“Hello Remote World”的行上设置一个断点,然后在调试控件中选择重新启动按钮。 刷新浏览器中的页面,您将命中该断点! 您将获得相同的 VS Code 体验,包括编辑、调试以及所有设置和扩展。 😊

Debugging over SSH

要切换回本地机器进行本地开发,您可以使用文件 > 关闭远程连接来关闭远程连接。

使用 Remote - SSH 扩展,您可以使用虚拟机以及远程计算机上的所有 VS Code 生产力功能和扩展。 无论您的代码托管在哪里,您都可以获得您熟悉和喜爱的 VS Code 的完整开发体验。

如果您想了解有关 VS Code Remote 的更多信息,您可以阅读我们宣布远程开发的博客文章。 您还可以试用其他远程扩展,Dev ContainersWSL,并阅读我们的完整远程开发文档

远程编码愉快,

Sana Ajani,VS Code 项目经理 @sana_ajani