Merge pull request #18 from kevgliss/master

Docfixes
This commit is contained in:
kevgliss 2015-07-06 16:33:25 -07:00
commit 10569c6102
3 changed files with 35 additions and 36 deletions

View File

@ -48,7 +48,7 @@ master_doc = 'index'
# General information about the project. # General information about the project.
project = u'lemur' project = u'lemur'
copyright = u'2015, Kevin Glisson' copyright = u'2015, Netflix Inc.'
# The version info for the project you're documenting, acts as replacement for # The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the # |version| and |release|, also used in various other places throughout the

View File

@ -106,7 +106,7 @@ You can make some adjustments to get a better user experience::
} }
location / { location / {
root /apps/lemur/lemur/static/dist; root /www/lemur/lemur/static/dist;
index index.html; index index.html;
} }
@ -171,7 +171,7 @@ sensitive nature of Lemur and what it controls makes this essential. This is a s
} }
location / { location / {
root /apps/lemur/lemur/static/dist; root /www/lemur/lemur/static/dist;
index index.html; index index.html;
} }

View File

@ -92,6 +92,8 @@ that be easier to setup in your environment.
Once created you will need to update the configuration file with information about your environment, Once created you will need to update the configuration file with information about your environment,
such as which database to talk to, where keys are stores etc.. such as which database to talk to, where keys are stores etc..
.. _InitializingLemur:
Initializing Lemur Initializing Lemur
------------------ ------------------
@ -119,22 +121,6 @@ administer Lemur.
for details. for details.
Starting the Web Service
------------------------
Lemur provides a built-in webserver (powered by gunicorn and eventlet) to get you off the ground quickly.
To start the webserver, you simply use ``lemur start``. If you opted to use an alternative configuration path
you can pass that via the --config option.
::
# Lemur's server runs on port 5000 by default. Make sure your client reflects
# the correct host and port!
lemur --config=/etc/lemur.conf.py start
You should now be able to test the web service by visiting `http://localhost:5000/`.
Setup a Reverse Proxy Setup a Reverse Proxy
--------------------- ---------------------
@ -145,34 +131,47 @@ you setup a simple web proxy.
Proxying with Nginx Proxying with Nginx
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
You'll use the builtin HttpProxyModule within Nginx to handle proxying:: You'll use the builtin HttpProxyModule within Nginx to handle proxying
location / { ::
proxy_pass http://localhost:5000;
location /api {
proxy_pass http://127.0.0.1:5000;
proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
proxy_redirect off; proxy_redirect off;
proxy_buffering off;
proxy_set_header Host $host; proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme; }
location / {
root /www/lemur/lemur/static/dist;
index index.html;
} }
See :doc:`../production/index` for more details on using Nginx. See :doc:`../production/index` for more details on using Nginx.
Proxying with Apache
~~~~~~~~~~~~~~~~~~~~
Apache requires the use of mod_proxy for forwarding requests:: Starting the Web Service
------------------------
ProxyPass / http://localhost:5000/ Lemur provides a built-in webserver (powered by gunicorn and eventlet) to get you off the ground quickly.
ProxyPassReverse / http://localhost:5000/
ProxyPreserveHost On
RequestHeader set X-Forwarded-Proto "https" env=HTTPS
You will need to enable ``headers``, ``proxy``, and ``proxy_http`` apache modules to use these settings. To start the webserver, you simply use ``lemur start``. If you opted to use an alternative configuration path
you can pass that via the --config option.
See :doc:`../production/index` for more details on using Apache. .. note::
You can login with the default user created during :ref:`Initializing Lemur <InitializingLemur>` or any other
user you may have created.
::
# Lemur's server runs on port 5000 by default. Make sure your client reflects
# the correct host and port!
lemur --config=/etc/lemur.conf.py start -b 127.0.0.1:5000
You should now be able to test the web service by visiting `http://localhost:5000/`.
Running Lemur as a Service Running Lemur as a Service
--------------------------- ---------------------------