Skip to content

Commit 18bee98

Browse files
committed
- doc updates
1 parent 3fde032 commit 18bee98

File tree

11 files changed

+25
-57
lines changed

11 files changed

+25
-57
lines changed

docs/.doctrees/environment.pickle

-977 Bytes
Binary file not shown.

docs/.doctrees/installation.doctree

918 Bytes
Binary file not shown.

docs/_sources/installation.txt

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,11 @@ When starting with Docker, see :any:`environment variables` for passing startup
4242

4343
ie. ``-e HQ_DEFAULT_URL='http://aa.com:1212'``
4444

45+
To run/install container:
46+
47+
``docker run -p 5000:5000 elastichq/elasticsearch-hq``
48+
49+
Access HQ with: http://localhost:5000
4550

4651
Pre-Releases
4752
^^^^^^^^^^^^
@@ -202,9 +207,11 @@ Upgrading Minor and Patch versions
202207
Running in Production
203208
---------------------
204209

205-
We advise that under any considerable usage/load, this application should be run with a multithreaded server. The current flask implemenation by itself should not be run in production without this, as it is a single-threaded process.
210+
We advise that under any considerable usage/load, this application should be run with a multithreaded server. The current flask implementation by itself should not be run in production without this, as it is a single-threaded process.
206211

207-
We recommend running this WSGI application with gunicorn. Install gunicorn by either commenting out the line in the ``requirements.txt`` file or simply running ``pip install gunicorn``
212+
We recommend running this WSGI application with gunicorn. The Docker container available on DockerHub is pre-configured to run with gunicorn, and is preferred. See the Docker Images section in this document for details.
213+
214+
If you wish to run without a container, install gunicorn by either commenting out the line in the ``requirements.txt`` file or simply running ``pip install gunicorn``
208215

209216
In console, run gunicorn with:
210217

@@ -216,8 +223,6 @@ Read the `Gunicorn Docs <http://docs.gunicorn.org/en/stable/configure.html>`_ fo
216223

217224
.. note:: For the *Metrics* section to broadcast via websocket, you must have gunicorn set to 1 worker.
218225

219-
.. note:: The Docker container available on DockerHub is pre-configured to run with gunicorn.
220-
221226
Troubleshooting
222227
---------------
223228

docs/_static/empty.file

Whitespace-only changes.

docs/installation.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,9 @@ <h3><a class="toc-backref" href="#id6">Docker Images</a><a class="headerlink" hr
197197
<p>The <code class="docutils literal"><span class="pre">latest</span></code> tag deploys the latest stable release. Where <code class="docutils literal"><span class="pre">develop</span></code> is the latest unstable working branch.</p>
198198
<p>When starting with Docker, see <a class="reference internal" href="#environment-variables"><span class="std std-ref">Environment Variables</span></a> for passing startup args. Environment variables are passed to docker using the <cite>-e</cite> flag.</p>
199199
<p>ie. <code class="docutils literal"><span class="pre">-e</span> <span class="pre">HQ_DEFAULT_URL='http://aa.com:1212'</span></code></p>
200+
<p>To run/install container:</p>
201+
<p><code class="docutils literal"><span class="pre">docker</span> <span class="pre">run</span> <span class="pre">-p</span> <span class="pre">5000:5000</span> <span class="pre">elastichq/elasticsearch-hq</span></code></p>
202+
<p>Access HQ with: <a class="reference external" href="http://localhost:5000">http://localhost:5000</a></p>
200203
</div>
201204
<div class="section" id="pre-releases">
202205
<h3><a class="toc-backref" href="#id7">Pre-Releases</a><a class="headerlink" href="#pre-releases" title="Permalink to this headline"></a></h3>
@@ -393,8 +396,9 @@ <h3><a class="toc-backref" href="#id19">Upgrading Minor and Patch versions</a><a
393396
</div>
394397
<div class="section" id="running-in-production">
395398
<h2><a class="toc-backref" href="#id20">Running in Production</a><a class="headerlink" href="#running-in-production" title="Permalink to this headline"></a></h2>
396-
<p>We advise that under any considerable usage/load, this application should be run with a multithreaded server. The current flask implemenation by itself should not be run in production without this, as it is a single-threaded process.</p>
397-
<p>We recommend running this WSGI application with gunicorn. Install gunicorn by either commenting out the line in the <code class="docutils literal"><span class="pre">requirements.txt</span></code> file or simply running <code class="docutils literal"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">gunicorn</span></code></p>
399+
<p>We advise that under any considerable usage/load, this application should be run with a multithreaded server. The current flask implementation by itself should not be run in production without this, as it is a single-threaded process.</p>
400+
<p>We recommend running this WSGI application with gunicorn. The Docker container available on DockerHub is pre-configured to run with gunicorn, and is preferred. See the Docker Images section in this document for details.</p>
401+
<p>If you wish to run without a container, install gunicorn by either commenting out the line in the <code class="docutils literal"><span class="pre">requirements.txt</span></code> file or simply running <code class="docutils literal"><span class="pre">pip</span> <span class="pre">install</span> <span class="pre">gunicorn</span></code></p>
398402
<p>In console, run gunicorn with:</p>
399403
<p><code class="docutils literal"><span class="pre">gunicorn</span> <span class="pre">-w</span> <span class="pre">1</span> <span class="pre">-b</span> <span class="pre">:5000</span> <span class="pre">--worker-class</span> <span class="pre">eventlet</span> <span class="pre">application:application</span></code></p>
400404
<p>The application will be accessible under <a class="reference external" href="http://127.0.0.1:5000">http://127.0.0.1:5000</a></p>
@@ -403,10 +407,6 @@ <h2><a class="toc-backref" href="#id20">Running in Production</a><a class="heade
403407
<p class="first admonition-title">Note</p>
404408
<p class="last">For the <em>Metrics</em> section to broadcast via websocket, you must have gunicorn set to 1 worker.</p>
405409
</div>
406-
<div class="admonition note">
407-
<p class="first admonition-title">Note</p>
408-
<p class="last">The Docker container available on DockerHub is pre-configured to run with gunicorn.</p>
409-
</div>
410410
</div>
411411
<div class="section" id="troubleshooting">
412412
<h2><a class="toc-backref" href="#id21">Troubleshooting</a><a class="headerlink" href="#troubleshooting" title="Permalink to this headline"></a></h2>

docs/objects.inv

-39 Bytes
Binary file not shown.

docs/searchindex.js

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/source/installation.rst

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,11 @@ When starting with Docker, see :any:`environment variables` for passing startup
4242

4343
ie. ``-e HQ_DEFAULT_URL='http://aa.com:1212'``
4444

45+
To run/install container:
46+
47+
``docker run -p 5000:5000 elastichq/elasticsearch-hq``
48+
49+
Access HQ with: http://localhost:5000
4550

4651
Pre-Releases
4752
^^^^^^^^^^^^
@@ -202,9 +207,11 @@ Upgrading Minor and Patch versions
202207
Running in Production
203208
---------------------
204209

205-
We advise that under any considerable usage/load, this application should be run with a multithreaded server. The current flask implemenation by itself should not be run in production without this, as it is a single-threaded process.
210+
We advise that under any considerable usage/load, this application should be run with a multithreaded server. The current flask implementation by itself should not be run in production without this, as it is a single-threaded process.
206211

207-
We recommend running this WSGI application with gunicorn. Install gunicorn by either commenting out the line in the ``requirements.txt`` file or simply running ``pip install gunicorn``
212+
We recommend running this WSGI application with gunicorn. The Docker container available on DockerHub is pre-configured to run with gunicorn, and is preferred. See the Docker Images section in this document for details.
213+
214+
If you wish to run without a container, install gunicorn by either commenting out the line in the ``requirements.txt`` file or simply running ``pip install gunicorn``
208215

209216
In console, run gunicorn with:
210217

@@ -216,8 +223,6 @@ Read the `Gunicorn Docs <http://docs.gunicorn.org/en/stable/configure.html>`_ fo
216223

217224
.. note:: For the *Metrics* section to broadcast via websocket, you must have gunicorn set to 1 worker.
218225

219-
.. note:: The Docker container available on DockerHub is pre-configured to run with gunicorn.
220-
221226
Troubleshooting
222227
---------------
223228

docs/source/static/empty.file

Whitespace-only changes.

docs/source/table-with-code.rst

Lines changed: 0 additions & 35 deletions
This file was deleted.

0 commit comments

Comments
 (0)