在 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 应用的基础设施,因此开发人员可以专注于他们的代码。其他优势包括:

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

Greeting from Java

开始之前

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

下载并安装 Java 扩展包

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

下载 Apache Maven 3 或更高版本

下载 Apache Maven

为你的本地开发环境安装 Apache Maven

安装 Apache Maven

下载并测试 Spring Boot 应用

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

注意:你可以从 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 Java 扩展包。按照说明操作并在安装后重新加载 VS Code。

Install Java Extensions

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

debug configuration in the Status bar

你可以在调试 启动配置 中了解有关 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: 登录。或者你也可以通过单击 SPRING APPS 资源管理器中的登录 Azure... 登录到你的 Azure 帐户。

Azure sign in code

在 Azure Spring Apps 上创建应用

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

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

    Create Azure Spring Apps Service instance

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

    Create App

构建并部署应用

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

mvn clean package
  1. 在 Azure 资源管理器中右键单击应用,选择部署,并在提示时选择你构建的 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

后续步骤