Merge pull request #7331 from olofvndrhr/main

[Docs] Update Traefik ingress documentation and fix MetalLB docs

Author: ncopa

docs/examples/metallb-loadbalancer.md

@@ -26,8 +26,10 @@ See the MetalLB requirements in the [MetalLB's official documentation](https://m
 ```yaml
 apiVersion: k0s.k0sproject.io/v1beta1
 kind: ClusterConfig
+
 metadata:
   name: k0s
+
 spec:
   network:
     kubeProxy:
@@ -42,44 +44,53 @@ Port 7946 (TCP & UDP) must be allowed between the nodes. In addition, before ins
 
 1. Install MetalLB using the official Helm chart and k0s Helm [extension manager](../helm-charts.md):
 
-    ```shell
-    apiVersion: k0s.k0sproject.io/v1beta1
-    kind: ClusterConfig
-      metadata:
-    name: k0s
-    spec:
-      extensions:
-        helm:
-          repositories:
-          - name: metallb
-            url: https://metallb.github.io/metallb
-          charts:
-          - name: metallb
-            chartname: metallb/metallb
-            namespace: metallb
-    ```
-
-    Other installation methods are available in the [MetalLB's official documentation](https://metallb.org/installation/).
+   ```yaml
+   apiVersion: k0s.k0sproject.io/v1beta1
+   kind: ClusterConfig
+
+   metadata:
+     name: k0s
+
+   spec:
+     extensions:
+       helm:
+         repositories:
+           - name: metallb
+             url: https://metallb.github.io/metallb
+
+         charts:
+           - name: metallb
+             chartname: metallb/metallb
+             version: "0.15.3"
+             namespace: metallb-system
+   ```
+
+   Other installation methods are available in the [MetalLB's official documentation](https://metallb.org/installation/).
 
 2. Create ConfigMap for MetalLB
 
-    Next you need to create ConfigMap, which includes an IP address range for the load balancer. The pool of IPs must be dedicated to MetalLB's use. You can't reuse for example the Kubernetes node IPs or IPs controlled by other services. You can, however, use private IP addresses, for example 192.168.1.180-192.168.1.199, but then you need to take care of the routing from the external network if you need external access. In this example, we don't need it.
+   Next you need to create ConfigMap, which includes an IP address range for the load balancer. The pool of IPs must be dedicated to MetalLB's use. You can't reuse for example the Kubernetes node IPs or IPs controlled by other services. You can, however, use private IP addresses, for example 192.168.1.180-192.168.1.199, but then you need to take care of the routing from the external network if you need external access. In this example, we don't need it.
 
-    Create a YAML file accordingly, and deploy it: ```kubectl apply -f metallb-l2-pool.yaml```
+   Create a YAML file accordingly, and deploy it: `kubectl apply -f metallb-l2-pool.yaml`
 
    ```YAML
    ---
    apiVersion: metallb.io/v1beta1
    kind: IPAddressPool
+
    metadata:
      name: first-pool
      namespace: metallb-system
+
    spec:
      addresses:
-     - <ip-address-range-start>-<ip-address-range-stop>
+       - <ip-address-range-start>-<ip-address-range-stop>
+       # or
+       - <ip-address>/<cidr>
    ---
    apiVersion: metallb.io/v1beta1
    kind: L2Advertisement
+
    metadata:
      name: example
      namespace: metallb-system
@@ -90,14 +101,17 @@ Port 7946 (TCP & UDP) must be allowed between the nodes. In addition, before ins
    ```YAML
    apiVersion: v1
    kind: Namespace
+
    metadata:
      name: web
    ---
    apiVersion: apps/v1
    kind: Deployment
+
    metadata:
      name: web-server
      namespace: web
+
    spec:
      selector:
        matchLabels:
@@ -115,9 +129,11 @@ Port 7946 (TCP & UDP) must be allowed between the nodes. In addition, before ins
    ---
    apiVersion: v1
    kind: Service
+
    metadata:
      name: web-server-service
      namespace: web
+
    spec:
      selector:
        app: web
@@ -130,21 +146,21 @@ Port 7946 (TCP & UDP) must be allowed between the nodes. In addition, before ins
 
 4. Check your LoadBalancer
 
-    Run the following command to see your LoadBalancer with the external-ip and port.
+   Run the following command to see your LoadBalancer with the external-ip and port.
 
-    ```shell
-    kubectl get service -n web
-    ```
+   ```shell
+   kubectl get service -n web
+   ```
 
 5. Access your example application
 
-    If you used private IP addresses for MetalLB in the ConfigMap (in step 2), you should run the following command from the local network. Use the IP address from the previous step.
+   If you used private IP addresses for MetalLB in the ConfigMap (in step 2), you should run the following command from the local network. Use the IP address from the previous step.
 
-    ```shell
-    curl <EXTERNAL-IP>
-    ```
+   ```shell
+   curl <EXTERNAL-IP>
+   ```
 
-    If you are successful, you should see ```<html><body><h1>It works!</h1></body></html>```.
+   If you are successful, you should see `<html><body><h1>It works!</h1></body></html>`.
 
 ## Additional information