commit
10569c6102
|
@ -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
|
||||||
|
|
|
@ -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;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
---------------------------
|
---------------------------
|
||||||
|
|
Loading…
Reference in New Issue