Feature/simple custom proxy domain

bin/workspace

@@ -18,6 +18,7 @@ function main(): void
         install();
     }
 
+    putenv('MY127WS_WORKSPACE_BIN='.($_SERVER['argv'][0] ?? __FILE__));
     putenv('PATH='.home().'/.my127/workspace/bin:'.getenv('PATH'));
     $exitStatus = application()->run();
 

box.json

@@ -10,7 +10,8 @@
   "files-bin": [
     "home/service/logger/.env",
     "home/service/mail/.env",
-    "home/service/proxy/.env"
+    "home/service/proxy/.env",
+    "home/service/tracing/.env"
   ],
   "blacklist": [
     "tools/scripts/compile.sh",

config/workspace/global.yml

@@ -1,23 +1,27 @@
 
-command('global service logger (enable|disable)', 'global service logger'): |
-  #!bash|=
-  ws-service logger ={input.command(4)}
+command('global service logger (enable|disable)', 'global service logger'):
+  description: Actions for the logging service
+  exec: |
+    #!bash|=
+    ws-service logger ={input.command(4)}
 
 command('global service mail (enable|disable)', 'global service mail'):
-  description: Actions for mailhog (mail.my127.site)
+  description: Actions for mailhog
   exec: |
     #!bash|=
     ws-service mail ={input.command(4)}
 
 command('global service proxy (enable|disable|restart)', 'global service proxy'):
-  description: Actions for Traefik proxy (my127.site)
+  description: Actions for Traefik proxy
   exec: |
     #!bash|=
     ws-service proxy ={input.command(4)}
 
-command('global service tracing (start|stop|restart)', 'global service tracing'): |
-  #!bash|=
-  ws-service tracing ={input.command(4)}
+command('global service tracing (start|stop|restart)', 'global service tracing'):
+  description: Actions for the tracing service
+  exec: |
+    #!bash|=
+    ws-service tracing ={input.command(4)}
 
 command('global service', 'global service'):
   description: Perform an action (start/stop etc.) on a global service

docs/cheatsheet.md

@@ -10,6 +10,24 @@ You need only to restart the Traefik proxy service:
 ws global service proxy restart
 ```
 
+## Custom proxy domain
+
+See [Custom Global Proxy Domain](custom-proxy-domain.md) for the full setup.
+
+Minimal global config file:
+
+```text
+~/.config/my127/workspace/proxy.yml
+```
+
+```yaml
+attribute('global.service.proxy.domain'): dev.example.test
+attribute('global.service.proxy.https.crt'): https://example.test/dev.example.test.crt
+attribute('global.service.proxy.https.key'): https://example.test/dev.example.test.key
+```
+
+Restart the proxy after changing these values.
+
 ## How-to receive email
 
 The email service is not running by default. It can be started with:
@@ -18,6 +36,6 @@ The email service is not running by default. It can be started with:
 ws global service mail enable
 ```
 
-This will allow email to be viewed at `https://mail.my127.site/`
+This will allow email to be viewed at `https://mail.<proxy-domain>/`
 
-This will collect email sent from any server through native `sendmail`.
+This will collect email sent from any server through native `sendmail`.