@@ -53,6 +53,12 @@ Wait a bit to finish building and go to
5353* http://wordpress.wordpress-docker-compose.localhost:8080 - wordpress app
5454* http://phpmyadmin.wordpress-docker-compose.localhost:8080 - for phpmyadmin app
5555
56+ ## Automatic UI/dashboard
57+
58+ Index page automatically generated for unknown domain. Ex: http://localhost:8080
59+
60+ ![ image] ( https://user-images.githubusercontent.com/6597086/127631968-85a8eaa9-1605-4ca0-ba52-7943da536d1a.png )
61+
5662
5763
5864## Supported OS
@@ -70,7 +76,7 @@ Wait a bit to finish building and go to
7076 * [ ] OIDC
7177* [ ] support dynamic reconfiguration (over API/by file watch + signal)
7278* [ ] support GitHub-like webhooks
73- * [ ] lazy initialization
79+ * [ ] lazy initialization (ie: bring up service on request only)
7480* [x] path routing as alternative to domain-based
7581
7682## Installation
@@ -149,14 +155,13 @@ Flow:
149155
150156* Deploys all services.
151157* All ports in ` ports ` directive will be linked as sub-domains
152- * Root compose file supports optional ` x-domain ` attribute which overrides domain prefix. Default is repo name (or FQDN)
153- .
154- * Each service with at least one port supports an optional ` x-domain ` attribute which overrides sub-domain. Default is
158+ * Each service with at least one port supports an optional ` domainname ` attribute which overrides sub-domain. Default is
155159 service name.
156160* First services with attribute ` x-root: yes ` or with name ` www ` , ` web ` , ` gateway ` will be additionally exposed without
157161 sub-domain.
158162* All exposed ports will be additionally exposed as sub-sub-domain with port name as the name.
159163* Volumes automatically backup-ed and restored (see Backup)
164+ * Root port for service picked by the same rules as for [ docker] ( #docker )
160165
161166Domains will be generated as> ` <port?>.<x-domain|service>.<x-domain|project>.<root-domain> `
162167and ` <x-domain|project>.<root-domain> ` points to ` <first x-root: true|www|web|gateway> `
@@ -190,25 +195,24 @@ Generated mapping (root domain (`-d,--domain,$DOMAIN`) is `localhost`):
190195* `api.mini.localhost` - points `api` service to internal port `80`
191196* `80.api.mini.localhost` - same
192197
193- Root domain : ` mini.localhost` points to `web` service to internal port `80` (the first service with name `web`, first port
194- in array)
198+ Root domain : ` mini.localhost` points to `web` service to internal port `80` (the first service with name `web`, first
199+ port in array)
195200
196201
197202
198203# ## Override everything example
199204
200205` ` ` yaml
201206version: '3'
202- x-domain: super
203207services:
204208 web:
205- x-domain : index
209+ domainname : index
206210 image: nginx
207211 ports:
208212 - 8080:80
209213 - 8081:9000
210214 api:
211- x-domain : echo
215+ domainname : echo
212216 x-root: yes
213217 image: hashicorp/http-echo
214218 command: -listen :80 -text "web"
@@ -226,8 +230,8 @@ Generated mapping (root domain (`-d,--domain,$DOMAIN`) is `localhost`):
226230* `echo.super.localhost` - points `api` service to internal port `80`
227231* `80.echo.super.localhost` - same
228232
229- Root domain : ` super.localhost` points to `api` service to internal port `80` (the first service with `x-root: yes`, first
230- port in array)
233+ Root domain : ` super.localhost` points to `api` service to internal port `80` (the first service with `x-root: yes`,
234+ first port in array)
231235
232236
233237# # Backup
@@ -548,6 +552,27 @@ Example how to generate for multiple same clients:
548552
549553 git-pipe jwt -s changeme my-client-1 my-client-2 my-client-3 my-client-4
550554
555+ # # Health check
556+
557+ git-pipe supports health checks in single Dockerfile repositories. It will not route traffic to the service until
558+ container will become healthy.
559+
560+ See [how to define health check in Dockerfile](https://docs.docker.com/engine/reference/builder/#healthcheck).
561+
562+ Example for common HTTP service :
563+
564+ ` ` `
565+ FROM my-service
566+ EXPOSE 80
567+
568+
569+ ## ....
570+ HEALTHCHECK --interval=3s CMD curl -f http://localhost:80/health || exit 1
571+
572+
573+ ## ...
574+ ` ` `
575+
551576# # Usage
552577
553578
0 commit comments