Compute Engine 上的 Node.js 使用入门

---

本教程介绍如何开始使用 Compute Engine。 请按照本教程向 Compute Engine 部署一个 Hello World Node.js Web 应用。如需获取 App Engine 入门方面的帮助，请参阅 App Engine 标准环境。

目标

• 使用 Cloud Shell 下载并部署 Hello World 示例应用。
• 将 Hello World 示例应用部署到单个 Compute Engine 实例。

费用

在本文档中，您将使用 Google Cloud 的以下收费组件：

• Compute Engine

您可使用价格计算器根据您的预计使用情况来估算费用。 Google Cloud 新用户可能有资格申请免费试用。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Compute Engine API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Compute Engine API.

   Enable the API

8. 在 Google Cloud 控制台中，在 Cloud Shell 中打开该应用。

   转到 Cloud Shell

   借助 Cloud Shell，您可以直接在浏览器中通过命令行访问云端资源。

9. 如果您同意克隆代码库，请点击确认以下载示例代码并切换到应用目录。

10. 在 Cloud Shell 中，配置 gcloud CLI 以使用新的 Google Cloud 项目：

    # Configure gcloud for your project
    gcloud config set project YOUR_PROJECT_ID

在 Cloud Shell 中运行应用

如果您在上一部分中点击转到 Cloud Shell，则 Cloud Shell 会将 nodejs-getting-started 代码库克隆到您的实例。实例启动后，您的工作目录为 ~/cloudshell_open/nodejs-getting-started/gce。如果您不在此目录中，请参阅准备工作中的步骤。

1. 安装依赖项：

   npm install
   

2. 运行应用：

   npm start
   

3. 在 Cloud Shell 中，点击 Web 预览，然后选择在端口 8080 上预览。此时浏览器会打开一个新窗口，显示出您运行中的应用。

要停止本地网络服务器，请按 Control+C。

设置 Cloud Source Repositories

1. 启用 Cloud Source Repositories API。

   启用 Cloud Source Repositories API

2. 在 Google Cloud 控制台中，转到 Cloud Source Repositories。

   转到 Cloud Source Repositories

3. 选择添加代码库。

   

4. 选择创建新代码库，然后点击继续。

5. 在代码库名称字段中，输入 new-repo。

6. 在项目字段中，输入您为本教程创建或选择的项目的 ID，然后点击继续。

7. 选择将您的代码库克隆到本地 Git 代码库。

8. 在 Cloud Shell 中，按照 Google Cloud SDK 标签页中的说明返回根目录并克隆代码库，同时使此标签页保持打开状态。

   

9. 在按照该说明完成最后一步之前，将您的应用复制到 Cloud Shell 中的新代码库：

   cd new-repo
   cp ../cloudshell_open/nodejs-getting-started/gce/app.js app.js
   cp ../cloudshell_open/nodejs-getting-started/gce/package.json package.json

10. 按照 Google Cloud SDK 标签页中的其余说明将您的更改提交到代码库。通过刷新浏览器并检查代码是否已添加到代码库 new-repo，确认您已将代码添加到代码库。

部署到单个实例

此部分逐步介绍了如何在 Compute Engine 上运行应用的单个实例。

您可以通过 Cloud Shell 将应用部署到单个 Compute Engine 实例虚拟机 (VM)，以运行您的应用。

使用启动脚本初始化实例

您需要一种方法来指示实例下载并运行这些代码。 实例可能拥有对其执行启动或重启操作时会运行的启动脚本。

下面是 Hello World 示例应用中包含的启动脚本：

gce/startup-script.sh

在 GitHub 上查看

set -v

# Talk to the metadata server to get the project id
PROJECTID=$(curl -s "http://metadata.google.internal/computeMetadata/v1/project/project-id" -H "Metadata-Flavor: Google")
REPOSITORY="new-repo"

# Install logging monitor. The monitor will automatically pick up logs sent to
# syslog.
curl -s "https://storage.googleapis.com/signals-agents/logging/google-fluentd-install.sh" | bash
service google-fluentd restart &

# Install dependencies from apt
apt-get update
apt-get install -yq ca-certificates git build-essential supervisor

# Install nodejs
mkdir /opt/nodejs
curl https://nodejs.org/dist/v16.15.0/node-v16.15.0-linux-x64.tar.gz | tar xvzf - -C /opt/nodejs --strip-components=1
ln -s /opt/nodejs/bin/node /usr/bin/node
ln -s /opt/nodejs/bin/npm /usr/bin/npm

# Get the application source code from the Google Cloud Repository.
# git requires $HOME and it's not set during the startup script.
export HOME=/root
git config --global credential.helper gcloud.sh
git clone https://source.developers.google.com/p/${PROJECTID}/r/${REPOSITORY} /opt/app/new-repo

# Install app dependencies
cd /opt/app/new-repo
npm install

# Create a nodeapp user. The application will run as this user.
useradd -m -d /home/nodeapp nodeapp
chown -R nodeapp:nodeapp /opt/app

# Configure supervisor to run the node app.
cat >/etc/supervisor/conf.d/node-app.conf << EOF
[program:nodeapp]
directory=/opt/app/new-repo
command=npm start
autostart=true
autorestart=true
user=nodeapp
environment=HOME="/home/nodeapp",USER="nodeapp",NODE_ENV="production"
stdout_logfile=syslog
stderr_logfile=syslog
EOF

supervisorctl reread
supervisorctl update

# Application should now be running under supervisor

启动脚本会执行以下任务：

• 安装 Cloud Logging 代理。该代理会自动从系统日志收集日志。

• 安装 Supervisor 将应用作为守护进程运行。

• 从 Cloud Source Repositories 代码库克隆应用的源代码并安装依赖项。

• 配置 Supervisor 以运行该应用。如果应用意外退出或被管理员或其他进程终止，Supervisor 将确保应用重启。此外，它还会将应用的 stdout 和 stderr 发送到 syslog，以便由 Logging 代理收集。

创建和配置 Compute Engine 实例

1. 创建 Compute Engine 实例：

   Linux/macOS

   gcloud compute instances create my-app-instance \
       --image-family=debian-9 \
       --image-project=debian-cloud \
       --machine-type=g1-small \
       --scopes userinfo-email,cloud-platform \
       --metadata app-location=us-central1-f \
       --metadata-from-file startup-script=gce/startup-script.sh \
       --zone us-central1-f \
       --tags http-server
   

   Windows

   gcloud compute instances create my-app-instance ^
       --image-family=debian-9 ^
       --image-project=debian-cloud ^
       --machine-type=g1-small ^
       --scopes userinfo-email,cloud-platform ^
       --metadata-from-file startup-script=gce/startup-script.sh ^
       --zone us-central1-f ^
       --tags http-server
   

   将地区替换为开发地区，例如 us-central1-a。如需详细了解区域和地区，请参阅地理位置和区域。

   这会创建一个新实例，允许其访问 Google Cloud 服务并运行您的启动脚本。实例名称为 my-app-instance。

2. 检查实例创建的进度：

   gcloud compute instances get-serial-port-output my-app-instance --zone YOUR_ZONE
   

   将 YOUR_ZONE 替换为您将实例部署到的可用区。

   启动脚本完成后，您会看到以下消息：

   startup-script: INFO Finished running startup scripts.
   

3. 创建一条防火墙规则以允许流量进入您的实例：

   gcloud compute firewall-rules create default-allow-http-8080 \
       --allow tcp:8080 \
       --source-ranges 0.0.0.0/0 \
       --target-tags http-server \
       --description "Allow port 8080 access to http-server"
   

4. 获取您的实例的外部 IP 地址：

   gcloud compute instances list
   

5. 要查看应用的运行情况，请在浏览器中输入以下网址：

   http://YOUR_INSTANCE_IP:8080
   

   将 YOUR_INSTANCE_IP 替换为实例的外部 IP 地址。

管理和监控实例

您可以使用 GCP Console 来监控和管理您的实例。

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.
3. 如需查看 Compute Engine 资源生成的所有日志，请转到日志浏览器页面。转到日志浏览器

   Cloud Logging 会自动配置为从各种常用服务（包括 syslog）收集日志。

清理

为避免因本教程中使用的资源导致您的 Google Cloud 帐号产生费用，请删除包含这些资源的项目，或者保留项目但删除各个资源。

删除项目

注意：删除项目会产生以下影响：

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

逐个删除资源

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-8080

后续步骤

• 探索有关 Google Cloud 的参考架构、图表和最佳实践。查看我们的 Cloud Architecture Center。

• 如需了解构建应用所需的其他 Node.js 资源，请参阅以下内容：

  • 转到 Compute Engine > 实例组以管理和监控实例组部署。
  • 转到网络服务 > 负载均衡以管理负载均衡配置，包括网址映射和后端服务。
  • 使用 Firestore 处理会话
  • 使用 Identity-Aware Proxy 对用户进行身份验证
  • 向 Google Kubernetes Engine 部署应用
  • 了解其他 Google Cloud 服务。