Decisions and RFCs

RFC process

Want to write a new, technical RFC? Please follow the RFC and decision making process.

Existing RFCs

Created (newest first)TitleState
2024-05-22Structured way to propose, discuss, and formalize technical decisions within an organization

This contains the process for proposing, discussing, and formalizing technical decisions. It also introduces the RFC structure.
approved
2024-02-19Revamp our docs

Revamp our docs to describe the Dev Platform product, considering the new Cluster API (CAPI) architecture. Temporarily move vintage to a subpath and create the new content in the top level. The docs entry point can still point to the old till renovation is over.
approved
2023-10-26Importing EKS/AKS/GKE clusters to CAPI using crossplane

In order for Giant Swarm to import/adopt customer clusters on bring-your-own infrastructure, use Crossplane ObserveOnly functionality for resources to discover existing infrastructure of customers without managing it. Use clusters.x-k8s.io/managed-by: crossplane annotation to prevent CAPI from reconciling clusters. Do not rely on “paused” objects.
approved
2023-10-12Leaving docker hub and simplifying registries architecture

Switch to Azure Container Registry (ACR), even for China. Instead of replicating images across our multiple registries, trust this single provider to solve high availability. Run a local pull-through proxy to fall back during provider outage.
approved
2023-10-10RFC and decision making process

This contains the explicit procedure to follow for creating an RFC and having it reviewed. Introduce a structured YAML header for the Markdown file. List of RFCs gets rendered in the handbook.
approved
2023-10-09PSS migration orchestration

Describes the implementation of early Policy API features to assist with customer migrations to Kyverno-enforced Pod Security Standards.
approved
2023-10-09Policy Orchestration System

Introduces the Policy API as an abstraction for declaratively managing several external tools through a single customer interface.
approved
2023-08-24Extension to Giant Swarm CRD management via Fluxapproved
2023-08-07Manage essential CRDs via MCBapproved
2023-05-31Simplify baseDomain usage in our applicationsapproved
2023-05-08Default PSS and Policy Exceptions with Kyverno

Outlines the suggested replacement of Pod Security Policies with a Kyverno-backed implementation of the official Pod Security Standards guidelines in Giant Swarm clusters.
approved
2023-03-01Container Registry Configuration

Since Docker Hub has an image download rate limit which can lead to unhealthy clusters, configure containerd such that it uses other registries as mirrors (fallback).
approved
2023-01-25Ensure no single point of failure in management cluster accessapproved
2023-01-12Logging infrastructureapproved
2022-11-09Crossplane MVP on Management Clustersapproved
2022-10-18Making parts of the intranet publicapproved
2022-09-07Assigning installation namesapproved
2022-07-08SIG Meeting Improvement Initiativeapproved
2022-06-20Multi layer app configsapproved
2022-05-11Classifying clusters based on priorityapproved
2022-04-15Automatic App upgrades

Use Flux’s watch features such as ImagePolicy to automatically upgrade to newer app versions. This change was not performed, but we use *-collection repos (on MCs) and cluster default apps (on MCs/WCs) instead, so this RFC is obsolete.
obsolete
2022-04-01Merging config in a gitops contextapproved
2022-03-24RFCs Related to Kyverno Policy Management and Deployment

RFCs related to how Giant Swarm stores, versions, and shares Kyverno policies with customers. Partially superseded by Policy API concepts.
obsolete
2022-02-15A better customer email management solution

Add alias support+customer@giantswarm.io to forward e-mail to customer’s Slack channel. Also add alias urgent+area@giantswarm.io to forward to the area in Opsgenie. This change was introduced, but later reverted, so this RFC is obsolete.
obsolete
2021-11-24Managed Apps Vision

This RFC describes a general vision for improving the user experience of Managed Apps.
approved
2021-11-10Configuration management with Cluster APIapproved
2021-09-17Automatic workload cluster upgrades

As part of the Cluster API hackathon we brainstormed how to automate the cluster upgrades taking into account customer requirements and technical limitations brought under the new upstream implementation.
approved
2021-07-26Monitoring System End To End Testsapproved
2021-07-23Defaulting of CAPI clusters with webhooksapproved
2021-07-19Road to Cluster API (over the potholes)approved
2021-07-12Enable customers to use gitops in management clustersapproved
Last modified July 24, 2024: Update rendered RFCs (#268) (6934dd0)