feat: release v1.28.6 with backport features from v1.31.0 (#332)

* feat: backport v1.31.0 to v1.28.6 without kapp feature

* docs: add all docs from 1.31.0, 1.30.1, 1.29.6 and 1.28.6

* chore: comments and changes from review

* docs: fix upgrade procedure link on newer releases

* chore: regenerate docs and schemas

Author: nutellinoit

.drone.yml

@@ -44,7 +44,7 @@ steps:
       # Disable go linting, we use the one included in the go image
       VALIDATE_GO: "false"
       # Exclude template files from linting. The linter does not understand Go template.
-      FILTER_REGEX_EXCLUDE: (templates/)
+      FILTER_REGEX_EXCLUDE: (templates/|\.github)
     depends_on:
       - license-check
       - schema-check
@@ -80,7 +80,7 @@ steps:
     environment:
       NETRC_FILE:
         from_secret: NETRC_FILE
-      FURYCTL_VERSION: v0.30.1
+      FURYCTL_VERSION: v0.31.0
       FURYCTL_CONFIG: tests/e2e/kfddistribution/furyctl-init-cluster.yaml
       FURYCTL_DISTRO_LOCATION: ./
       FURYCTL_OUTDIR: ./
@@ -153,6 +153,7 @@ steps:
         nodes:
           - role: control-plane
           - role: worker
+          - role: worker
         EOF
       # NOTE: kind's `--wait` flag that waits for the control-plane ot be ready
       # does not work when disabling the default CNI. It will always go in timeout.
@@ -169,7 +170,7 @@ steps:
     environment:
       CLUSTER_NAME: ${DRONE_REPO_NAME}-${DRONE_BUILD_NUMBER}
       KUBECONFIG: /drone/src/kubeconfig
-      FURYCTL_VERSION: v0.30.1
+      FURYCTL_VERSION: v0.31.0
     depends_on: [create Kind cluster]
     commands:
       - export KUBECONFIG=/drone/src/kubeconfig
@@ -208,7 +209,7 @@ volumes:
     host:
       path: /var/run/docker.sock
 ---
-name: e2e-kubernetes-1.28.4-to-1.28.5
+name: e2e-kubernetes-1.28.5-to-1.28.6
 kind: pipeline
 type: docker
 
@@ -256,6 +257,7 @@ steps:
         nodes:
           - role: control-plane
           - role: worker
+          - role: worker
         EOF
       # NOTE: kind's `--wait` flag that waits for the control-plane ot be ready
       # does not work when disabling the default CNI. It will always go in timeout.
@@ -272,7 +274,7 @@ steps:
     environment:
       CLUSTER_NAME: ${DRONE_REPO_NAME}-${DRONE_BUILD_NUMBER}-upgrades
       KUBECONFIG: /drone/src/kubeconfig-upgrades
-      FURYCTL_VERSION: v0.30.1
+      FURYCTL_VERSION: v0.31.0
     depends_on: [create Kind cluster]
     commands:
       - export KUBECONFIG=/drone/src/kubeconfig-upgrades
@@ -317,7 +319,7 @@ type: docker
 
 depends_on:
   - e2e-kubernetes-1.28
-  - e2e-kubernetes-1.28.4-to-1.28.5
+  - e2e-kubernetes-1.28.5-to-1.28.6
 
 platform:
   os: linux
@@ -326,7 +328,7 @@ platform:
 trigger:
   ref:
     include:
-      - refs/tags/**
+      - refs/tags/v**
     exclude:
       - refs/tags/**-docs*
 
@@ -339,7 +341,7 @@ steps:
     when:
       ref:
         include:
-          - refs/tags/**
+          - refs/tags/v**
         exclude:
           - refs/tags/**-docs*
 

.gitignore

@@ -6,4 +6,6 @@ vendor
 
 go.work
 go.work.sum
-.envrc
+.envrc
+.local
+.furyctl

README.md

@@ -7,8 +7,8 @@
 <p align="center">Kubernetes Fury Distribution (KFD) is a certified battle-tested Kubernetes distribution based purely on upstream Kubernetes.</p>
 <!-- markdownlint-enable MD033 MD045 -->
 
-[![Build Status](http://ci.sighup.io/api/badges/sighupio/fury-distribution/status.svg?ref=refs/tags/v1.28.5)](http://ci.sighup.io/sighupio/fury-distribution)
-[![Release](https://img.shields.io/badge/release-v1.28.5-blue?label=FuryDistributionRelease)](https://github.com/sighupio/fury-distribution/releases/latest)
+[![Build Status](http://ci.sighup.io/api/badges/sighupio/fury-distribution/status.svg?ref=refs/tags/v1.28.6)](http://ci.sighup.io/sighupio/fury-distribution)
+[![Release](https://img.shields.io/badge/release-v1.28.6-blue?label=FuryDistributionRelease)](https://github.com/sighupio/fury-distribution/releases/latest)
 [![Slack](https://img.shields.io/badge/slack-@kubernetes/fury-yellow.svg?logo=slack)](https://kubernetes.slack.com/archives/C0154HYTAQH)
 [![License](https://img.shields.io/github/license/sighupio/fury-distribution)](https://github.com/sighupio/fury-distribution/blob/main/LICENSE)
 
@@ -75,13 +75,13 @@ A KFD production grade cluster will be composed of 3 node pools:
 Some modules rely on persistent storage via PersistentVolumeClaims, by default (but configurable) the following capacity will be used:
 
 | Description                                | Size (GB) |
-| ------------------------------------------ | --------- |
-| Prometheus (metrics storage)               | 150       |
-| MinIO Monitoring (metrics storage, 20GBx6) | 120       |
-| MinIO Logging (logs storage, 20GBx6)       | 120       |
-| OpenSearch (logs storage)                  | 30        |
-| MinIO Tracing (traces storage)             | 120       |
-| **Total**                                  | **540**   |
+| ------------------------------------------ | --------: |
+| Prometheus (metrics storage)               |       150 |
+| MinIO Monitoring (metrics storage, 20GBx6) |       120 |
+| MinIO Logging (logs storage, 20GBx6)       |       120 |
+| OpenSearch (logs storage)                  |        30 |
+| MinIO Tracing (traces storage)             |       120 |
+| **Total**                                  |   **540** |
 
 ### Core Modules 📦
 
@@ -130,9 +130,14 @@ Current supported versions of KFD are:
 
 |                                  KFD Version                                   | Kubernetes Version |
 | :----------------------------------------------------------------------------: | :----------------: |
-| [`1.30.0`](https://github.com/sighupio/fury-distribution/releases/tag/v1.30.0) |      `1.30.x`      |
-| [`1.29.5`](https://github.com/sighupio/fury-distribution/releases/tag/v1.29.5) |      `1.29.x`      |
-| [`1.28.5`](https://github.com/sighupio/fury-distribution/releases/tag/v1.28.5) |      `1.28.x`      |
+| [`1.31.0`](https://github.com/sighupio/fury-distribution/releases/tag/v1.31.0) |      `1.31.x`      |
+| [`1.30.1`](https://github.com/sighupio/fury-distribution/releases/tag/v1.30.1) |      `1.30.x`      |
+| [`1.29.6`](https://github.com/sighupio/fury-distribution/releases/tag/v1.29.6) |      `1.29.x`      |
+| [`1.28.6`](https://github.com/sighupio/fury-distribution/releases/tag/v1.28.6) |      `1.28.x`      |
+
+> [!NOTE]
+> Usually, KFD supports 3 versions simultaneously that are compatible with 3 different underlying Kubernetes versions. With KFD v1.31.0 the support for KFD v1.28.x will be extended for some time, effectively providing support for 4 versions (1.28, 1.29, 1.30 and 1.31).
+> See the [versioning](docs/VERSIONING.md) document for more details on KFD's version skew policy.
 
 Check the [compatibility matrix][compatibility-matrix] for additional information about previous releases of the Distribution and the compatibility with `furyctl`.