Skip to content

List the "clusters" managed by an agent on the cluster list page

Release notes

Documentation link

To support the daily management of GitLab Kubernetes Agents, users of Agents can see a listing of agents under their projects, and get to the configuration of the agent easily. To provide even more insights and management around the GitLab Kubernetes Agent, we want to ship a details page for agents in a following release.

Problem to solve

As a Platform Engineer in order to manage my GitLab attached clusters, I would like to see a listing of clusters at a single place.

Intended users

User experience goal

Have a single (per project, per group and per instance) cluster listings page for certificate and agent based clusters.

Proposal

Extend the current cluster listings pages to include two tabs to show Clusters integrated with certificate and Clusters managed by GitLab Agent. The agents' tab is to be placed first.

A single real cluster might have multiple agents installed. In this case, it is shown multiple times. We actually show the agents, not the clusters.

Empty states 000_Kubernetes_list_-_Agent_clusters_Empty_state

000_S1_Import_cluster_with_agent_-Kubernetes_list-_Empty_state-1

Listings with clusters 010_Kubernetes_list_-_Agent_clusters_list

020_Kubernetes_list_-_Certificate_clusters_list

The status indicator states are explained by a tooltip that appears on hover:

  • grey: the agent never connected with its token
  • green: the connection between the agent and GitLab is set up
  • red: the connection between the agent and GitLab is broken

Further details

The Core tier users will only see the list of clusters that have been integrated with the certificate. Thus, there will be no changes to the current UI or they will only see the Clusters integrated with Certificate tab depending on what is easier from a developer perspective.

Permissions and Security

Documentation

Availability & Testing

What does success look like, and how can we measure that?

What is the type of buyer?

Is this a cross-stage feature?

Links / references

Design: Figma file

This page may contain information related to upcoming products, features and functionality. It is important to note that the information presented is for informational purposes only, so please do not rely on the information for purchasing or planning purposes. Just like with all projects, the items mentioned on the page are subject to change or delay, and the development, release, and timing of any products, features, or functionality remain at the sole discretion of GitLab Inc.

Edited by 🤖 GitLab Bot 🤖