教程:创建应用的示例

在本教程中,您将学习如何创建 Helm Chart 并将其推送到仓库。该仓库可用作 Rancher 中自定义应用商店的源。

您可以把 Helm Chart 或 Rancher Chart 添加到应用商店里,但是我们建议使用 Rancher Chart,因为它们的用户体验更好。

注意: 有关开发 Chart 的完整步骤,请参阅 Helm Chart 开发指南

  1. 在您应用商店的 GitHub 仓库中,创建应用商店结构,该应用商店结构请参考应用商店的文件结构中列出的结构。app-readme.mdquestions.yml是可选的。

    提示:

  2. 推荐: 创建一个app-readme.md文件。

    使用此文件可为 Rancher UI 中的 chart 标题创建自定义文本。您可以使用此文本来通知用户该 chart 是针对您的环境定制的,或者提供有关如何使用它的特殊说明。

    例如

    ``` $ cat ./app-readme.md

  1. # Wordpress ROCKS!
  2. ```
  1. 推荐: 添加一个questions.yml文件。

    该文件为用户创建一个表单,供用户在部署自定义 Chart 时指定部署参数。如果没有此文件,则用户必须使用键值对手动指定参数,这对用户不友好。

    下面的示例创建一个表单,提示用户输入持久卷大小和存储类。

    有关创建questions.yml文件时可以使用的变量列表,请参见问题变量参考

    1. categories:
    2. - Blog
    3. - CMS
    4. questions:
    5. - variable: persistence.enabled
    6. default: "false"
    7. description: "Enable persistent volume for WordPress"
    8. type: boolean
    9. required: true
    10. label: WordPress Persistent Volume Enabled
    11. show_subquestion_if: true
    12. group: "WordPress Settings"
    13. subquestions:
    14. - variable: persistence.size
    15. default: "10Gi"
    16. description: "WordPress Persistent Volume Size"
    17. type: string
    18. label: WordPress Volume Size
    19. - variable: persistence.storageClass
    20. default: ""
    21. description: "If undefined or null, uses the default StorageClass. Default to null"
    22. type: storageclass
    23. label: Default StorageClass for WordPress
  2. 将自定义的 Chart 推送到 GitHub 仓库中。

结果: 您的自定义 Chart 已添加到仓库中。您的 Rancher Server 将在几分钟内同步 Chart。您可以在 Rancher UI 上手动刷新该应用商店,强制刷新。