mirror of
https://github.com/kakwa/uts-server
synced 2024-11-11 12:08:54 +01:00
explicitly mention BUNDLE_CIVETWEB has a developpment/testing option
This commit is contained in:
parent
4b40fd97a7
commit
55dea707b9
@ -48,12 +48,17 @@ Some use cases:
|
|||||||
* time-stamp log files at rotation time.
|
* time-stamp log files at rotation time.
|
||||||
* time-stamp file at upload to prove it was delivered in due time or not.
|
* time-stamp file at upload to prove it was delivered in due time or not.
|
||||||
|
|
||||||
Quick Start
|
Quick (and dirty) Testing
|
||||||
-----------
|
-------------------------
|
||||||
|
|
||||||
|
Here a few steps to quickly trying out uts-server, for production setup, please compile civetweb externally and create proper CA and certificates:
|
||||||
|
|
||||||
.. sourcecode:: bash
|
.. sourcecode:: bash
|
||||||
|
|
||||||
# Building with civetweb embedded (will recover civetweb from github).
|
# Building with civetweb embedded (will recover civetweb from github).
|
||||||
|
# Note: the BUNDLE_CIVETWEB option is only here for fast testing purpose
|
||||||
|
# The recommended way to deploy uts-server in production is to build civetweb
|
||||||
|
# separatly and to link against it.
|
||||||
$ cmake . -DBUNDLE_CIVETWEB=ON
|
$ cmake . -DBUNDLE_CIVETWEB=ON
|
||||||
$ make
|
$ make
|
||||||
|
|
||||||
|
@ -12,10 +12,10 @@ List of dependencies uts-server relies on to run:
|
|||||||
Build dependencies
|
Build dependencies
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
List of dependencies needed to build civetweb:
|
List of dependencies needed to build uts-server:
|
||||||
|
|
||||||
* cmake
|
* `CMake <https://cmake.org/>`_
|
||||||
* either gcc or clang
|
* either `gcc <https://gcc.gnu.org/>`_ or `clang <https://clang.llvm.org/>`_
|
||||||
|
|
||||||
Compilation
|
Compilation
|
||||||
===========
|
===========
|
||||||
@ -28,12 +28,14 @@ uts-server is compiled using cmake:
|
|||||||
$ cmake .
|
$ cmake .
|
||||||
$ make
|
$ make
|
||||||
|
|
||||||
# If civetweb is not present
|
# If civetweb is not present.
|
||||||
# this will get the proper tag of civetweb from upstream and compile it
|
# this will get the master branch of civetweb from upstream and compile it.
|
||||||
|
# Only for developpment/testing purposes
|
||||||
$ cmake . -DBUNDLE_CIVETWEB=ON
|
$ cmake . -DBUNDLE_CIVETWEB=ON
|
||||||
$ make
|
$ make
|
||||||
|
|
||||||
# Compile with debug flags
|
# Compile with debug flags
|
||||||
|
# Only for developpment/testing purposes
|
||||||
$ cmake . -DDEBUG=ON
|
$ cmake . -DDEBUG=ON
|
||||||
$ make
|
$ make
|
||||||
|
|
||||||
@ -43,3 +45,16 @@ uts-server is compiled using cmake:
|
|||||||
# add -DDL_LINK=ON and/or -DGCC_S_LINK=ON)
|
# add -DDL_LINK=ON and/or -DGCC_S_LINK=ON)
|
||||||
$ cmake . -DSTATIC=ON # -DDL_LINK=ON -DGCC_S_LINK=ON
|
$ cmake . -DSTATIC=ON # -DDL_LINK=ON -DGCC_S_LINK=ON
|
||||||
$ make
|
$ make
|
||||||
|
|
||||||
|
.. warning::
|
||||||
|
|
||||||
|
The BUNDLE_CIVETWEB exists only for developpment/testing purposes.
|
||||||
|
|
||||||
|
Please compile civetweb externally for building a production binary.
|
||||||
|
|
||||||
|
Using this option outside of developpment/testing is a bad idea for the
|
||||||
|
following reasons:
|
||||||
|
|
||||||
|
* having an external download in a build process is a bad idea
|
||||||
|
* recovering the master branch ensures that the build may break randomly
|
||||||
|
* a build proccess should be reproductible which is not the case with this option
|
||||||
|
Loading…
Reference in New Issue
Block a user