|
1 | 1 | ---
|
2 | 2 | ---
|
3 | 3 |
|
4 |
| -Follow the steps from the [Quickstart](../tasks/quickstart) task to install Envoy Gateway and the example manifest. |
5 |
| -Before proceeding, you should be able to query the example backend using HTTP. |
| 4 | +Follow the steps below to install Envoy Gateway and the example manifest. Before |
| 5 | +proceeding, you should be able to query the example backend using HTTP. |
6 | 6 |
|
7 |
| -Verify the Gateway status: |
| 7 | +<details> |
| 8 | +<summary>Expand for instructions</summary> |
8 | 9 |
|
9 |
| -{{< tabpane text=true >}} |
10 |
| -{{% tab header="kubectl" %}} |
| 10 | +1. Install the Gateway API CRDs and Envoy Gateway using Helm: |
11 | 11 |
|
12 |
| -```shell |
13 |
| -kubectl get gateway/eg -o yaml |
14 |
| -``` |
| 12 | + ```shell |
| 13 | + helm install eg oci://docker.io/envoyproxy/gateway-helm --version {{< helm-version >}} -n envoy-gateway-system --create-namespace |
| 14 | + ``` |
15 | 15 |
|
16 |
| -{{% /tab %}} |
17 |
| -{{% tab header="egctl (experimental)" %}} |
| 16 | +2. Install the GatewayClass, Gateway, HTTPRoute and example app: |
18 | 17 |
|
19 |
| -```shell |
20 |
| -egctl x status gateway -v |
21 |
| -``` |
| 18 | + ```shell |
| 19 | + kubectl apply -f https://github.com/envoyproxy/gateway/releases/download/{{< yaml-version >}}/quickstart.yaml -n default |
| 20 | + ``` |
22 | 21 |
|
23 |
| -{{% /tab %}} |
24 |
| -{{< /tabpane >}} |
| 22 | +3. Verify Connectivity: |
| 23 | + |
| 24 | + {{< tabpane text=true >}} |
| 25 | + {{% tab header="With External LoadBalancer Support" %}} |
| 26 | + |
| 27 | + You can also test the same functionality by sending traffic to the External IP. To get the external IP of the |
| 28 | + Envoy service, run: |
| 29 | + |
| 30 | + ```shell |
| 31 | + export GATEWAY_HOST=$(kubectl get gateway/eg -o jsonpath='{.status.addresses[0].value}') |
| 32 | + ``` |
| 33 | + |
| 34 | + **Note**: In certain environments, the load balancer may be exposed using a hostname, instead of an IP address. If so, replace |
| 35 | + `ip` in the above command with `hostname`. |
| 36 | + |
| 37 | + Curl the example app through Envoy proxy: |
| 38 | + |
| 39 | + ```shell |
| 40 | + curl --verbose --header "Host: www.example.com" http://$GATEWAY_HOST/get |
| 41 | + ``` |
| 42 | + |
| 43 | + {{% /tab %}} |
| 44 | + {{% tab header="Without LoadBalancer Support" %}} |
| 45 | + |
| 46 | + Get the name of the Envoy service created by the example Gateway: |
| 47 | + |
| 48 | + ```shell |
| 49 | + export ENVOY_SERVICE=$(kubectl get svc -n envoy-gateway-system --selector=gateway.envoyproxy.io/owning-gateway-namespace=default,gateway envoyproxy.io/owning-gateway-name=eg -o jsonpath='{.items[0].metadata.name}') |
| 50 | + ``` |
| 51 | + |
| 52 | + Port forward to the Envoy service: |
| 53 | + |
| 54 | + ```shell |
| 55 | + kubectl -n envoy-gateway-system port-forward service/${ENVOY_SERVICE} 8888:80 & |
| 56 | + ``` |
| 57 | + |
| 58 | + Curl the example app through Envoy proxy: |
| 59 | + |
| 60 | + ```shell |
| 61 | + curl --verbose --header "Host: www.example.com" http://localhost:8888/get |
| 62 | + ``` |
| 63 | + |
| 64 | + {{% /tab %}} |
| 65 | + {{< /tabpane >}} |
| 66 | + |
| 67 | +</details> |
| 68 | + |
| 69 | +--- |
0 commit comments