feat: add backends config option for nginx

.github/workflows/pr-nginx-tests.yml

@@ -34,6 +34,7 @@ jobs:
           - examples/1.17
           - examples/1.16
           - examples/custom
+          - examples/backends
 
     steps:
       - name: Checkout code

examples/backends/.lando.yml

@@ -0,0 +1,27 @@
+name: lando-nginx-backends
+services:
+  frontend:
+    type: nginx:1.29
+    webroot: .
+    backends:
+      - backend1
+      - backend2
+    build_as_root:
+      - apt-get update && apt-get install -y curl
+    config:
+      vhosts: config/proxy.conf
+  backend1:
+    type: nginx:1.29
+    webroot: backend1
+    build_as_root:
+      - apt-get update && apt-get install -y curl
+  backend2:
+    type: nginx:1.29
+    webroot: backend2
+    build_as_root:
+      - apt-get update && apt-get install -y curl
+
+# This is important because it lets lando know to test against the plugin in this repo
+# DO NOT REMOVE THIS!
+plugins:
+  "@lando/nginx": ../..

examples/backends/README.md

@@ -0,0 +1,52 @@
+# NGINX Backends Example
+
+This example exists primarily to test the following documentation:
+
+* [nginx Service](https://docs.lando.dev/plugins/nginx)
+
+## Start up tests
+
+Run the following commands to get up and running with this example.
+
+```bash
+# Should start up successfully
+lando poweroff
+lando start
+```
+
+## Verification commands
+
+Run the following commands to validate things are rolling as they should.
+
+```bash
+# Should serve frontend content from the app root
+lando ssh -s frontend -c "curl -s http://localhost" | grep FRONTEND
+
+# Should be able to reach backend1 through the frontend proxy
+lando ssh -s frontend -c "curl -s http://localhost/backend1/" | grep BACKEND1
+
+# Should be able to reach backend2 through the frontend proxy
+lando ssh -s frontend -c "curl -s http://localhost/backend2/" | grep BACKEND2
+
+# Should have backend1 as a dependency of frontend
+lando info -s frontend --format json | grep backend1
+
+# Should have backend2 as a dependency of frontend
+lando info -s frontend --format json | grep backend2
+
+# Should serve backend1 directly on its own port
+lando ssh -s backend1 -c "curl -s http://localhost" | grep BACKEND1
+
+# Should serve backend2 directly on its own port
+lando ssh -s backend2 -c "curl -s http://localhost" | grep BACKEND2
+```
+
+## Destroy tests
+
+Run the following commands to trash this app like nothing ever happened.
+
+```bash
+# Should be destroyed with success
+lando destroy -y
+lando poweroff
+```

examples/backends/backend1/index.html

@@ -0,0 +1 @@
+BACKEND1

examples/backends/backend2/index.html

@@ -0,0 +1 @@
+BACKEND2

examples/backends/config/proxy.conf

@@ -0,0 +1,21 @@
+server {
+    listen 80;
+    server_name localhost;
+
+    location /backend1 {
+        proxy_pass http://backend1:80/;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+
+    location /backend2 {
+        proxy_pass http://backend2:80/;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+
+    location / {
+        root "{{LANDO_WEBROOT}}";
+        index index.html;
+    }
+}

examples/backends/index.html

@@ -0,0 +1 @@
+FRONTEND