在 Cloud Code for IntelliJ 中使用 Google Cloud 和 Kubernetes YAML 文件

Cloud Code 旨在帮助修改与 Google Cloud 和 Kubernetes 相关的配置文件,包括基于架构的验证文档、 诊断文档和快速文档。

的文件

支持的 YAML 配置文件

此外,Cloud Code 还支持常用的 Kubernetes CRD,例如 Kubeflow,开箱即用。

启用或停用 YAML 支持

如需启用或停用 YAML 支持,请依次前往 文件 > 设置 > 工具 > Gemini + Google Cloud Code > Kubernetes (对于 Windows 和 Linux)或 IntelliJ IDEA > 设置 > 工具 > Gemini + Google Cloud Code > Kubernetes (对于 macOS),然后选中或取消选中 启用 YAML 支持 复选框以启用或停用该功能。

使用自定义架构

借助 Cloud Code,您可以通过 IntelliJ 设置提供自己的 CRD 架构,方法是依次前往 文件 > 设置 > 工具 > Gemini + Google Cloud Code > Kubernetes (对于 Windows 和 Linux)或 IntelliJ IDEA > 设置 > 工具 > Gemini + Google Cloud Code > Kubernetes (对于 macOS),然后参阅 CRD 架构 位置 部分。

您可以指向本地文件或网址。指向 github.com 的网址会自动转换为 raw.githubusercontent.com

从集群中拉取架构

Kubernetes Explorer中切换到运行 Kubernetes v1.16+ 的集群时, Cloud Code 会自动拉取所有已安装的 CRD 的架构。

其他 Skaffold 支持

Skaffold 是支持 Cloud Code 的底层引擎,可帮助您构建、推送和部署应用 ,以及支持创建 CI/CD 流水线。

Cloud Code 提供对管理 Skaffold 配置文件的额外支持。在打开项目时,Cloud Code 会检测不是最新的 Skaffold 架构,并会在有适用于现有 Skaffold YAML 配置文件的 Skaffold 架构版本升级可用时提示您(通过事件日志)。

事件日志中的通知,用于提示用户升级其 Skaffold YAML 版本,因为他们现有的 Skaffold YAML 文件不是最新版本

或者,您也可以依次前往工具 > Gemini + Cloud Code > Kubernetes > 检查 Skaffold 架构 升级,以检查可用的架构升级。

使用代码段进行配置

借助针对常用 YAML 架构的开箱即用代码段(使用 Ctrl+Space 即可 查看选项),您可以轻松启动新的 YAML 文件或向现有的 YAML 文件添加内容 而不会产生错误,同时仍然遵循最佳实践。此外,还可以轻松处理重复字段;您只需填写一个字段,Cloud Code 会填写其余的实例。

使用代码段处理重复字段

Cloud Code 提供以下代码段:

  • Cloud Build - Cloud Run deployment
  • Cloud Build - Docker container build
  • Cloud Build - GKE deployment
  • Cloud Build - GKE Skaffold deployment
  • Cloud Build - Go build
  • Cloud Build - Terraform plan + apply
  • Config Connector - BigQueryDataset
  • Config Connector - BigQueryTable
  • Config Connector - BigtableCluster
  • Config Connector - BigtableInstance
  • Config Connector - PubSubSubscription
  • Config Connector - PubSubTopic
  • Config Connector - RedisInstance
  • Config Connector - SpannerInstance
  • Kubernetes - ConfigMap
  • Kubernetes - Deployment
  • Kubernetes - Ingress
  • Kubernetes - Pod
  • Kubernetes - Service
  • Migrate to Containers - Export
  • Migrate to Containers - PersistentVolumeClaim
  • Migrate to Containers - StatefulSet
  • Skaffold - Bazel
  • Skaffold - Getting-started
  • Skaffold - Helm deployment
  • Skaffold - Kaniko

借助上下文补全

Cloud Code 将根据当前架构提供上下文补全信息,以帮助您选择合适的选项。

针对 Kubernetes 架构补全上下文

验证 YAML 架构

Cloud Code 通过标记 YAML 文件中的无效标记和值并尽可能给出修正建议,来提供架构验证支持。

名称字段的值带红色下划线以突出显示无效值“1234”;悬停文字状态:“类型错误。预期字符串。

验证 Skaffold YAML 文件

Cloud Code 支持修改其他 Skaffold 配置文件,还提供智能模板,使您可以验证 skaffold.yaml 文件。请参阅这份关于将现有应用与 Cloud Code 搭配使用的指南

Skaffold yaml 模板

借助上下文补全 Skaffold 配置文件

Cloud Code 将根据当前架构提供上下文补全信息和相关文档,以帮助您选择正确的选项。

Skaffold 补全信息

使用快速文档探索定义

如果您选中配置文件中的一行并依次前往查看 > 快速文档 ,Cloud Code 会显示资源的相关文档。

快速文档

针对结构和有效性问题对 YAML 执行 lint 请求

Cloud Code 提供有关常见架构问题的 Lint 支持,并提供描述性错误。

对 YAML 文件执行 lint 请求

应用 YAML 文件

如需运行 kubectl apply -f 以使用当前 文件应用配置更改,您可以使用 IDE 的间距中显示的 kubectl 操作图标 kubectl 操作图标, 然后选择 应用。系统会显示一个差异视图,让您可以在点击应用 前查看更改。

kubectl 操作列表中突出显示的“应用”选项

YAML 文件之间的差异

如需查看源代码控制系统中的 YAML 文件与已部署的 YAML 文件之间的差异,您可以使用编辑器的间距中显示的 kubectl 操作图标 kubectl 操作图标 。选择差异 选项可显示一个差异视图,供您比较和对比两种架构文件。

kubectl 操作列表中突出显示的“差异”选项

对 YAML 文件执行试运行

如需对文件执行试运行并检查其有效性,您可以使用 kubectl 操作图标 kubectl 操作图标, IDE 的间距中显示的,来选择 在服务器上试运行在客户端上试运行。这将运行 kubectl apply -f dry-run=server (对于客户端选项,则为 kubectl apply -f dry-run=client),并会通知您 是否可以在终端窗口中成功创建文件。

kubectl 操作列表中突出显示的“在服务器上试运行”(Dry-run on Server) 选项

后续步骤

获取支持

如需在 IntelliJ IDE 中提交反馈或报告问题,请依次前往 工具 > Cloud Code > 帮助 / 简介 > 提交 反馈或报告问题,在 GitHub 上报告问题。