3
0
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
..

= 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