使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。
快速入门:使用 Cloud Code for VS Code 部署 Kubernetes 应用

使用 Cloud Code for VS Code 部署 Kubernetes 应用

本页面介绍如何快速开始使用 Cloud Code。

您将使用“Hello World”示例应用创建新的 Kubernetes 应用,创建集群,在该集群上运行您的应用,调试正在运行的代码,查看来自运行中应用的日志,并将终端连接到正在运行的容器。

如果您在 Apple M 系列芯片上运行本快速入门,您的应用会使用 Cloud Build 构建,这可能会产生费用。如需了解详情,请参阅对 Apple M 系列芯片的 Cloud Code 支持

开始前须知

  1. 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  3. 确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能

  4. 启用 Google Kubernetes Engine API。

    启用 API

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

    转到“项目选择器”

  6. 确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能

  7. 启用 Google Kubernetes Engine API。

    启用 API

  8. 安装 Git。 必须使用 Git 才能将示例复制到您的机器上。

安装 Cloud Code

  1. 在您的机器上安装 Visual Studio Code(如果尚未安装)。

  2. 对于所有 Cloud 平台,请在机器的 PATH 上(通过 Docker 注册表进行身份验证)安装 Docker 客户端(其安装文件夹应显示在 PATH 中的某一目录下)。

    • 如需检查您是否已安装 Docker,请运行 docker -v
    • 如果您使用的是 Windows Home,请参阅在 Windows Home 上安装 Docker Desktop
    • 如果您使用的是 WSL,但无法安装桌面版 Docker,请改用 Minikube 通过 Cloud Code 进行本地开发。

    Cloud Code 会自动安装 kubectl、Skaffold 和 gcloud CLI。

  3. 使用以下选项之一安装 Cloud Code:

    • 打开 VS Code 并安装 Cloud Code
    • 在计算机上打开 Visual Studio Code。 使用 VS Code 中的扩展程序视图 扩展程序图标(其左侧任务栏应带有方形图标),搜索并点击 Cloud Code 扩展程序,然后点击安装

    如果您在 Apple M 系列芯片上运行 Cloud Code for VS Code,系统会提示您安装 Rosetta 2 或停用 Auto 依赖项,这要求您 Rosetta 2 在您的系统上运行。

    安装完成后,您将看到 Cloud Code 欢迎页面和“ Starter Apps”下的一系列示例应用,可用于快速设置新应用。VS Code 状态栏中提供了 Cloud Code 状态栏,其中包含常见的 Cloud Code 操作。

创建应用

  1. 在 Command Palette(按 Cmd/Ctrl+Shift+P)中,运行 Cloud Code: New Application,然后选择 Kubernetes Application

  2. 选择您想使用的语言的 Hello World 应用。

    例如,选择 Node.js: Hello World 会创建一个起始 Node.js 版 Hello World 应用。

  3. 保存新应用。

    系统会显示一条通知,确认您的应用已创建,并且系统会打开一个包含您应用的新窗口。

创建 GKE 集群

如需创建标准 Google Kubernetes Engine (GKE) 集群,请按照以下步骤操作:

  1. 如需打开 Kubernetes Explorer,请点击 Kubernetes Explorer 图标 Cloud Code - Kubernetes
  2. 在 Kubernetes Explorer 窗格的标头中,点击 + Add a Cluster to KubeConfig
  3. 选择 Google Kubernetes Engine,然后点击 + 创建新的 GKE 集群 (+ Create a new GKE Cluster)。
  4. 选择标准作为集群类型。
  5. 点击打开以允许 Cloud Code 打开 Cloud Console。
  6. 在 Cloud Console 中,使用您创建的项目,将区域设置为 us-central1-a,并将集群名称设置为 my-first-cluster
  7. 点击创建。集群创建需要几分钟时间才能完成。
  8. 创建集群后,在 Kubernetes Explorer 中,点击刷新 Kubernetes 集群视图刷新
  9. 新集群的名称显示在列表中后,点击集群名称。您的新集群会添加到配置中并配置为活跃上下文。

运行和查看应用

现在,一切都已设置完毕,接下来,您可以运行应用并实时查看应用。Cloud Code 会监控您的文件系统中的更改,以便您可以近乎实时地修改并重新运行应用。

如需运行您的应用,请按以下步骤操作:

  1. 使用 Cloud Code 状态栏并选择 Run on Kubernetes
  2. 确认要使用当前集群上下文还是切换到其他上下文。
  3. 如果出现提示,请选择要将映像推送到的映像注册表。

    系统会显示输出窗口,您可以在其中跟踪正在运行的应用的进度。您还会在终端输出中看到来自正在运行的 pod 的日志实时流。

  4. 应用在 Kubernetes 上运行后,输出窗口会显示 IP 地址。如需使用此关联的 IP 地址访问您的应用,请按 Ctrl/Cmd 并点击该地址。

问题排查提示

如果您使用的是现有集群,要将集群设置为活跃状态并使用 Kubernetes Explorer 获取集群凭据,请按照以下步骤操作:

  1. 如需打开 Kubernetes Explorer,请点击左侧的 VS Code 活动栏中的 Cloud Code - Kubernetes Kubernetes Explorer 图标 图标。
  2. 在 Kubernetes Explorer 中,右键点击您的集群名称,然后点击设置为活跃集群

调试应用

如需调试您的应用,请按以下步骤操作:

  1. 使用 Cloud Code 状态栏,然后选择 Debug on Kubernetes
  2. 如果出现提示,请确认是使用当前集群上下文还是切换到首选集群上下文。

    Cloud Code 会在 .vscode/launch.json 文件中使用 cloudcode.kubernetes 配置来运行应用并为其连接调试程序会话。

    Cloud Code 会构建您的容器,将容器推送到注册表,将 Kubernetes 配置应用到集群,并返回可用于浏览运行中应用的 IP 地址。

  3. 在连接调试程序会话之前,系统会提示您确认或进入远程容器(该目录位于可调试的程序)中或按 Esc 键以跳过调试容器。

  4. 如需向第 9 行添加断点,请打开 src/app.js,然后点击编辑器边距。

    红色实心圆表示活跃断点,而灰色空心圆表示已停用的断点。如需更精细地控制断点,您可以使用 VS Code 的“Debug”视图中的“Breakpoints”部分。

    调试视图左侧面板中的“断点”部分,可用于添加、移除和停用断点

    当您向应用发送新请求时,调试程序将在第一个活动断点暂停。

    在以下示例中,在“变量”部分的本地下,注意 Hello, world!res._contentLength; 值为 13。

    应用已在断点暂停,并且变量和调用堆栈部分已填充范围内的值

  5. 修改第 8 行发送到 Hello, goodbye! 的字符串,然后重启 Debug on Kubernetes 操作。

    重新构建并重新部署应用后,请记下 res._contentLength 的更新值。

    应用已在断点暂停,并使用了更新后的值

调试会话开始后,开发会话窗格便会显示结构化日志记录视图。任务开始后,系统会显示一个旋转的半圆形图标 进度图标

如果任务成功,该步骤旁边会显示一个绿色对勾标记 成功图标

要查看某个步骤的详细信息,请点击开发会话窗格中的步骤。“输出”窗格会显示日志记录输出中的步骤。

在容器中打开终端

如需在容器中打开终端,请按照以下说明操作:

  1. 如需打开 Kubernetes Explorer,请点击 Kubernetes Explorer 图标 Cloud Code - Kubernetes
  2. 选择集群,然后从底层 Pod 部分中,连接到要连接的 Pod。
  3. 在指定的 pod 下,展开容器部分。
  4. 右键点击要打开终端的容器,然后点击获取终端

    这将启动终端。您现在可以访问正在运行的容器内的 shell。

清理

终止应用后,系统会自动删除运行期间部署的所有 Kubernetes 资源。

为避免系统因本快速入门中使用的其他资源向您的帐号收取费用,请务必删除您创建的集群和项目。

如果您使用的是 Google Cloud 并且只想删除集群,可按照以下步骤操作:

  1. 在 Kubernetes Explorer 中,将鼠标悬停在集群名称上,然后点击 “在 Cloud Console 中打开”图标 在 Cloud Console 中打开 (Open in Cloud Console)。
  2. 点击删除,然后点击删除

如需删除项目(以及关联的资源,包括所有集群),请运行以下命令:

  1. 转到 Cloud Console 中的“项目”页面:

    转到“项目”页面

  2. 选择您为本快速入门创建的项目,然后点击删除

  3. 输入要确认的项目 ID,然后点击关停

    此操作会关停该项目,并安排将其删除。

后续步骤