标准环境中的 Node.js 快速入门

标准环境中的 Node.js 快速入门

区域 ID

REGION_ID 是 Google 根据您在创建应用时选择的区域分配的缩写代码。此代码不对应于国家/地区或省，尽管某些区域 ID 可能类似于常用国家/地区代码和省代码。对于 2020 年 2 月以后创建的应用，REGION_ID.r 包含在 App Engine 网址中。对于在此日期之前创建的现有应用，网址中的区域 ID 是可选的。

详细了解区域 ID。

确定

Python 2.7/3 |Java 8/11 |PHP 5/7 |Ruby |Go 1.11/1.12+ |Node.js

本快速入门介绍了如何在 App Engine 上部署示例应用。如果您想要了解如何为 App Engine 编写应用代码，请参阅构建应用。

App Engine 是您理想的计算选项吗？查看其他在 Google Cloud 上托管应用的选项。

费用

运行本指南不会产生任何相关费用。单独运行此示例应用不会超出您的免费配额。

准备工作

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

3. 确保您的 Google Cloud 项目已启用结算功能。

4. 启用 Cloud Build API。

   启用 API

5. 安装 Google Cloud CLI。

6. 如需初始化 gcloud CLI，请运行以下命令：

   gcloud init

7. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

8. 确保您的 Google Cloud 项目已启用结算功能。

9. 启用 Cloud Build API。

   启用 API

10. 安装 Google Cloud CLI。

11. 如需初始化 gcloud CLI，请运行以下命令：

    gcloud init

其他前提条件

1. 初始化您的项目的 App Engine 应用并选择应用的区域：

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   系统提示时，选择您希望自己的 App Engine 应用所在的区域。

   注意：应用的区域一经设置便无法更改。

2. 安装以下必备组件：

   • 下载并安装 Git。
   • 为 Node.js 开发准备好环境。

App Engine 位置

App Engine 是区域级的，这意味着运行您的应用的基础架构位于特定区域并由 Google 代管，以使其在该区域内的所有可用区以冗余方式提供。

选择要在哪个区域运行应用时，首先要考虑该区域是否能满足您的延迟时间、可用性或耐用性要求。通常，您可以选择距离应用的用户最近的区域，但也要考虑提供 App Engine 的位置以及应用使用的其他 Google Cloud 产品和服务的位置。跨多个位置使用服务可能会影响应用的延迟时间及其价格。

应用的区域一经设置，便无法更改。

注意：App Engine 命令和 Google Cloud Console 中称为 europe-west 和 us-central 的两个位置，在 Google 文档中的其他地方分别称为 europe-west1 和 us-central1。

如果您已创建 App Engine 应用，则可以通过执行以下任一操作来查看其区域：

• 运行 gcloud app describe 命令。

• 在 Cloud Console 中打开 App Engine 信息中心。该区域会显示在页面顶部附近。

确定

本快速入门演示了一个使用 Express.js 框架编写的简单 Node.js 应用。

重要提示：要在 Windows 上获得最佳体验，请运行 npm install -g npm 升级到最新版本的 Node.js 软件包管理器 (npm)。最新版本的 npm 在扁平化目录结构中安装依赖项，因此安装过程不太可能与 Windows 最大路径长度 255 个字符产生冲突。如果您希望继续使用旧版本的 npm，则可以将项目移动到驱动器的根目录（例如 C:\）来缩短路径长度。

下载示例代码

使用简单的 Hello World 应用，快速概览如何在 App Engine 上部署网络服务。按照以下步骤将代码下载到开发环境：

1. 下载 Node.js 示例应用代码库：

   Cloud Shell

   在 Cloud Shell 中打开代码库：

   

   本地机器

   下载代码库的 ZIP 文件并将其解压缩。

   或者，使用 git 克隆代码库：

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
   

2. 切换到包含 Hello World 应用的目录：

   cd nodejs-docs-samples/appengine/hello-world/standard
   

在本地运行 Hello World

1. 安装项目的依赖项：

   npm install
   

2. 启动 HTTP 服务器：

   npm start
   

3. 在网络浏览器中查看应用：

   Cloud Shell

   在 Cloud Shell 工具栏中，点击网页预览 ，然后选择在端口 8080 上预览。

   本地机器

   将网络浏览器指向 http://localhost:8080。

   您可以看到页面上显示“Hello, world!”消息。

4. 在终端窗口中按 Ctrl+C 停止 HTTP 服务器。

在 App Engine 上部署并运行 Hello World

1. 从 hello-world/standard 目录运行以下命令，在 App Engine 上部署 Hello World 应用：

   gcloud app deploy
   

2. 访问 https://PROJECT_ID.REGION_ID.r.appspot.com 以查看实时应用：

   gcloud app browse
   

现在，消息“Hello, world!”由在 App Engine 实例上运行的 Web 服务器提供。

恭喜！您已在 App Engine 上成功部署了一项 Node.js 网络服务！

清理

如果您想要继续了解 App Engine，可以保留您的 Cloud 项目并按照构建应用进行操作。

或者，您也可以删除 Cloud 项目，以停止对该项目中使用的所有资源计费。

警告：删除项目会产生以下影响
• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。
1. 在 Google Cloud 控制台中，进入管理资源页面。

   转到“管理资源”

2. 在项目列表中，选择要删除的项目，然后点击删除。
3. 在对话框中输入项目 ID，然后点击关闭以删除项目。

后续步骤

您现在已经有了在 App Engine 上部署网络服务的经验，可以通过阅读构建应用更深入地了解 App Engine 上的 Node.js。

如需详细了解 App Engine 标准环境中的 Node.js 运行时，请参阅 Node.js 运行时环境。