STS 中的 Spring Boot 仪表板 - 第 4 部分:使用 Cloud Foundry 清单文件
欢迎回来,Spring 社区,
最新发布的 Spring Tool Suite 3.7.3 在 Spring Boot 仪表板周围引入了一些新功能。因此,我们继续去年开始的博文系列,并向您介绍了在 IDE 中使用基于 Spring Boot 的微服务项目的新方法(您可以在底部找到以前各部分的链接)。
Cloud Foundry 清单文件
在本系列的这个新部分中,我们仔细研究了 Cloud Foundry 清单文件。它们是 Cloud Foundry 的一个概念,用作定义 Cloud Foundry 上应用程序配置的快捷方式。在执行“cf push”时,无需将每个参数和配置传递到命令行,而是可以将所有配置数据放入 YAML 文件中,然后将该文件传递到 push 命令。有关 Cloud Foundry 清单文件的更多详细信息,请参见此处。
Spring Boot 仪表板的早期版本如果项目中存在名为“manifest.yml”的文件,则已使用清单文件将应用程序部署到 CF。这是为了方便起见“在幕后”完成的。这很好用。但由于这种支持的“隐藏性质”,也引起了混淆。
部署应用程序时选择清单文件
Spring Boot 仪表板的新版本支持 Cloud Foundry 清单文件作为一等公民。当您首次从 Boot 仪表板内部将应用程序部署到 Cloud Foundry 目标时,这将开始显示。将弹出一个对话框,询问您应将哪个清单文件用于此部署操作。
此对话框允许您选择要用于部署应用程序的清单文件。这也允许您在项目中拥有多个清单文件 - 例如,用于 Cloud Foundry 上的不同空间或不同的部署环境。您还可以通过为每个部署操作选择不同的清单文件,将同一个应用程序多次部署到同一个 Cloud Foundry 目标。
该对话框显示所选清单文件的内容,以便您可以验证您选择了正确的文件。如果清单文件内部出现问题,您无需返回主 IDE 工作台,打开文件,编辑它,保存它,然后返回部署操作。而是在对话框中直接编辑清单文件内容。这使得将应用程序部署到 Cloud Foundry 变得非常容易。
启动仪表板将记住您的选择,并在您在 Cloud Foundry 上更新项目时再次使用相同的清单文件。这也意味着,下次将应用程序重新部署到 Cloud Foundry 时(例如,在启动仪表板重新启动操作期间),将考虑对清单文件所做的更改。
当然,您可以改变主意并决定选择不同的清单文件。上下文菜单中的一个操作允许您打开相同的“选择清单文件”对话框并做出不同的选择。应用程序的下次重新部署将考虑此更改。您还可以使用此对话框快速检查当前与项目关联的清单文件。
无需清单文件进行部署
有时您还没有清单文件,或者您不想使用现有的清单文件。在这种情况下,您可以在对话框中选择“手动模式”。
它将打开一个临时清单文件的编辑区域,并使用一些默认内容填充它。您可以编辑此临时清单内容,添加属性或更改现有属性。这允许您完全定义应用程序应如何部署到 Cloud Foundry。
该临时清单的内容不会存储在任何地方(我们可能会添加一个便利选项以快速将手动输入的清单内容保存到新文件),并且 IDE 不会在您下次更新 Cloud Foundry 上的应用程序时记住它。相反,Cloud Foundry 上的现有配置将保留并用于更新应用程序。
如果您过去使用过清单文件,然后决定切换到手动模式,情况也是如此。后续对应用程序的更新将保持 Cloud Foundry 上的配置不变。
CF 上已更改的配置
假设您已使用清单文件从 Boot 仪表板内部将应用程序部署到 Cloud Foundry。然后,您转到 Web 控制台并将服务添加到已部署的应用程序 - 或更改内存设置,将其扩展,或对配置进行类似的更改。如果您返回 Boot 仪表板,也许更改应用程序的一些代码,然后重新启动(因此更新)Cloud Foundry 上的应用程序,则 Boot 仪表板将再次使用清单文件 - 并丢弃您在 CF 上对配置所做的所有更改。为了避免这种情况,Boot 仪表板在重新部署使用清单文件的应用程序时会检查 Cloud Foundry 上的配置更改。如果发现配置不匹配,它将打开一个差异和合并对话框 - 并显示详细的更改。
此功能可防止您意外覆盖配置更改。它是一个功能强大的对话框,允许您将 CF 上的配置更改合并到您的本地清单文件中。您可以合并单个更改以及所有更改。这使得使用这些更改更新本地清单文件变得容易,并且您可以在将来更新应用程序时继续使用清单文件。
如果您不希望 CF 上的这些配置更改反映在您的本地清单文件中,请选择“忘记清单”按钮,Boot 仪表板将保持 Cloud Foundry 上的配置不变。它将应用程序切换到“手动模式”部署。
同样,如果您想明确更改这些设置,请转到上下文菜单并选择“选择清单”操作。
编辑清单文件
虽然 Cloud Foundry 清单文件是配置 Cloud Foundry 应用程序的一种简洁明了的方式,但编辑这些文件可能很麻烦。幸运的是,最新版本的 Spring Tool Suite 带有一个专门用于 Cloud Foundry 清单文件的编辑器。
它为属性名称和选定的属性值提供了良好的内容辅助。
如果将鼠标悬停在属性上,您将获得有关属性的更多帮助以及如何以及何时使用它的示例。
在键入时也会验证文件。协调错误将以与在 Spring Boot 属性文件或编辑 Java 代码时相同的方式直接显示在编辑器中。
好消息是:这种高级编辑支持也适用于“选择清单文件”对话框(例如,在处理手动清单或更改所选清单文件内容时)。
即将推出
本博文系列的下一部分将介绍对本地 Spring Boot 应用程序使用多个启动配置的新支持。敬请期待。
Spring Boot 仪表板博文系列
- STS 中的 Spring Boot 仪表板 - 第 1 部分:本地 Boot 应用程序
- STS 中的 Spring Boot 仪表板 - 第 2 部分:使用 Cloud Foundry
- STS 中的 Spring Boot 仪表板 - 第 3 部分:Spring Boot Devtools 重新加载
如果您碰巧在 5 月中旬在巴塞罗那(无论如何,在巴塞罗那总是不会太糟糕!),不要错过加入Spring I/O 大会的机会,我将在那里介绍 Spring 的最新和最棒的功能。此外,SpringOne Platform(8 月初,拉斯维加斯)的注册最近已经开放,如果您想享受早鸟票价,可以考虑一下。