使用现有应用

如果您已使用 Kubernetes 清单、Dockerfile 或 Jib 配置了某一现有项目以构建映像,则可以打开这个应用,并将其与该插件一起使用。唯一需要增加的一项配置是 Skaffold YAML 文件,您可以让系统自动为您生成此文件,或使用提供的模板自行创建。

在完成 Skaffold YAML 配置后,请务必指定容器映像的存储位置,也就是即将推送项目映像的位置。

自动项目引导

如果 Cloud Code 未检测到现有的 Skaffold 配置,系统会提示您进行设置:

  • 如果您的项目具有 Dockerfile、已进行 Jib 配置或可使用 Buildpack 进行构建,并且具有 Kubernetes 资源,则 Cloud Code 会提示您创建一个 skaffold.yaml 文件(如果尚不存在)以及必要的运行配置。

    包含用于创建 Cloud Code Kubernetes 运行配置的链接的通知

  • 如果可能,点击此通知将自动创建您的配置。

    如果由于检测到多个映像或构建器而无法自动创建 Skaffold 配置,Cloud Code 会显示一个对话框,要求您在检测到的映像和构建器之间提供映射。

    指定要在 Skaffold 配置中使用的构建设置

或者,您也可以使用“添加 Kubernetes 支持”菜单选项设置 Skaffold 配置:

  • 导航到 Tools > Cloud Code > Kubernetes,然后选择 Add Kubernetes Support。此选项会分析项目的 Kubernetes 资源,并生成 skaffold.yaml 文件(如果此文件尚不存在)以及必要的运行配置。生成的两项运行配置一个用于在 Kubernetes 上运行项目,另一个用于在 Kubernetes 集群上进行开发。
  • 添加支持后,您可以使用新添加的运行配置立即开始在 Kubernetes 上运行和调试您的项目。

手动创建 Cloud Code Skaffold 配置

您可以选择手动创建一个新的 skaffold.yaml 文件,也可以将现有文件添加到项目中。

要手动创建 Skaffold YAML,请按照以下说明来利用实时模板支持:

  • 在项目的根目录中创建名为 skaffold.yaml 的新文件(右键点击 > 新建 > 文件)。
  • 将光标移到新文件中,使用 Ctrl+Space 弹出实时模板建议,然后选择所需的 Skaffold 模板。

    使用 Skaffold YAML 模板

  • 使用项目映像名称填充 image 字段,使用您希望从 IDE 部署的 Kubernetes 资源列表填充 manifests 字段。

    基于 Dockerfile 的构建示例:

    build:
      artifacts:
        - image: image_name
    deploy:
      kubectl:
        manifests:
          - k8s/web.yaml
          - k8s/backend.yaml
    

    使用 Jib 插件的 Java Maven/Gradle 项目的示例构建部分(部署部分保持不变):

    build:
    artifacts:
    - image: image_name
      jib: {}
    
  • 一旦 skaffold.yaml 生效,该插件将提示您自动创建 Kubernetes 运行目标。

    创建 Kubernetes 运行目标的通知

指定容器映像的存储位置

容器映像存储

在部署应用之前,您需要定义一个默认映像存储区以用于您的项目。

默认情况下,项目配置为使用 Kubernetes 清单中指定的映像名称。您还可以自定义此映像规范。设置好首选存储区(Google Container RegistryDockerHub、私有代码库等)后,修改运行目标,并将其指定为运行目标设置中的默认映像存储区。 对于 Google Container Registry 映像,该字段配备了自动补全功能,可帮助您更快地找到 Container Registry 存储区。

这些信息可从“Run/Debug configurations”对话框的顶部任务栏访问,位于 Edit Configurations... > Develop on Kubernetes > Where are the container images stored?.

使用“gcr.io/”格式设置运行配置中的默认映像存储区,并根据当前项目和活跃集群显示自动补全选项

如需详细了解如何指定容器映像偏好设置,请参阅配置容器映像设置指南

构建设置

设置容器映像后,可以配置其构建设置。Cloud Code 支持 Docker、Jib 和 Buildpacks 工件类型。

在运行配置设置的“Build/Deploy”标签页中(Edit Configurations...> Develop on KubernetesRun on Kubernetes),您可以为默认配置文件配置构建设置。

“Build/Deploy”标签页中显示的构建设置

如需详细了解如何指定映像的构建设置,请参阅配置容器映像构建偏好设置指南

获取支持

如需发送反馈,请在 GitHub 上报告问题,或者在 Stack Overflow 上提问。