Devtron K8s Dashboard
  • Getting Started
    • Overview of Dashboard
    • Prerequisites
    • Install Modern Kubernetes Dashboard
  • User Guide
    • Explore Kubernetes Resources
      • Overview Page
      • Discover and Manage Resources
      • Nodes and Operations
      • Pod Management and Debugging
      • Cluster Terminal
      • Add Monitoring Dashboards/Graphs
      • Run Kubectl Commands Locally
    • Use Resource Watcher
    • Manage Helm Apps
    • Manage Argo CD Apps
    • Manage Flux CD Apps
    • Chart Store
      • Examples
        • Deploying MySQL Helm Chart
        • Deploying MongoDB Helm Chart
  • Operator Guide
    • Projects
    • Clusters
    • OCI Registry
    • Chart Repositories
    • Manage Authorization (RBAC)
      • SSO Login Services
        • Google
        • GitHub
        • GitLab
        • Microsoft
        • LDAP
        • OIDC
          • Keycloak
          • Okta
        • OpenShift
      • User Permissions
      • Permission Groups
      • API Tokens
    • External Links
    • Catalog Framework
    • Charts and Chart Store
    • Show/Hide Argo CD App Listing
    • Show/Hide Flux CD App Listing
    • Configure GUI Schema for Manifests
    • Configure Lock Schema for Manifests
  • Resources
    • Glossary
    • FAQ
Powered by GitBook
On this page
  • Introduction
  • Defining a Schema
  • Filling the Schema-Generated Form
Export as PDF
  1. Operator Guide

Catalog Framework

PreviousExternal LinksNextCharts and Chart Store

Last updated 6 months ago

Introduction

Ideally, all resources such as microservices, clusters, jobs, pods, etc. should contain detailed information so that its users know what each of those resources do, how to use them, as well as all their technical specs. Access to such data makes it easier for engineers to quickly discover and understand the relevant resources.

To achieve this, Devtron supports a feature known as Catalog Framework. Using this, you as a can decide the data you expect from the managers of different resource types. In other words, you can create a custom that would ultimately render a form for the resource owners to fill. Once the form is filled, a GUI output will appear as shown below.

Sample Catalog Data for a Cluster

Currently, Modern Kubernetes Dashboard supports catalog framework for the following resource types (a.k.a. resource kind):

There are two parts involved in the creation of a desirable resource catalog:


Defining a Schema

Who Can Perform This Action?

Only a super-admin can create/edit a schema.

  1. Go to Global Configurations → Catalog Framework.

  2. Choose a resource type, for which you wish to define a schema, for e.g., Helm applications.

  3. You can edit the schema name and description.

  4. There is a sample schema available for you to create your own customized schema. Using this schema, you can decide the input types that renders within the form, for e.g., a dropdown of enum values, a boolean toggle button, text field, label, and many more.

  5. After defining your schema, click Review Changes.

  6. You get a side-by-side comparison (diff) highlighting the changes you made.

  7. Click Save.

Similarly, you can define schemas for other resource types.

Note: If you edit a field (of an existing schema) for which users have already filled the data, that data will be erased. You will receive a prompt (as shown below) to confirm whether you want to proceed with the changes.


Filling the Schema-Generated Form

Once a catalog schema exists for a resource type, its corresponding form would be available in the overview section of that resource type.

  1. Since we defined a schema for Helm applications in the above example, go to the Overview tab of your application (any Helm application). Click the Edit button within the About section.

  2. The schema created for Helm applications would render into an empty form as shown below.

  3. Fill as many details as an application owner to the best of your knowledge and click Save.

  4. Your saved data would be visible in a GUI format (and also in JSON format) as shown below.

This catalog data would be visible to all the users who have access to the application, but its data can be edited only by the resource owners (in this case, application admin/managers).

Sample Catalog Data for a Helm App

Figure 1: Choosing a Schema
Figure 2a: Using Sample Schema
Figure 2b: Expected Future Output
Figure 3: Change Diff
Figure 4: Indication of Existing Data
Figure 5: Unfilled Details
Figure 6: Rendered Empty Form
Figure 7: Filled Form
Figure 8: App Catalog Data
Defining a Schema
Filling the Schema-Generated Form
JSON schema
super-admin
Helm applications
Clusters