🚀 在 VS Code 中

Azure Spring Apps 上的 Java

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

本教程演示如何使用 Visual Studio Code 创建 Java Web 应用程序。您将学习如何在本地以及完全托管的专为 Java 工作负载构建的微服务平台:Azure Spring Apps 上运行、调试和编辑 Java Web 应用。

场景

我们将部署一个简单的 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 构建工具。如果您尚未安装它们,请先安装这些工具。

下载并安装 Java 扩展包

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

下载 Apache Maven 3 或更高版本

下载 Apache Maven

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

安装 Apache Maven

下载并测试 Spring Boot 应用

Spring Boot Getting Started 示例项目克隆到本地计算机。您可以使用命令面板⇧⌘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 浏览器浏览到 https://127.0.0.1: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 Account 扩展(与 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

后续步骤