Skip to content

Commit

Permalink
Added title to the frontmatter of certain topics (gardener#5734)
Browse files Browse the repository at this point in the history
* Added title to the frontmatter of certain topics

* Fixed formatting
  • Loading branch information
n-boshnakov authored Apr 4, 2022
1 parent 49af154 commit c78fb79
Show file tree
Hide file tree
Showing 18 changed files with 72 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/extensions/backupbucket.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: BackupBucket
---

# Contract: `BackupBucket` resource

The Gardener project features a sub-project called [etcd-backup-restore](https://github.com/gardener/etcd-backup-restore) to take periodic backups of etcd backing Shoot clusters. It demands the bucket (or its equivalent in different object store providers) to be created and configured externally with appropriate credentials. The `BackupBucket` resource takes this responsibility in Gardener.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/backupentry.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: BackupEntry
---

# Contract: `BackupEntry` resource

The Gardener project features a sub-project called [etcd-backup-restore](https://github.com/gardener/etcd-backup-restore) to take periodic backups of etcd backing Shoot clusters. It demands the bucket (or its equivalent in different object store providers) access credentials to be created and configured externally with appropriate credentials. The `BackupEntry` resource takes this responsibility in Gardener to provide this information by creating a secret specific to the component. Said that, the core motivation for introducing this resource was to support retention of backups post deletion of `Shoot`. The etcd-backup-restore components takes responsibility of garbage collecting old backups out of the defined period. Once a shoot is deleted, we need to persist the backups for few days. Hence, Gardener uses the `BackupEntry` resource for this housekeeping work post deletion of a `Shoot`. The `BackupEntry` resource is responsible for shoot specific prefix under referred bucket.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/containerruntime.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ContainerRuntime
---

# Gardener Container Runtime Extension

At the lowest layers of a Kubernetes node is the software that, among other things, starts and stops containers. It is called “Container Runtime”.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/controllerregistration.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ControllerRegistration
---

# Registering Extension Controllers

Extensions are registered in the garden cluster via [`ControllerRegistration`](../../example/25-controllerregistration.yaml) resources.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/controlplane-exposure.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ControlPlane Exposure
---

# Contract: `ControlPlane` resource with purpose `exposure`

Some Kubernetes clusters require an additional deployments required by the seed cloud provider in order to work properly, e.g. AWS Load Balancer Readvertiser.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/controlplane-webhooks.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ControlPlane Webhooks
---

# Controlplane customization webhooks

Gardener creates the Shoot controlplane in several steps of the Shoot flow. At different point of this flow, it:
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/controlplane.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ControlPlane
---

# Contract: `ControlPlane` resource

Most Kubernetes clusters require a `cloud-controller-manager` or CSI drivers in order to work properly.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/dns.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: DNS
---

# Contract: `DNSProvider` and `DNSEntry` resources

Every shoot cluster requires external DNS records that are publicly resolvable.
Expand Down
4 changes: 4 additions & 0 deletions docs/extensions/dnsrecord.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: DNSRecord
---

# Contract: `DNSRecord` resources

Every shoot cluster requires external DNS records that are publicly resolvable.
Expand Down
4 changes: 4 additions & 0 deletions docs/proposals/08-shoot-apiserver-via-sni.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: Shoot Apiserver Via SNI
---

# SNI Passthrough proxy for kube-apiservers

This GEP tackles the problem that today a single `LoadBalancer` is needed for every single Shoot cluster's control plane.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/apiserver-sni-injection.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ApiServer SNI Injection
---

# APIServerSNI environment variable injection

If the Gardener administrator has enabled `APIServerSNI` feature gate for a particular Seed cluster, then in each Shoot cluster's `kube-system` namespace a `DaemonSet` called `apiserver-proxy` is deployed. It routes traffic to the upstream Shoot Kube APIServer. See the [APIServer SNI GEP](../proposals/08-shoot-apiserver-via-sni.md) for more details.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/csi_components.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: CSI Components
---

# (Custom) CSI Components

Some provider extensions for Gardener are using CSI components to manage persistent volumes in the shoot clusters.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/custom-dns.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: Custom DNS Configuration
---

# Custom DNS Configuration

Gardener provides Kubernetes-Clusters-As-A-Service where all the system components (e.g., kube-proxy, networking, dns, ...) are managed.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/dns-autoscaling.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: DNS Autoscaling
---

# DNS Autoscaling

This is a short guide describing different options how to automatically scale CoreDNS in the shoot cluster.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/exposureclasses.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: ExposureClasses
---

# ExposureClasses

The Gardener API server provides a cluster-scoped `ExposureClass` resource.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/node-local-dns.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: NodeLocalDNS Configuration
---

# NodeLocalDNS Configuration

This is a short guide describing how to enable DNS caching on the shoot cluster nodes.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/openidconnect-presets.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: OpenIDConnect Presets
---

# ClusterOpenIDConnectPreset and OpenIDConnectPreset

This page provides an overview of ClusterOpenIDConnectPresets and OpenIDConnectPresets, which are objects for injecting [OpenIDConnect Configuration](https://openid.net/connect/) into `Shoot` at creation time. The injected information contains configuration for the Kube API Server and optionally configuration for kubeconfig generation using said configuration.
Expand Down
4 changes: 4 additions & 0 deletions docs/usage/reversed-vpn-tunnel.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
title: Reversed VPN Tunnel
---

# Reversed VPN Tunnel Setup and Configuration

This is a short guide describing how to enable tunneling traffic from shoot cluster to seed cluster instead of the default "seed to shoot" direction.
Expand Down

0 comments on commit c78fb79

Please sign in to comment.