3
0
corteza/webapp/README.adoc
Denis Arh 1d59a3acf2 Allow custom URL prefix for all corteza endpoints
Add new env. variables and options
 - HTTP_BASE_URL to control URL prefix, defaults to /
 - HTTP_SSL_TERMINATED to explicitly set if Corteza is running behind HTTPS
Refresh and document webapp/Makefile with more dev tasks
Fix all absolute URLs in applications, logos, icons
Improve logic behind integrated webapp serving, inject/replace <base href> tag according to URL prefix
Prevent mounting api & webapps to the same base
2021-05-09 16:47:19 +02:00

55 lines
1.2 KiB
Plaintext

= Web applications
Rationale behind `/webapp/...` tools is to allow backend developers to quickly test server with frontend applications.
Tools (see Makefile) download and install unstable (can be changed with `VERSION` var).
.Downloads and installs packages under webapp/public using current version
[source,shell]
----
make
----
.Downloads and installs packages under webapp/public using specific version
[source,shell]
----
make VERSION=2021.3.3
----
. All available make targets
[cols="2m,5a"]
|===
|target|
| all
| default target alias for install-packages
| install-package
| installs all packages
| download
| downloads all packages
| install-fresh
| builds and installs all packages from source
| install-fresh
| builds and installs all web applications from source
| build
| builds all web applications from source
| clean
| removes packages of the current versions
| cleaner
| removes all
|===
To enable serving of webapps from the server, make sure `HTTP_WEBAPP_ENABLED` is set to `true`.
This will prefix all API endpoints with `/api/`.
See `HTTP_API_BASE_URL`, `HTTP_WEBAPP_ENABLED`, `HTTP_WEBAPP_BASE_URL`, `HTTP_WEBAPP_BASE_DIR`, `HTTP_WEBAPP_LIST` for
details