diff options
author | Marcello Stanisci <stanisci.m@gmail.com> | 2018-01-03 10:47:19 +0100 |
---|---|---|
committer | Marcello Stanisci <stanisci.m@gmail.com> | 2018-01-03 10:47:19 +0100 |
commit | ad31fbb87fd62fdef0c8440ffc1f4c35f5aea9ea (patch) | |
tree | f1dbf177ad14bdb937337e958fcd1ca258ece5f4 /doc/onboarding.texi | |
parent | cf1c356f9c4db5572c47d0e71962b94a177070b4 (diff) | |
download | deployment-ad31fbb87fd62fdef0c8440ffc1f4c35f5aea9ea.tar.gz deployment-ad31fbb87fd62fdef0c8440ffc1f4c35f5aea9ea.tar.bz2 deployment-ad31fbb87fd62fdef0c8440ffc1f4c35f5aea9ea.zip |
documenting /landing's serving
Diffstat (limited to 'doc/onboarding.texi')
-rw-r--r-- | doc/onboarding.texi | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/doc/onboarding.texi b/doc/onboarding.texi index 6ed2024..adfe58e 100644 --- a/doc/onboarding.texi +++ b/doc/onboarding.texi @@ -59,6 +59,48 @@ Texts. A copy of the license is included in the section entitled @node Taler.net @chapter Taler.net +@section Landing page + +The 'landing' page is the first page that should be visited during a "demo session". +It is statically served and hosted at @code{$USER/landing/}, where @code{$USER} is one +of @code{test-@{blue,green@}} or @code{demo-@{blue,green@}}. Its source code is +available at the repository: @code{git://taler.net/landing}. + +Before being served, the site needs to be compiled, to make the i18n content. The +compilation is done in the following way: + +@example +$ cd <landing's top directory> +$ git submodule update --force --init +$ AUTOMAKE="automake --foreign" autoreconf -fiv +$ ./configure +$ cd demo/ +$ make + +# NOTE: the sysadmin will _hardly_ need to do this manually, as there are deployment +# scripts in charge of the compilation. +@end example + +The most interesting part of nginx's configuration that serves the landing page +is the following one: + +@example + +location / @{ + ... + # always default to english + rewrite ^/$ /en/ redirect; + # explicit append of "index.html" + rewrite ^/(..)/$ /$1/index.html break; + ... + # NOTE: /home/test/landing and /home/demo/landing + # are symlinks to the currently active "blue or green" party. + # Next chapters explain the "blue/green" deployment technique. + root /home/<'test' or 'demo'>/landing/demo; + ... + @} +@end example + @section Git Git at @code{taler.net} is managed by @emph{gitolite}. Creation and deletion |