Merge branch 'main' into remove-script

giantswarm · Dec 16, 2024 · 30671ba · 30671ba
2 parents 84367b1 + c12d127
commit 30671ba
Show file tree

Hide file tree

Showing 31 changed files with 361 additions and 8,701 deletions.
diff --git a/.github/workflows/create-highlights.yml b/.github/workflows/create-highlights.yml
@@ -38,6 +38,6 @@ jobs:
             This PR has been created automatically by the 'Create highlight PR' Github workflow
             to publish the weekly highlights.
 
-            This action is triggered every Thrusday morning to collect all the highlights from the selected apps in giantswarm/github repository. The highlights are collected from the changelog entries from .github repository apps.
+            This action is triggered every Thursday morning to collect all the highlights from the selected apps in giantswarm/github repository. The highlights are collected from the changelog entries from .github repository apps.
 
             Please review the changes, group the entries for each app making sure it is digestible for the customers and highlight the breaking changes in the top.
diff --git a/.github/workflows/generate-review-issues.yaml b/.github/workflows/generate-review-issues.yaml
@@ -2,7 +2,7 @@ name: Generate review Issues weekly
 on:
   schedule:
     # At 0:00 on Sundays
-    - cron:  '0 0 * * 0' 
+    - cron:  '0 0 * * 0'
 
 
 jobs:
@@ -16,12 +16,13 @@ jobs:
         run: pip3 install click colored PyYAML
 
       - name: Validate front matter and last review date
-        run: |
-          echo "ISSUES=$(python3 scripts/validate-front-matter/script.py --validation last-reviewed --output json)" >> $GITHUB_ENV
-      
+        env:
+          GITHUB_TOKEN: ${{ secrets.TOKEN }}
+        run: make validate-last-reviewed
+
       - name: Generate issues of out of date docs
         uses: giantswarm/open-issue@7774937e31b23a52257a34462a753b0a28a4d1f1 # 0.3.0
-        with: 
+        with:
           token: ${{ secrets.ISSUE_AUTOMATION }}
           org: giantswarm
           repo: giantswarm

diff --git a/Makefile b/Makefile
@@ -110,6 +110,16 @@ validate-front-matter:
 	  $(REGISTRY)/$(COMPANY)/docs-scriptrunner:latest \
 	  /workdir/scripts/validate-front-matter/script.py
 
+# Validate front matter for last-reviewed date.
+validate-last-reviewed:
+	docker run --rm \
+	  --volume=${PWD}:/workdir:ro \
+	  -w /workdir \
+	  $(REGISTRY)/$(COMPANY)/docs-scriptrunner:latest \
+	  /workdir/scripts/validate-front-matter/script.py \
+		--validation last-reviewed \
+		--output json
+
 # Print a report of pages with a last_review_date that's
 # too long ago.
 validate-last-reviewed:

diff --git a/scripts/collect-changelog-entries/script.py b/scripts/collect-changelog-entries/script.py
@@ -92,8 +92,7 @@ def main():
     app_repos = fetch_app_repositories()
 
     # Define the metadata
-    metadata = f"""
----
+    metadata = f"""---
 date: {d}T14:00:00
 title: Highlights for the week ending {d}
 changes_categories:

diff --git a/scripts/update-helm-chart-reference/config.yaml b/scripts/update-helm-chart-reference/config.yaml
@@ -29,42 +29,18 @@ source_repositories:
   - url: https://github.com/giantswarm/cluster-vsphere
     organization: giantswarm
     introduction: |
-      The `default-apps-vsphere` chart templates all the VMware infrastructure resources that are necessary to create a Cluster API vSphere cluster.
+      The `cluster-vsphere` chart templates all the VMware infrastructure resources that are necessary to create a Cluster API vSphere cluster.
     name: cluster-vsphere
     commit_reference: v0.9.8
   - url: https://github.com/giantswarm/cluster-cloud-director
     organization: giantswarm
     introduction: |
-      The `default-apps-cloud-director` chart templates all the VMware infrastructure resources that are necessary to create a Cluster API VCD cluster.
+      The `cluster-cloud-director` chart templates all the VMware infrastructure resources that are necessary to create a Cluster API VCD cluster.
     name: cluster-cloud-director
     commit_reference: v0.14.2
-  - url: https://github.com/giantswarm/default-apps-aws
-    organization: giantswarm
-    introduction: |
-      The `default-apps-aws` chart templates all the components required for a Cluster API AWS cluster like External DNS or CoreDNS.
-    name: default-apps-aws
-    commit_reference: v0.48.0
   - url: https://github.com/giantswarm/default-apps-eks
     organization: giantswarm
     introduction: |
-      The `default-apps-eks` chart templates all the components required for a Cluster API EKS cluster like External DNS or CoreDNS.
+      The `default-apps-eks` chart templates all the standard apps deployed to AWS EKS clusters, like External DNS and CoreDNS.
     name: default-apps-eks
     commit_reference: v0.5.1
-  - url: https://github.com/giantswarm/default-apps-azure
-    organization: giantswarm
-    introduction: |
-      The `default-apps-azure` chart templates all the components required for a Cluster API Azure cluster like External DNS or CoreDNS.
-    name: default-apps-azure
-    commit_reference: v0.8.3
-  - url: https://github.com/giantswarm/default-apps-vsphere
-    organization: giantswarm
-    introduction: |
-      The `default-apps-vsphere` chart templates all the components required for a Cluster API VMware cluster like External DNS or CoreDNS.
-    name: default-apps-vsphere
-    commit_reference: v0.12.1
-  - url: https://github.com/giantswarm/default-apps-cloud-director
-    organization: giantswarm
-    introduction: |
-      The `default-apps-cloud-director` chart templates all the components required for a Cluster API VMware cluster like External DNS or CoreDNS.
-    name: default-apps-cloud-director
-    commit_reference: v0.7.3
diff --git a/scripts/validate-front-matter/script.py b/scripts/validate-front-matter/script.py
@@ -18,6 +18,7 @@
 crds_path         = 'src/content/reference/platform-api/crd'
 vintage_crds_path = 'src/content/vintage/use-the-api/management-api/crd'
 cluster_apps_path = 'src/content/reference/platform-api/cluster-apps'
+meta_path         = 'src/content/meta'
 docs_host         = 'https://github.com/giantswarm/docs/blob/main/'
 
 todays_date = datetime.date.today()
@@ -161,7 +162,7 @@
     {
         'id': NO_LAST_REVIEW_DATE,
         'description': 'The page should have a last_review_date',
-        'ignore_paths': [crds_path, vintage_crds_path, changes_path, cluster_apps_path],
+        'ignore_paths': [crds_path, vintage_path, changes_path, cluster_apps_path, meta_path],
         'severity': SEVERITY_WARN,
     },
     {

diff --git a/src/content/changes/highlights/2024-12-12.md b/src/content/changes/highlights/2024-12-12.md
@@ -0,0 +1,38 @@
+---
+date: 2024-12-12T14:00:00
+title: Highlights for the week ending 2024-12-12
+changes_categories:
+  - Highlights
+owner:
+  - https://github.com/orgs/giantswarm/teams/sig-product
+---
+
+## Observability
+
+- **Grafana App** [v2.18.0](https://github.com/giantswarm/grafana-app/compare/v2.17.0...v2.18.0)
+    - Improved security by blocking default access to certain endpoints (`/swagger`, `/metrics`, and `/api/health`).
+    - Upgraded Grafana for a better user experience and new features (now at version 8.6.0).
+
+- **Prometheus Rules** [v4.30.0](https://github.com/giantswarm/prometheus-rules/compare/v4.27.0...v4.30.0)
+    - New alert added to help identify issues with `KubeadmConfig` configurations.
+    - Reduced unnecessary alerts during tests by ignoring certain HelmReleases.
+    - Added new alerts to quickly detect and resolve `karpenter` issues.
+    - Expanded alert timing for `PromtailRequestsErrors` to reduce false positives (now 25 minutes).
+
+- **Observability Operator** [v0.10.0](https://github.com/giantswarm/observability-operator/compare/v0.9.1...v0.10.0)
+    - Integrated `Mimir`, `Alertmanager` for enhanced alerting.
+    - Enhanced multi-tenant support within `Grafana` organizations.
+    - Fixed an issue that prevented `Grafana` from starting by ensuring config persistence.
+
+## Fleet Management
+
+- **Kube Downscaler App** [v0.4.0](https://github.com/giantswarm/kube-downscaler-app/compare/v0.3.0...v0.4.0)
+    - Introduced a new `Cilium` network policy template for improved network management.
+
+## Security
+
+- **Kyverno Policies** [v0.21.1](https://github.com/giantswarm/kyverno-policies/compare/v0.21.0...v0.21.1)
+    - Enhanced visibility with the addition of the `application.giantswarm.io/team` label.
+
+- **Event Exporter App** [v2.0.0](https://github.com/giantswarm/event-exporter-app/compare/v1.0.0...v2.0.0)
+    - Transitioned to a new, supported image source for better stability and support.
diff --git a/src/content/changes/workload-cluster-releases-capa/releases/aws-25.4.0.md b/src/content/changes/workload-cluster-releases-capa/releases/aws-25.4.0.md
@@ -0,0 +1,56 @@
+---
+# Generated by scripts/aggregate-changelogs. WARNING: Manual edits to this files will be overwritten.
+aliases:
+- /changes/tenant-cluster-releases-capa/releases/capa-aws-25.4.0/
+changes_categories:
+- Workload cluster releases for CAPA
+changes_entry:
+  repository: giantswarm/releases
+  url: https://github.com/giantswarm/releases/tree/master/capa/v25.4.0
+  version: aws-25.4.0
+  version_tag: aws-25.4.0
+date: '2024-12-12T12:00:00'
+description: Release notes for CAPA workload cluster release aws-25.4.0, published
+  on 12 December 2024, 12:00.
+title: Workload cluster release aws-25.4.0 for CAPA
+---
+
+This release introduces `aws-node-termination-handler` for graceful draining of nodes during an upgrade or other type of replacement of worker nodes.
+
+Details can be found in the [node pools documentation](https://docs.giantswarm.io/tutorials/fleet-management/cluster-management/node-pools/#what-happens-when-rolling-nodes).
+
+## Changes compared to v25.3.0
+
+### Components
+
+- cluster-aws from v1.3.4 to v1.3.5
+
+### cluster-aws [v1.3.4...v1.3.5](https://github.com/giantswarm/cluster-aws/compare/v1.3.4...v1.3.5)
+
+#### Added
+
+- Values: Add `global.providerSpecific.controlPlaneAmi` & `global.providerSpecific.nodePoolAmi`.
+- Add aws-node-termination-handler bundle
+- Make ASG lifecycle hook heartbeat timeout configurable
+
+### Apps
+
+- aws-nth-bundle v1.2.0
+- cert-exporter from v2.9.0 to v2.9.3
+
+### aws-nth-bundle [v1.2.0](https://github.com/giantswarm/aws-nth-bundle/releases/tag/v1.2.0)
+
+#### Added
+
+- Send spot instance interruption and instance state change events to SQS queue so that aws-node-termination-handler can react to them
+
+### cert-exporter [v2.9.0...v2.9.3](https://github.com/giantswarm/cert-exporter/compare/v2.9.0...v2.9.3)
+
+#### Added
+
+- Chart: Add VPA and resources configuration for deployment and daemonset. ([#382](https://github.com/giantswarm/cert-exporter/pull/382))
+
+#### Changed
+
+- Chart: Enable `global.podSecurityStandards.enforced`. ([#420](https://github.com/giantswarm/cert-exporter/pull/420))
+- Chart: Update PolicyExceptions to v2beta1. ([#358](https://github.com/giantswarm/cert-exporter/pull/358))
diff --git a/src/content/changes/workload-cluster-releases-capa/releases/aws-26.3.0.md b/src/content/changes/workload-cluster-releases-capa/releases/aws-26.3.0.md
@@ -0,0 +1,56 @@
+---
+# Generated by scripts/aggregate-changelogs. WARNING: Manual edits to this files will be overwritten.
+aliases:
+- /changes/tenant-cluster-releases-capa/releases/capa-aws-26.3.0/
+changes_categories:
+- Workload cluster releases for CAPA
+changes_entry:
+  repository: giantswarm/releases
+  url: https://github.com/giantswarm/releases/tree/master/capa/v26.3.0
+  version: aws-26.3.0
+  version_tag: aws-26.3.0
+date: '2024-12-12T12:00:00'
+description: Release notes for CAPA workload cluster release aws-26.3.0, published
+  on 12 December 2024, 12:00.
+title: Workload cluster release aws-26.3.0 for CAPA
+---
+
+This release introduces `aws-node-termination-handler` for graceful draining of nodes during an upgrade or other type of replacement of worker nodes.
+
+Details can be found in the [node pools documentation](https://docs.giantswarm.io/tutorials/fleet-management/cluster-management/node-pools/#what-happens-when-rolling-nodes).
+
+## Changes compared to v26.2.0
+
+### Components
+
+- cluster-aws from v1.3.4 to v1.3.5
+
+### cluster-aws [v1.3.4...v1.3.5](https://github.com/giantswarm/cluster-aws/compare/v1.3.4...v1.3.5)
+
+#### Added
+
+- Values: Add `global.providerSpecific.controlPlaneAmi` & `global.providerSpecific.nodePoolAmi`.
+- Add aws-node-termination-handler bundle
+- Make ASG lifecycle hook heartbeat timeout configurable
+
+### Apps
+
+- aws-nth-bundle v1.2.0
+- cert-exporter from v2.9.0 to v2.9.3
+
+### aws-nth-bundle [v1.2.0](https://github.com/giantswarm/aws-nth-bundle/releases/tag/v1.2.0)
+
+#### Added
+
+- Send spot instance interruption and instance state change events to SQS queue so that aws-node-termination-handler can react to them
+
+### cert-exporter [v2.9.0...v2.9.3](https://github.com/giantswarm/cert-exporter/compare/v2.9.0...v2.9.3)
+
+#### Added
+
+- Chart: Add VPA and resources configuration for deployment and daemonset. ([#382](https://github.com/giantswarm/cert-exporter/pull/382))
+
+#### Changed
+
+- Chart: Enable `global.podSecurityStandards.enforced`. ([#420](https://github.com/giantswarm/cert-exporter/pull/420))
+- Chart: Update PolicyExceptions to v2beta1. ([#358](https://github.com/giantswarm/cert-exporter/pull/358))
diff --git a/...-started/install-an-application/_index.md → ...g-started/install-an-application/index.md b/...-started/install-an-application/_index.md → ...g-started/install-an-application/index.md
diff --git a/.../observe-your-clusters-and-apps/_index.md → ...d/observe-your-clusters-and-apps/index.md b/.../observe-your-clusters-and-apps/_index.md → ...d/observe-your-clusters-and-apps/index.md
diff --git a/src/content/meta/shared-installation.md b/src/content/meta/shared-installation.md
diff --git a/...ntent/overview/developer-portal/_index.md → ...ontent/overview/developer-portal/index.md b/...ntent/overview/developer-portal/_index.md → ...ontent/overview/developer-portal/index.md
@@ -9,6 +9,9 @@ menu:
 last_review_date: 2024-07-01
 owner:
   - https://github.com/orgs/giantswarm/teams/team-honeybadger
+user_questions:
+  - What is the developer portal?
+  - What is Backstage?
 ---
 
 Our developer portal based on [Backstage](https://www.cncf.io/projects/backstage/) is your engineer's front end to the platform. We provide our self-service user interface as plugins for Backstage, so that engineers using your platform find all the information they need in the place they visit frequently.

diff --git a/src/content/reference/platform-api/cluster-apps/_index.md b/src/content/reference/platform-api/cluster-apps/_index.md
@@ -1,7 +1,7 @@
 ---
 linkTitle: Cluster app charts
 title: Cluster app charts
-description: These charts are used to provision clusters in the Giant Swarm platform (here, even clusters are apps, in a way). 
+description: These charts are used to provision clusters in the Giant Swarm platform (here, even clusters are apps, in a way).
 weight: 100
 menu:
   principal: