Filtering bundles

ECR bundles are filterable by component, by status or by textual research.

Filtering bundles by component

ECR bundles are filterable by component from App Builder user interface.

Behind the scenes, filtering is done using the label-based filtering provided out of the box from Kubernetes.

To enable filtering of a bundle, the custom-resource representing the bundle on the Entando Cluster needs to contain the correct labels. An important note on the values to add the labels field, even if to correctly define a label in a k8s resource both the key and the value are required, from an Entando point of view only the key part of the label is used for filtering. The value could be set to anything, but our reccomendation is to use "true" for clarity and simplicity.

Supported labels keys are:

Label entry	Description
widget: "true"	The bundle contains one or more microfrontends (widgets)
plugin: "true"	The bundle contains one or more microservices (plugins)
fragment: "true"	The bundle contains one or more fragments
pageTemplate: "true"	The bundle contains one or more page templates
contentType: "true"	The bundle contains one or more content types
contentTemplate: "true"	The bundle contains one or more content templates

Example

Here is an example of the metadata for a ecr bundle containg micro-frontends, some microservices and page templates

apiVersion: entando.org/v1
kind: EntandoDeBundle
metadata:
  name: demo-bundle
  labels:
    widget: "true"
    plugin: "true"
    pageTemplate: "true"
spec:
  details:
  ...

Filtering bundles by status

ECR bundles are filterable by status from App Builder user interface.

You can choose to see the full list of the bundles available in Kubernetes cluster by selecting the Explore tab, or the list of the currently installed bundles by clicking on the Installed tab.

Filtering bundles by textual search

You can search for bundles containing some keywords by executing a textual search.

You can open the menu on the left to select which field to target.

If you are creating a new bundle, keep in mind the textual search is performed against data extracted from the bundle CRD file.

Mixing search criteria

You can mix all previous search criteria to refine the scope of your search as you want. For example, you could search for all available bundles (Explore tab) that contain Page Templates components (using the checkboxes) and the word Login in their name (using the textual search).