Skip to content

applicationsets.md

Latest commit

 

History

History
134 lines (87 loc) · 5.92 KB

applicationsets.md

File metadata and controls

134 lines (87 loc) · 5.92 KB
Raw

ApplicationSets in the GitOps Console

The GitOps Console plugin shows list and details pages for Argo CD ApplicationSets in the OpenShift web console. You can search and filter ApplicationSets, create them from a YAML template, review generated Applications, inspect generators, and use the graphical view for owner-reference and progressive sync layouts.

Prerequisites

  • You have access to the OpenShift web console.
  • The GitOps Console plugin is enabled. See Enable the GitOps Console plugin.
  • You can list ApplicationSets in the selected namespace (or across namespaces, depending on your permissions).

List page

  1. In the Administrator or Core platform perspective, navigate to GitOps → ApplicationSets.

  2. Optional: Use the Project dropdown to limit the list to one project (namespace), or choose all projects.

The ApplicationSets list page includes:

  • Filtering: Filter ApplicationSets by:
    • Health Status: Healthy, Error, Unknown
  • Search: Use the search field to match by Name or Label. Choose the mode from the dropdown next to the field.
  • Create action: Click Create ApplicationSet to open the YAML editor with a default ApplicationSet template
  • Table columns: Name, Namespace, Health Status, Generated Apps, Generators, Labels, Created At, and row actions
  • Pagination: Browse results in pages of 10, 20, 50, or 100 items (default 50). Search and filters change which rows are included. See Filter, search, and paginate resources.

NOTE

Creation uses the YAML editor. The console does not provide an ApplicationSet form wizard.

Row actions

From the row kebab, you can:

  • Edit labels
  • Edit annotations
  • Edit ApplicationSet (opens the YAML editor)
  • Delete ApplicationSet

ApplicationSet details page

  1. From the ApplicationSets list, click an ApplicationSet name.

  2. The details page breadcrumb shows ApplicationSets → ApplicationSet details.

  3. Use the page header Actions menu for the same edit and delete actions as the list.

The details page includes the following tabs.

Details tab

The Details tab summarizes identity, status, and related counts.

Section title: ApplicationSet details.

Summary (left)

  • Name
  • Namespace
  • Labels, with Edit
  • Annotations
  • Created at
  • Owner

Status and configuration (right)

  • Status: Overall health of the ApplicationSet (Healthy, Error, or Unknown)
  • Generated Apps: Count of Applications owned by this ApplicationSet, with a link to the Applications tab
  • Generators: Count of configured generators, with a link to the Generators tab
  • App Project: AppProject that generated Applications belong to
  • Repository: Template source repository URL when the ApplicationSet template uses a single source (multi-source templates may not show this field)

Conditions

Below the summary, the Conditions section shows ApplicationSet status conditions from the controller. Use this table to diagnose generation failures, progressive sync progress, and whether managed Applications are up to date.

The conditions table includes:

Column Description
Type Condition type, such as ErrorOccurred, ParametersGenerated, ResourcesUpToDate, or RolloutProgressing.
Status True, False, or Unknown.
Updated When the condition last changed.
Reason Short machine-readable cause.
Message Human-readable details.

Common conditions:

  • ErrorOccurred: Generation or sync errors for the ApplicationSet.
  • ParametersGenerated: Whether generator parameters were produced successfully.
  • ResourcesUpToDate: Whether generated Applications match the desired state.
  • RolloutProgressing: Progressive sync or rollout is still in progress.

If no conditions are reported, the section shows No conditions found.

YAML tab

The YAML tab provides a live editor for the ApplicationSet manifest. Use it to inspect or update the full resource definition.

The editor includes a Schema side panel that describes ApplicationSet fields, and a Download control to save the YAML.

Generators tab

The Generators tab shows the ApplicationSet generator configuration in a structured view.

Supported generator presentations include List, Cluster, git, Matrix, Merge, and Union. Other generator types use a generic view that shows the configuration as JSON.

If no generators are configured, the tab shows an empty state.

Applications tab

The Applications tab shows Applications generated by this ApplicationSet in list or graph form.

Section title: ApplicationSet Applications.

  • Switch between List view and Graph view. The console remembers your preference.
  • Use Filter and Search (by name or label) to narrow by health and sync status, or by Application name or label.
  • List view uses the same Application table columns, sorting, and pagination as the main Applications list. See Applications in the GitOps Console.
  • Graph view shows the ApplicationSet and its generated Applications:
    • Standard layout: Owner-reference tree when progressive sync is not active
    • Progressive Sync Flow View: Step groups when progressive sync is enabled and step status is available

For graph controls and progressive sync requirements, see Graphs and topology views.

Events tab

The Events tab shows Kubernetes events for the ApplicationSet object, using the standard console event stream for that resource.

Related information