Skip to content

Commit b41d6ff

Browse files
mlavaccamlavacca
committed
feat: bootstrap KO 2.1 docs
Signed-off-by: Mattia Lavacca <lavacca.mattia@gmail.com>
1 parent 760c053 commit b41d6ff

File tree

2 files changed

+114
-29
lines changed

2 files changed

+114
-29
lines changed

‎app/_how-tos/operator-get-started-hybrid-install.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Install {{ site.operator_product_name }} in {{ site.konnect_short_name }} hybrid mode
2+
title: Deploy and manage {{ site.kong_product_name }} in {{ site.konnect_short_name }} hybrid mode through the {{ site.operator_product_name }}
33
description: "Learn how to install {{ site.operator_product_name }} in Konnect hybrid mode using Helm"
44
content_type: how_to
55

‎app/_landing_pages/operator.yaml‎

Lines changed: 113 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -19,9 +19,8 @@ rows:
1919
- blocks:
2020
- type: text
2121
config: |
22-
{{ site.operator_product_name }} is the Kubernetes-native way to interact with Kong. Driven entirely by Kubernetes
23-
Custom Resource Definitions (CRDs), {{ site.operator_product_name }} allows you to deploy and configure Kong's products
24-
in a 100% declarative way.
22+
{{ site.operator_product_name }} is the Kubernetes-native way to interact with Kong. Driven by Gateway API or Kong-specific Custom Resource Definitions (CRDs) resources, {{ site.operator_product_name }} allows you to deploy and configure Kong's products
23+
in a declarative way.
2524
2625
- header:
2726
type: h2
@@ -30,58 +29,144 @@ rows:
3029
- blocks:
3130
- type: card
3231
config:
33-
icon: /assets/icons/gateway.svg
32+
icon: /assets/logos/Konnect-logo.svg
3433
title: Deploy {{ site.base_gateway }}
3534
description: |
36-
Deploy a {{ site.base_gateway }} attached to any {{ site.konnect_short_name }} or self-managed Control Plane using
37-
the `DataPlane` resource.
35+
Deploy a Hybrid {{ site.base_gateway }} to {{ site.konnect_short_name }} using
36+
the Gateway API `Gateway` resource.
3837
cta:
39-
text: Deploy a DataPlane
38+
text: Deploy Hybrid Gateways in Konnect
4039
url: /operator/dataplanes/get-started/hybrid/install/
4140

4241
- blocks:
4342
- type: card
4443
config:
4544
icon: /assets/icons/kubernetes.svg
46-
title: Deploy self-managed Control Plane
45+
title: Deploy self-managed Gateways
4746
description: |
4847
Deploy and manage {{ site.base_gateway }}, configure automatically a self-managed Control Plane using Kubernetes
4948
Gateway API resources such as `Gateway` and `HTTPRoute`
5049
cta:
51-
text: Deploy self-managed Control Plane
50+
text: Deploy self-managed Gateways
5251
url: /operator/dataplanes/get-started/kic/install/
5352

54-
- blocks:
55-
- type: card
56-
config:
57-
icon: /assets/icons/dedicated-cloud-gateway.svg
58-
title: Configure {{ site.konnect_short_name }}
59-
description: |
60-
Configure your {{ site.konnect_short_name }} organization using CRDs. Create control planes and configure {{ site.base_gateway }}
61-
entities, or configure Dedicated Cloud Gateways deployments.
62-
cta:
63-
text: Create and configure a Control Plane in {{ site.konnect_short_name }}
64-
url: /operator/konnect/crd/control-planes/hybrid/
65-
6653
- header:
6754
type: h2
68-
text: "Konnect CRDs"
69-
sub_text: Manage {{ site.konnect_short_name }} declaratively with first-class CRD support
55+
text: "Configure your Gateways declaratively"
56+
sub_text: |
57+
The Kong Gateway can be configured using Kubernetes-native resources.
58+
59+
Here is the two recommended ways to configure your Gateways using {{ site.operator_product_name }}:
7060
columns:
7161
- blocks:
62+
- type: structured_text
63+
config:
64+
header:
65+
text: Gateway API
66+
blocks:
67+
- type: text
68+
text: |
69+
The de facto standard for configuring networking in Kubernetes, Gateway API allows you to configure
70+
your Gateways, no matter if they are self-managed or Hybrid {{ site.base_gateway }}.
71+
72+
Kong has been at the forefront of Gateway API development, contributing features and enhancements to the project since its inception.
73+
- type: text
74+
config: |
75+
```yaml
76+
# Create a new HTTPRoute to route traffic to an echo service
77+
apiVersion: gateway.networking.k8s.io/v1
78+
kind: HTTPRoute
79+
metadata:
80+
name: httproute-echo
81+
namespace: default
82+
annotations:
83+
konghq.com/strip-path: "true"
84+
spec:
85+
parentRefs:
86+
- name: hybrid-kong
87+
rules:
88+
- matches:
89+
- path:
90+
type: PathPrefix
91+
value: /echo
92+
backendRefs:
93+
- name: echo
94+
kind: Service
95+
port: 80
96+
```
97+
- blocks:
98+
- type: structured_text
99+
config:
100+
header:
101+
text: Konnect configuration CRDs
102+
blocks:
103+
- type: text
104+
text: |
105+
Kong-specific Custom Resource Definitions allow you to configure your Gateways and {{ site.konnect_short_name }} resources directly from Kubernetes.
106+
107+
These CRDs are designed and maintained by Kong, providing the same powerful capabilities as Gateway API with Kong-native resource definitions.
72108
- type: text
73109
config: |
74-
We built Konnect CRDs after listening to _you_. Users told us that their teams are used to working in Kubernetes. They have policy
75-
enforcement engines running in their clusters, and well defined review processes for CRD changes.
110+
```yaml
111+
# Create a new KongService
112+
apiVersion: configuration.konghq.com/v1alpha1
113+
kind: KongService
114+
metadata:
115+
name: echo
116+
namespace: default
117+
spec:
118+
# reference the Konnect/Gateway control plane defined in Konnect
119+
controlPlaneRef:
120+
type: konnectNamespacedRef
121+
konnectNamespacedRef:
122+
name: <CONTROLPLANE_NAME>
123+
name: echo
124+
host: echo.default.svc.cluster.local
125+
port: 80
126+
protocol: http
127+
128+
---
129+
130+
# Create a new KongRoute
131+
apiVersion: configuration.konghq.com/v1alpha1
132+
kind: KongRoute
133+
metadata:
134+
name: httproute-echo
135+
namespace: default
136+
spec:
137+
name: httproute-echo
138+
protocols:
139+
- http
140+
paths:
141+
- /echo
142+
strip_path: true
143+
serviceRef:
144+
type: namespacedRef
145+
namespacedRef:
146+
name: echo
147+
```
148+
- header:
149+
type: h2
150+
text: "Help us to help you!"
151+
columns:
152+
- blocks:
153+
- type: structured_text
154+
config:
155+
header:
156+
text: Help us to help you!
157+
blocks:
158+
- type: text
159+
text: |
160+
We built Konnect CRDs after listening to _you_. Users told us that their teams are used to working in Kubernetes. They have policy
161+
enforcement engines running in their clusters, and well defined review processes for CRD changes.
76162
77-
Now we need your help. We're expanding CRD support to new products, and need you to tell us which APIs you want us to build first.
163+
Now we need your help. We're expanding CRD support to new products, and need you to tell us which APIs you want us to build first.
78164
79-
Join the conversation and tell us how you're using {{ site.konnect_short_name }} CRDs today and what you'd like to see next.
165+
Join the conversation and tell us how you're using {{ site.konnect_short_name }} CRDs today and what you'd like to see next.
80166
- type: button
81167
config:
82168
text: Open a GitHub issue
83169
url: https://github.com/kong/gateway-operator/issues/new
84-
- blocks:
85170
- type: table
86171
config:
87172
columns:

0 commit comments

Comments
 (0)