@@ -53,6 +53,7 @@ Run the following command:
53
53
` ` ` shell
54
54
kind create cluster --config cluster-config.yaml
55
55
```
56
+
56
57
``` text
57
58
Creating cluster "kind" ...
58
59
✓ Ensuring node image (kindest/node:v1.31.0) 🖼
@@ -75,6 +76,7 @@ If you have cloned [the NGINX Gateway Fabric repository](https://github.com/ngin
75
76
``` shell
76
77
make create-kind-cluster
77
78
```
79
+
78
80
{{< /note >}}
79
81
80
82
---
@@ -86,8 +88,9 @@ make create-kind-cluster
86
88
Use ` kubectl ` to add the API resources for NGINX Gateway Fabric with the following command:
87
89
88
90
``` shell
89
- kubectl kustomize " https://github.com/nginxinc/nginx-gateway-fabric/config/crd/gateway-api/standard?ref=v1.4 .0" | kubectl apply -f -
91
+ kubectl kustomize " https://github.com/nginxinc/nginx-gateway-fabric/config/crd/gateway-api/standard?ref=v1.5 .0" | kubectl apply -f -
90
92
```
93
+
91
94
``` text
92
95
customresourcedefinition.apiextensions.k8s.io/gatewayclasses.gateway.networking.k8s.io created
93
96
customresourcedefinition.apiextensions.k8s.io/gateways.gateway.networking.k8s.io created
@@ -100,8 +103,9 @@ customresourcedefinition.apiextensions.k8s.io/referencegrants.gateway.networking
100
103
To use experimental features, you'll need to install the API resources from the experimental channel instead.
101
104
102
105
``` shell
103
- kubectl kustomize " https://github.com/nginxinc/nginx-gateway-fabric/config/crd/gateway-api/experimental?ref=v1.4 .0" | kubectl apply -f -
106
+ kubectl kustomize " https://github.com/nginxinc/nginx-gateway-fabric/config/crd/gateway-api/experimental?ref=v1.5 .0" | kubectl apply -f -
104
107
```
108
+
105
109
{{< /note >}}
106
110
107
111
---
@@ -113,8 +117,9 @@ Use `helm` to install NGINX Gateway Fabric with the following command:
113
117
``` shell
114
118
helm install ngf oci://ghcr.io/nginxinc/charts/nginx-gateway-fabric --create-namespace -n nginx-gateway --set service.create=false
115
119
```
120
+
116
121
``` text
117
- Pulled: ghcr.io/nginxinc/charts/nginx-gateway-fabric:1.4 .0
122
+ Pulled: ghcr.io/nginxinc/charts/nginx-gateway-fabric:1.5 .0
118
123
Digest: sha256:9bbd1a2fcbfd5407ad6be39f796f582e6263512f1f3a8969b427d39063cc6fee
119
124
NAME: ngf
120
125
LAST DEPLOYED: Mon Oct 21 14:45:14 2024
@@ -130,6 +135,7 @@ If you installed the API resources from the experimental channel during the last
130
135
``` shell
131
136
helm install ngf oci://ghcr.io/nginxinc/charts/nginx-gateway-fabric --create-namespace -n nginx-gateway --set service.create=false --set nginxGateway.gwAPIExperimentalFeatures.enable=true
132
137
```
138
+
133
139
{{< /note >}}
134
140
135
141
---
@@ -151,7 +157,7 @@ metadata:
151
157
labels :
152
158
app.kubernetes.io/name : nginx-gateway-fabric
153
159
app.kubernetes.io/instance : ngf
154
- app.kubernetes.io/version : " 1.4 .0"
160
+ app.kubernetes.io/version : " 1.5 .0"
155
161
spec :
156
162
type : NodePort
157
163
selector :
@@ -175,6 +181,7 @@ Apply it using `kubectl`:
175
181
` ` ` shell
176
182
kubectl apply -f nodeport-config.yaml
177
183
` ` `
184
+
178
185
` ` ` text
179
186
service/nginx-gateway created
180
187
` ` `
@@ -201,13 +208,14 @@ The YAML code in the following sections can be found in the [cafe-example folder
201
208
202
209
Create the file _cafe.yaml_ with the following contents :
203
210
204
- {{< ghcode " https://raw.githubusercontent.com/nginxinc/nginx-gateway-fabric/refs/heads/main/examples/cafe-example/cafe.yaml" >}}
211
+ {{< ghcode ` https://raw.githubusercontent.com/nginxinc/nginx-gateway-fabric/refs/heads/main/examples/cafe-example/cafe.yaml` >}}
205
212
206
- Apply it :
213
+ Apply it using `kubectl` :
207
214
208
215
` ` ` shell
209
216
kubectl apply -f cafe.yaml
210
217
` ` `
218
+
211
219
` ` ` text
212
220
deployment.apps/coffee created
213
221
service/coffee created
@@ -220,6 +228,7 @@ Verify that the new pods are in the `default` namespace:
220
228
` ` ` shell
221
229
kubectl -n default get pods
222
230
` ` `
231
+
223
232
` ` ` text
224
233
NAME READY STATUS RESTARTS AGE
225
234
coffee-6db967495b-wk2mm 1/1 Running 0 10s
@@ -232,26 +241,28 @@ tea-7b7d6c947d-d4qcf 1/1 Running 0 10s
232
241
233
242
Create the file _gateway.yaml_ with the following contents :
234
243
235
- {{< ghcode " https://raw.githubusercontent.com/nginxinc/nginx-gateway-fabric/refs/heads/main/examples/cafe-example/gateway.yaml" >}}
244
+ {{< ghcode ` https://raw.githubusercontent.com/nginxinc/nginx-gateway-fabric/refs/heads/main/examples/cafe-example/gateway.yaml` >}}
236
245
237
246
Apply it using `kubectl` :
238
247
239
248
` ` ` shell
240
249
kubectl apply -f gateway.yaml
241
250
` ` `
251
+
242
252
` ` ` text
243
253
gateway.gateway.networking.k8s.io/gateway created
244
254
` ` `
245
255
246
256
Create the file _cafe-routes.yaml_ with the following contents :
247
257
248
- {{< ghcode " https://raw.githubusercontent.com/nginxinc/nginx-gateway-fabric/refs/heads/main/examples/cafe-example/cafe-routes.yaml" >}}
258
+ {{< ghcode ` https://raw.githubusercontent.com/nginxinc/nginx-gateway-fabric/refs/heads/main/examples/cafe-example/cafe-routes.yaml` >}}
249
259
250
260
Apply it using `kubectl` :
251
261
252
262
` ` ` shell
253
263
kubectl apply -f cafe-routes.yaml
254
264
` ` `
265
+
255
266
` ` ` text
256
267
httproute.gateway.networking.k8s.io/coffee created
257
268
httproute.gateway.networking.k8s.io/tea created
@@ -266,6 +277,7 @@ You can check that all of the expected services are available using `kubectl get
266
277
` ` ` shell
267
278
kubectl get service --all-namespaces
268
279
` ` `
280
+
269
281
` ` ` text
270
282
NAMESPACE NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
271
283
default coffee ClusterIP 10.96.18.163 <none> 80/TCP 2m51s
@@ -280,6 +292,7 @@ You can also use `kubectl describe` on the new resources to check their status:
280
292
` ` ` shell
281
293
kubectl describe httproutes
282
294
` ` `
295
+
283
296
` ` ` text
284
297
Name: coffee
285
298
Namespace: default
@@ -394,6 +407,7 @@ Events: <none>
394
407
` ` ` shell
395
408
kubectl describe gateways
396
409
` ` `
410
+
397
411
` ` ` text
398
412
Name: gateway
399
413
Namespace: default
@@ -480,6 +494,7 @@ You can use `curl` to test the new services by targeting the hostname (_cafe.exa
480
494
` ` ` shell
481
495
curl --resolve cafe.example.com:8080:127.0.0.1 http://cafe.example.com:8080/coffee
482
496
` ` `
497
+
483
498
` ` ` text
484
499
Server address: 10.244.0.6:8080
485
500
Server name: coffee-6db967495b-wk2mm
@@ -491,6 +506,7 @@ Request ID: fb226a54fd94f927b484dd31fb30e747
491
506
` ` ` shell
492
507
curl --resolve cafe.example.com:8080:127.0.0.1 http://cafe.example.com:8080/tea
493
508
` ` `
509
+
494
510
` ` ` text
495
511
Server address: 10.244.0.7:8080
496
512
Server name: tea-7b7d6c947d-d4qcf
0 commit comments