在 VS Code 中试用

Azure Spring Apps 上的 Java

注意:Azure Spring Apps 是 Azure Spring Cloud 服务的新名称。

本教程介绍如何使用 Visual Studio Code 创建 Java Web 应用程序。你将学习如何在本地运行、调试和编辑 Java Web 应用,然后将其部署到专为 Java 工作负载构建的完全托管的微服务平台:Azure Spring Apps

场景

我们将部署一个简单的 Spring Boot 入门 Web 应用到 Azure Spring Apps。

Azure Spring Apps 可轻松将 Spring Boot 微服务应用程序部署到 Azure,而无需任何代码更改。该服务管理 Spring Apps 应用程序的基础设施,以便开发人员可以专注于其代码。其他优势包括

  • 高效迁移现有 Spring 应用并管理云扩展和成本。
  • 使用 Spring Apps 模式对应用进行现代化改造,以提高敏捷性和交付速度。
  • 在云规模下运行 Java,并在没有复杂基础设施的情况下推动更高的使用率。
  • 无需容器化依赖即可快速开发和部署。
  • 高效且轻松地监控生产工作负载。

Greeting from Java

开始之前

在运行和部署此示例之前,你的本地开发环境上必须安装 Java SE Development Kit (JDK) 版本 11 或更高版本以及 Apache Maven 生成工具。如果尚未安装,请首先安装这些工具。

下载并安装 Extension Pack for Java

注意:必须将 JAVA_HOME 环境变量设置为 JDK 的安装位置才能完成本教程。

下载 Apache Maven 3 或更高版本

下载 Apache Maven

为本地开发环境安装 Apache Maven

安装 Apache Maven

下载并测试 Spring Boot 应用

克隆 Spring Boot Getting Started 示例项目到你的本地机器。你可以使用命令面板中的 Git: Clone 命令克隆 Git 仓库(⇧⌘P (Windows, Linux Ctrl+Shift+P))。将 https://github.com/spring-guides/gs-spring-boot.git 粘贴为远程仓库的 URL,然后决定用于存放本地仓库的父目录。之后,导航到该文件夹并在 VS Code 中打开克隆仓库中的 complete 文件夹,通过键入 code .

注意:你可以从 https://vscode.js.cn 安装 Visual Studio Code,并从 https://git-scm.cn 安装 Git。

Clone Spring Repository

在 VS Code 中,打开 complete 文件夹中的任何 Java 文件(例如 src\main\java\hello\Application.java)。如果尚未为 VS Code 安装 Java 语言扩展,系统将提示你安装 Microsoft Extension Pack for Java。按照说明进行操作,并在安装后重新加载 VS Code。

Install Java Extensions

安装 Extension Pack for Java 后,它将自动为你生成项目(生成可能需要几分钟)。你可以在 VS Code 中通过按 F5 并选择 Java 环境来运行应用程序。Java Debug 扩展将在项目的 .vscode 文件夹下为你生成一个调试配置文件 launch.json。你可以在 VS Code 状态栏中看到生成进度,并在一切完成后显示最终的活动调试配置。

debug configuration in the Status bar

你可以在 Debugging 启动配置中了解有关 VS Code 如何启动应用程序的更多信息。再次按 F5 以启动调试器。

Run Spring Boot

使用 Web 浏览器浏览到 http://localhost:8080 测试 Web 应用。你应该会看到以下消息:“Greetings from Spring Boot!”。

Greeting from Spring

进行更改

现在我们来编辑 HelloController.java,将“Greetings from Spring Boot!”更改为其他内容,例如“Hello World”。VS Code 为 Java 提供了出色的编辑体验,请参阅 编辑和导航代码 以了解 VS Code 的编辑和代码导航功能。

选择编辑器顶部的重启按钮重新启动应用,并通过重新加载浏览器查看结果。

Restart Application

调试应用程序

在应用程序源代码中设置断点(F9),然后重新加载浏览器以触发断点。

Debug Application

如果你想了解有关使用 VS Code 调试 Java 的更多信息,可以阅读 Java 调试

恭喜,你已在本地运行了你的第一个 Spring Boot Web 应用!继续阅读以了解如何在云中托管它。

部署到 Azure Spring Apps

我们刚刚构建了一个 Java Web 应用程序并在本地运行了它。现在你将学习如何从 Visual Studio Code 部署并在 Azure Spring Apps 上运行它。

安装 Azure Spring Apps 扩展

Azure Spring Apps 扩展用于创建、管理和部署到 Azure Spring Apps,主要功能包括

  • 在 Azure Spring Apps 中创建/查看/删除应用
  • 将 Jar 部署到应用
  • 通过公共/私有终结点访问应用
  • 启动、停止和重新启动应用
  • 放大/缩小、向上/向下缩放应用
  • 配置应用程序设置,如环境变量和 JVM 选项
  • 从应用流式传输日志

若要安装 Azure Spring Apps 扩展,请打开扩展视图 (⇧⌘X (Windows, Linux Ctrl+Shift+X)),并搜索 azure spring apps 以筛选结果。选择 Microsoft Azure Spring Apps 扩展。对于命令行体验,你还可以查看 使用 Azure CLI 的 Azure Spring Apps 快速入门

登录到你的 Azure 订阅

部署过程使用 Azure 帐户扩展(作为依赖项与 Spring Cloud 扩展一起安装),你需要使用你的 Azure 订阅登录。

如果你没有 Azure 订阅,可以注册一个免费 Azure 帐户

创建你的免费 Azure 帐户

要登录到 Azure,请从命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 运行 Azure: Sign In。或者,你也可以在 SPRING APPS 资源管理器中单击登录到 Azure... 来登录你的 Azure 帐户。

Azure sign in code

在 Azure Spring Apps 上创建应用

登录到 Azure 帐户并在 Visual Studio Code 中打开应用后,选择活动栏中的 Azure 图标以打开 Azure Explorer,你将看到 Azure Spring Apps 面板。

  1. 右键单击你的订阅,然后选择在门户中创建服务。完成 Azure 门户上的以下步骤以创建 Azure Spring Apps 服务实例。

    Create Azure Spring Apps Service instance

  2. 创建服务实例后,刷新 Azure Explorer 以显示新的服务实例。右键单击服务实例,然后选择创建应用。键入应用名称,选择 Java 版本,然后按 Enter 开始创建。应用将在几分钟内准备就绪。

    Create App

生成并部署应用

你可以打开命令提示符或终端窗口,并使用 Maven 命令生成项目。生成将在 target 目录中生成新的 warjar 工件。

mvn clean package
  1. 在 Azure Explorer 中右键单击应用,选择部署,并在出现提示时选择你生成的 Jar 文件。

    Deploy App

  2. 你可以在右下方查看部署状态。完成后,选择访问公共终结点以测试在 Azure 上运行的应用,并在提示分配公共终结点时选择。请注意,仅支持 Spring Boot fat Jar,详细了解 Azure Spring Apps 上的应用

    Access public endpoint

缩放应用

  1. 你可以通过右键单击缩放设置下的实例计数并选择编辑来轻松缩放应用。键入“2”并按 Enter 以缩放应用。

    Scale app

流式传输你的应用程序日志

  1. 展开应用实例节点,右键单击要查看日志的实例,然后选择开始流式传输日志

    Start log streaming

  2. Visual Studio Code 输出窗口打开,并连接到日志流。

    Log output

后续步骤