通过使用 Visual Studio Code 在本地创建 Node.js/Express 应用并将其部署到云,来开始使用 Azure 应用服务。 由于使用的是免费应用服务层,因此完成本快速入门不会产生费用。
先决条件
- 具有活动订阅的 Azure 帐户。 免费创建帐户。
- <a href="https://git-scm.com/" target="_blank">安装 Git</a>
- Node.js 和 npm。 运行命令
node --version验证是否已安装 Node.js。 - Visual Studio Code。
- Visual Studio Code 的 Azure 应用服务扩展。
克隆并运行本地 Node.js 应用程序
-
在本地计算机上,打开终端并克隆示例存储库:
git clone https://github.com/Azure-Samples/nodejs-docs-hello-world -
导航到新应用所在的文件夹:
cd nodejs-docs-hello-world -
启动该应用以在本地进行测试:
npm start -
打开浏览器并导航到
http://localhost:1337。 浏览器应会显示“Hello World!”。 -
在终端中按 Ctrl+C 停止服务器。
将应用部署到 Azure
在本部分,你将使用 VS Code 和 Azure 应用服务扩展将 Node.js 应用部署到 Azure。
-
在终端中,确保你在 nodejs-docs-hello-world 文件夹中操作,然后使用以下命令启动 Visual Studio Code:
code . -
在 VS Code 活动栏中,选择 Azure 徽标显示“AZURE 应用服务”资源管理器。 选择“登录到 Azure...”并遵照说明操作。 (如果遇到错误,请参阅下面的排查 Azure 登录问题。)登录后,资源管理器应会显示 Azure 订阅的名称。
登录 Azure
-
在 VS Code 的“AZURE 应用服务”资源管理器中,选择蓝色的向上箭头图标,将应用部署到 Azure。 (也可以从“命令面板”调用相同的命令 ( Ctrl+Shift+P ),方法是键入“部署到 Web 应用”,并选择“Azure 应用服务: 部署到 Web 应用”)。
-
选择 nodejs-docs-hello-world 文件夹。
-
根据要部署到的操作系统选择创建选项:
- Linux:选择“创建新 Web 应用”
- Windows:选择“创建新 Web 应用...高级”
-
键入 Web 应用的全局唯一名称,然后按 Enter 。 该名称必须在整个 Azure 中保持唯一,且只能使用字母数字字符(“A-Z”、“a-z”和“0-9”)和连字符(“-”)。
-
如果以 Linux 为目标,请在出现提示时选择 Node.js 版本。 建议使用 LTS 版本。
-
如果面向 Windows,请遵循附加提示:
- 选择“创建新的资源组”,然后输入资源组的名称,例如
AppServiceQS-rg。 - 选择 Windows 作为操作系统。
- 选择“创建新的应用服务计划”,输入该计划的名称(例如
AppServiceQS-plan),然后选择“F1 免费”作为定价层。 - 当系统提示 Application Insights 时,选择“立即跳过”。
- 选择你附近或想要访问的资源附近的区域。
- 选择“创建新的资源组”,然后输入资源组的名称,例如
-
响应所有提示后,VS Code 将在其通知弹出窗口中显示正在为该应用创建的 Azure 资源。
部署到 Linux 时,如果系统提示你更新配置以在目标 Linux 服务器上运行
npm install,请选择“是”。在目标 Linux 服务器上更新配置的提示
-
当系统提示你“始终将工作区 "nodejs-docs-hello-world" 部署到 (应用名称)”时,请选择“是”。 选择“是”就是告知 VS Code 在进行后续部署时自动以同一应用服务 Web 应用为目标。
-
如果部署到 Linux,请在部署完成后,选择提示中的“浏览网站”以查看全新部署的 Web 应用。 浏览器应会显示“Hello World!”
-
如果部署到 Windows,必须先为 Web 应用设置 Node.js 版本号:
-
在 VS Code 中展开新应用服务的节点,右键单击“应用程序设置”,并选择“添加新设置...”:
添加应用设置的命令
-
为设置键输入
WEBSITE_NODE_DEFAULT_VERSION。 -
为设置值输入
10.15.2。 -
右键单击应用服务的节点,并选择“重启”
重启应用服务的命令
-
再次右键单击应用服务的节点,并选择“浏览网站”。
-
排查 Azure 登录问题
如果在登录到 Azure 时出现错误“找不到名为 [订阅 ID] 的订阅”,原因可能是你使用了代理,因此无法访问 Azure API。 在终端中使用 export 以代理信息配置 HTTP_PROXY 和 HTTPS_PROXY 环境变量。
export HTTPS_PROXY=https://username:password@proxy:8080
export HTTP_PROXY=http://username:password@proxy:8080
如果设置环境变量不能解决该问题,请选择上面的“我遇到了问题”按钮联系我们。
更新应用
若要将更改部署到此应用,可以在 VS Code 中进行编辑,保存文件,然后使用前面所述的相同过程,只是这一次要选择现有的应用,而不是创建新应用。
查看日志
可以在 VS Code 输出窗口中直接从应用查看日志输出(对 console.log 的调用)。
-
在“AZURE 应用服务”资源管理器中右键单击应用节点,并选择“开始流式传输日志”。
开始流式传输日志
-
出现提示时,请选择启用日志记录并重启应用程序。 重启应用后,VS Code 输出窗口将会打开,其中包含与日志流建立的连接。
-
几秒钟后,输出窗口将看到一条消息,指出已连接到日志流服务。 可以通过刷新浏览器中的页面来生成更多输出活动。
<pre> Connecting to log stream... 2020-03-04T19:29:44 Welcome, you are now connected to log-streaming service. The default timeout is 2 hours. Change the timeout with the App Setting SCM_LOGSTREAM_TIMEOUT (in seconds). </pre>
后续步骤
祝贺你,你现已成功完成本快速入门!
查看其他 Azure 扩展。
或安装 Node Pack for Azure 扩展包获取所有这些工具。
先决条件
如果你没有 Azure 帐户,请立即注册一个免费帐户来试用任何服务组合,并获得 200 美元的 Azure 信用额度。
需要连同 Node.js 和 npm(Node.js 包管理器)一起安装 Visual Studio Code。
还需要安装 Azure 应用服务扩展,使用该扩展可在 Azure 平台即服务 (PaaS) 上创建、管理和部署 Linux Web 应用。
登录
安装该扩展后,登录到你的 Azure 帐户。 在活动栏中,选择 Azure 徽标显示“AZURE 应用服务”资源管理器。 选择“登录到 Azure...”并遵照说明操作。
登录到 Azure
疑难解答
如果出现错误“找不到名为 [订阅 ID] 的订阅”,原因可能是你使用了代理,因此无法访问 Azure API。 在终端中使用 export 以代理信息配置 HTTP_PROXY 和 HTTPS_PROXY 环境变量。
export HTTPS_PROXY=https://username:password@proxy:8080
export HTTP_PROXY=http://username:password@proxy:8080
如果设置环境变量不能解决该问题,请选择下面的“我遇到了问题”按钮联系我们。
先决条件检查
在继续之前,请确保已安装并配置了所有必备组件。
在 VS Code 的状态栏中应会显示你的 Azure 电子邮件地址,“AZURE 应用服务”资源管理器中应会显示你的订阅。
创建 Node.js 应用程序
接下来,创建可部署到云的 Node.js 应用程序。 本快速入门使用一个应用程序生成器从终端快速搭建应用程序。
Tip: 如果已完成 Node.js 教程,可直接跳转到部署到 Azure。
使用快速生成器搭建新应用程序
Express 是用于生成和运行 Node.js 应用程序的流行框架。 可以使用 Express 生成器工具搭建(创建)新的 Express 应用程序。 快速生成器作为 npm 模块提供,可以使用 npm 命令行工具 npx 直接运行(无需安装)。
npx express-generator myExpressApp --view pug --git
--view pug --git 参数告知生成器使用 pug 模板引擎(以前称为 jade)并创建 .gitignore 文件。
若要安装应用程序的所有依赖项,请转到新文件夹并运行 npm install。
cd myExpressApp
npm install
运行应用程序
接下来,确保运行应用程序。 在终端中,使用 npm start 命令启动该应用程序以启动服务器。
npm start
现在,打开浏览器并导航到 http://localhost:3000,其中应会显示如下所示的内容:
运行 Express 应用程序
“部署到 Azure”
在本部分中,将使用 VS Code 和 Azure 应用服务扩展部署 Node.js 应用。 本快速入门使用最基本的部署模型,其中,应用程序将被压缩并部署到 Linux 上的 Azure Web 应用。
使用 Azure 应用服务进行部署
首先,在 VS Code 中打开应用程序文件夹。
code .
在“AZURE 应用服务”资源管理器中,选择蓝色的向上箭头图标,将应用部署到 Azure。
Tip: 也可以从 命令面板 (CTRL + SHIFT + P) 进行部署,方法是键入“deploy to web app”并运行“Azure App Service: Deploy to Web App”命令。
-
选择当前已打开的目录
myExpressApp。 -
选择“新建新的 Web 应用”, 此选项默认部署到 Linux 上的应用服务。
-
键入 Web 应用的全局唯一名称,然后按 ENTER。 应用名称的有效字符为“a-z”、“0-9”和“-”。
-
选择 Node.js 版本 ,建议使用“LTS”。
通知通道将显示正在为应用创建 Azure 资源。
-
当系统提示你更新配置以在目标服务器上运行
npm install时,选择“是”。 随后将部署应用。 -
部署开始后,系统会提示更新工作区,使以后的部署自动针对相同的应用服务 Web 应用。 选择“是”,以确保将更改部署到正确的应用。
Tip: 确保应用程序正在侦听 PORT 环境变量
process.env.PORT提供的端口。
在 Azure 中浏览应用
部署完成后,选择提示中的“浏览网站”以查看全新部署的 Web 应用。
疑难解答
如果看到错误“你无权查看此目录或页面”,则表示应用程序可能无法正常启动。 请转到下一部分,查看日志输出以找到并修复错误。 如果无法解决此问题,请选择下面的“我遇到了问题”按钮联系我们。 我们很乐意为你提供帮助。
更新应用
可以使用相同的过程来部署对此应用所做的更改,并选择现有应用而不是创建新应用。
查看日志
本部分介绍如何从运行的应用服务应用查看(或“跟踪”)日志。 对应用中的 console.log 发出的任何调用将显示在 Visual Studio Code 的输出窗口中。
在“AZURE 应用服务”资源管理器中找到该应用,右键单击该应用,然后选择“查看流日志”。
此时会打开 VS Code 输出窗口,其中包含与日志流建立的连接。
查看流日志
几秒钟后,你将看到一条消息,指出已连接到日志流服务。 请多次刷新页面以查看更多活动。
<pre> 2019-09-20 20:37:39.574 INFO - Initiating warmup request to container msdocs-vscode-node_2_00ac292a for site msdocs-vscode-node 2019-09-20 20:37:55.011 INFO - Waiting for response to warmup request for container msdocs-vscode-node_2_00ac292a. Elapsed time = 15.4373071 sec 2019-09-20 20:38:08.233 INFO - Container msdocs-vscode-node_2_00ac292a for site msdocs-vscode-node initialized successfully and is ready to serve requests. 2019-09-20T20:38:21 Startup Request, url: /Default.cshtml, method: GET, type: request, pid: 61,1,7, SCM_SKIP_SSL_VALIDATION: 0, SCM_BIN_PATH: /opt/Kudu/bin, ScmType: None </pre>
后续步骤
祝贺你,你现已成功完成本快速入门!
接下来请查看其他 Azure 扩展。
或安装 Node Pack for Azure 扩展包获取所有这些工具。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
