Management API

The Management API is the Kubernetes API of a Giant Swarm management cluster, allowing control over workload clusters and apps in a declarative fashion using the proven Kubernetes paradigms.

• Overview
  Introduction to the Giant Swarm Management API, the Kubernetes API of the management cluster in your Giant Swarm installation.
• Authentication
  In this section, we provide instructions on how to authenticate for the Management API, both as a user and in an automation context. We also provide some technical background information and requirements for new customers.
• Authorization
  Granting users specific permission to certain resources is what authorization is all about. The Management API uses Kubernetes' role based access control (RBAC) primitives and provides automation on top of it to make authorization easy for most real-life use cases. Here we explain them in detail.
• Provider credentials
  Where to configure the cloud provider account/subscription to be used, and how to deposit credentials via the Management API.
• Creating workload clusters
  Guides for all supported platforms, explaining in detail how to leverage the Management API to create and manage clusters in a declarative fashion.
• CRDs
  Schema reference of all custom resource definitions (CRD) and custom resources (CR) you can use with the Management API.
• Client certificates for clusters
  We recommend OIDC for authentication to the workload cluster Kubernetes API. However, in some scenarios, client certificates are a viable alternative. Here we explain how to create such certificates via the Management API.