欢迎回到 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 的早期版本已经使用清单文件将应用程序部署到 CF,前提是项目中存在名为“manifest.yml”的文件。这是为了您的方便而“在幕后”完成的。这很好也很实用。但这种支持的“隐藏性”也造成了一些困惑。
部署应用程序时选择清单文件
新版本的 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 博客系列