Last modified September 29, 2021

The Management API

What it is

In a Giant Swarm installation, the management cluster is a dedicated Kubernetes cluster that runs all the operational and monitoring workloads which are needed to create and manage the workload clusters. These are the clusters you create to run your actual workloads.

Your workload clusters and other associated resources are represented in the management cluster as custom resources (CRs). To access these, you use the Kubernetes API of the management cluster, or in short, the Management API.

Apart from the CRs and custom resource definitions (CRDs) the Management API provides, its behavior is defined by admission controllers enforcing some policies and providing some defaulting.

How to gain access

Access to the Giant Swarm Management API is secured using OIDC. Our authentication section provides additional information both for admins and end users. Please contact your Account Engineer to sort out the details.

How to use

Currently (as of August 2021) we are in the process of enabling our web user interface to interact with the Management API.

For now we recommend using kubectl to interact with the Management API. To facilitate this we provide a kubectl plug-in called kubectl gs.

Besides general Kubernetes know-how this will require only a bit of structural knowledge:

How we organize resources in namespaces

We are working towards making organization namespaces the default location for all resources associated with one organization. Please check this dedicated section regarding the current progress towards this on various providers.

Which custom resources are used for what purpose

Following are some resources that should help you:

Feedback is welcome

We are keen to learn from you about your experience with using the Management API, with navigating the custom resources via the API, with our reference documentation and the user guides we provide. This helps us provide more and better material and improve to make the journey more seamless, more satisfactory for you.

So please, don’t hesitate to give your feedback in your Slack channel.