Spring 社区的各位,欢迎回来,
Spring Tool Suite 的最新版本 3.7.3 引入了许多与 Spring Boot Dashboard 相关的新功能。因此,我们继续去年开始的博客系列文章,向您介绍了在 IDE 中使用基于 Spring Boot 的微服务项目的新方法(您可以在底部找到之前部分的链接)。
Cloud Foundry 清单文件
在本系列的新部分中,我们将仔细研究 Cloud Foundry 清单文件。它们是 Cloud Foundry 的概念,用作定义 Cloud Foundry 上应用程序配置的快捷方式。在执行 “cf push” 时,您无需将每个参数和配置传递给命令行,而是可以将所有配置数据放入一个 YAML 文件中,然后将其传递给 push 命令。有关 Cloud Foundry 清单文件的更详细信息可在此处找到。
Spring Boot Dashboard 的早期版本已经在项目中存在名为“manifest.yml”的文件时使用该清单文件将应用程序部署到 CF。这是为了您的方便而“在幕后”完成的。这很好用且有用。但由于这种支持的“隐藏性”,也造成了一些困惑。
部署应用程序时选择清单文件
Spring Boot Dashboard 的新版本将 Cloud Foundry 清单文件作为一级公民来支持。当您第一次从 Boot Dashboard 中将应用程序部署到 Cloud Foundry 目标时,这一点就会显现出来。会弹出一个对话框,询问您应该使用哪个清单文件进行此部署操作。
这个对话框允许您选择用于部署应用程序的清单文件。这也允许您的项目中拥有多个清单文件,例如用于 Cloud Foundry 上的不同空间或不同的部署环境。您还可以通过为每次部署操作选择不同的清单文件,将同一个应用程序多次部署到同一个 Cloud Foundry 目标。
对话框显示了选定清单文件的内容,以便您可以验证是否选择了正确的文件。如果清单文件内部有问题,您无需返回主 IDE 工作台,打开文件,编辑,保存,然后再返回部署操作。您可以直接在对话框内编辑清单文件内容。这使得将应用程序部署到 Cloud Foundry 变得非常容易。
Boot Dashboard 将记住您的选择,如果您在 Cloud Foundry 上更新项目,它将再次使用相同的清单文件。这也意味着对清单文件的更改将在下次应用程序重新部署到 Cloud Foundry 时生效(例如,在 Boot Dashboard 重启操作期间)。
当然,您可以改变主意并决定选择不同的清单文件。上下文菜单中的一个操作允许您打开相同的“选择清单文件”对话框并进行不同的选择。应用程序的下一次重新部署将考虑此更改。您还可以使用此对话框快速查看当前与项目关联的清单文件。
不使用清单文件进行部署
有时您可能还没有清单文件,或者您不想使用现有的清单文件。在这种情况下,您可以在对话框中选择“手动模式”。
它会打开一个临时清单文件的编辑区域,并填充一些默认内容。您可以编辑此临时清单内容,添加属性或更改现有属性。这使您可以完全定义应用程序应如何部署到 Cloud Foundry。
该临时清单的内容不会存储在任何地方(我们可能会添加一个方便的选项,以便快速将手动输入的清单内容保存到新文件中),并且 IDE 不会记住它供您下次在 Cloud Foundry 上更新应用程序时使用。相反,更新应用程序时将保留和使用 Cloud Foundry 上的现有配置。
如果您过去使用过清单文件,然后决定切换到手动模式,情况也是如此。后续对应用程序的更新将保持 Cloud Foundry 上的配置不变。
CF 上的配置更改
假设您使用清单文件从 Boot Dashboard 将应用程序部署到 Cloud Foundry。然后您转到 Web 控制台并为已部署的应用程序添加服务,或者更改内存设置,扩展其规模,或对配置进行类似更改。如果您回到 Boot Dashboard,可能修改了一些应用程序代码,然后在 Cloud Foundry 上重启(因此更新)应用程序,Boot Dashboard 将会再次使用清单文件,并丢弃您在 CF 上进行的所有配置更改。为了避免这种情况,Boot Dashboard 在重新部署使用清单文件的应用程序时会检查 Cloud Foundry 上的配置更改。如果发现配置不匹配,它会打开一个差异和合并对话框,并显示详细的更改。
此功能可防止您意外覆盖配置更改。这是一个强大的对话框,允许您将 CF 上的配置更改合并到本地清单文件。您可以合并单个更改,也可以一次性合并所有更改。这使得使用这些更改轻松更新本地清单文件成为可能,并且您将来更新应用程序时可以继续使用该清单文件。
如果您不想将 CF 上的这些配置更改反映到本地清单文件中,请选择“忽略清单”按钮,Boot Dashboard 将保持 Cloud Foundry 上的配置不变。它会将应用程序切换到“手动模式”部署。
同样,如果您想显式更改这些设置,请转到上下文菜单并选择“选择清单”操作。
编辑清单文件
尽管 Cloud Foundry 清单文件是为 Cloud Foundry 配置应用程序的一种简洁明了的方式,但编辑这些文件可能很麻烦。幸运的是,新版本的 Spring Tool Suite 附带了一个专门用于 Cloud Foundry 清单文件的编辑器。
如果将鼠标悬停在属性上,您将获得有关该属性的额外帮助以及如何以及何时使用的示例。
文件在键入时也会进行验证。一致性错误会直接显示在编辑器中,就像在 Spring Boot 属性文件或编辑 Java 代码时一样。
好消息是:这种高级编辑支持在“选择清单文件”对话框中也可用(例如,处理手动清单或更改选定清单文件内容时)。
即将推出
本博客系列的下一部分将介绍本地 Spring Boot 应用程序使用多个启动配置的新支持。敬请关注。
Spring Boot Dashboard 博客系列