Каталог Rancher

Кураторская коллекция улучшенных диаграмм Helm 3 Rancher 2.0. Чтобы узнать, как каталоги добавляются и используются в Rancher 2.0, ознакомьтесь со страницей документации (https://rancher.com/docs/rancher/v2.x/en/concepts/catalogs/).

Примечание: Это относится к диаграммам Helm 3 и добавляется в Rancher для развёртывания с помощью Helm3.

Структура диаграммы Rancher

Репозиторий диаграмм Rancher немного отличается по структуре каталогов от репозиториев upstream тем, что включает каталог app version. Хотя Rancher также может использовать собственные репозитории Helm.

Диаграмма Rancher также имеет два дополнительных файла: файл app-readme.md, который предоставляет обзор высокого уровня в пользовательском интерфейсе Rancher 2.0, и файл questions.yml, определяющий вопросы для запроса у пользователя.

charts/wordpress/<app version>/
  app-readme.md            # Rancher Specific: Readme file for display in Rancher 2.0 UI
  charts/                  # Directory containing dependency charts
  Chart.yaml               # Required Helm chart information file
  questions.yml            # Rancher Specific: File containing questions for Rancher 2.0 UI
  README.md                # Optional: Helm Readme file (will be rendered in Rancher 2.0 UI as well)
  requirements.yaml        # Optional YAML file listing dependencies for the chart
  templates/               # A directory of templates that, when combined with values.yaml will generate K8s YAML
  values.yaml              # The default configuration values for this chart

См. справочное руководство разработчика по диаграммам upstream Helm (https://helm.sh/docs/chart_template_guide/) для полного ознакомления с разработкой диаграмм.

Чтобы преобразовать диаграмму upstream, чтобы воспользоваться расширенным UX Rancher, сначала создайте файл app-readme.md в корне вашей диаграммы.

$ cat ./app-readme.md

# Wordpress ROCKS!

Затем добавьте файл questions.yml для запроса чего-либо у пользователя.

categories:
- Blog
- CMS
questions:
- variable: persistence.enabled
  default: "false"
  description: "Enable persistent volume for WordPress"
  type: boolean
  required: true
  label: WordPress Persistent Volume Enabled
  show_subquestion_if: true
  group: "WordPress Settings"
  subquestions:
  - variable: persistence.size
    default: "10Gi"
    description: "WordPress Persistent Volume Size"
    type: string
    label: WordPress Volume Size
  - variable: persistence.storageClass
    default: ""
    description: "If undefined or null, uses the default StorageClass. Default to null"
    type: storageclass
    label: Default StorageClass for WordPress

Приведённый выше код предложит пользователю переключатель «истина / ложь» в пользовательском интерфейсе для включения постоянного хранилища. Если пользователь решит включить постоянное хранилище, ему будет предложено указать класс хранения и размер тома.

Вышеупомянутый файл также содержит список категорий, к которым относится эта диаграмма. Это помогает пользователям ориентироваться и фильтровать при просмотре пользовательского интерфейса каталога.

Справочная таблица переменных вопросов