Docker - update documentation
This commit is contained in:
parent
4fb9d3ffd7
commit
f1c7d3fe33
@ -26,7 +26,7 @@ Prerequisites
|
|||||||
- API key from `Dark Sky <https://darksky.net/dev>`__ [not mandatory]
|
- API key from `Dark Sky <https://darksky.net/dev>`__ [not mandatory]
|
||||||
- SMTP provider
|
- SMTP provider
|
||||||
- `Yarn <https://yarnpkg.com>`__ (for development only)
|
- `Yarn <https://yarnpkg.com>`__ (for development only)
|
||||||
- Docker (for development only, to start `MailHog <https://github.com/mailhog/MailHog>`__)
|
- Docker (for development only, to start `MailHog <https://github.com/mailhog/MailHog>`__ or evaluation purposes)
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
| The following steps describe an installation on Linux systems (tested
|
| The following steps describe an installation on Linux systems (tested
|
||||||
@ -635,4 +635,44 @@ Examples (to update depending on your application configuration and given distri
|
|||||||
}
|
}
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
More information on `Gunicorn documentation <https://docs.gunicorn.org/en/stable/deploy.html>`__
|
More information on `Gunicorn documentation <https://docs.gunicorn.org/en/stable/deploy.html>`__
|
||||||
|
|
||||||
|
|
||||||
|
Docker
|
||||||
|
~~~~~~
|
||||||
|
|
||||||
|
.. versionadded:: 0.x.x
|
||||||
|
|
||||||
|
For evaluation purposes (at least for now), docker files are available,
|
||||||
|
installing **FitTrackee** from **sources**.
|
||||||
|
|
||||||
|
- To install **FitTrackee** with database initialisation and run the application and dramatiq workers:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ git clone https://github.com/SamR1/FitTrackee.git
|
||||||
|
$ cd FitTrackee
|
||||||
|
$ make docker-build docker-run docker-init
|
||||||
|
|
||||||
|
Open http://localhost:5000, log in as admin (the email is `admin@example.com` and the password `mpwoadmin`) or register.
|
||||||
|
|
||||||
|
Open http://localhost:8025 to access `MailHog interface <https://github.com/mailhog/MailHog>`_ (email testing tool)
|
||||||
|
|
||||||
|
- To stop **Fittrackee**:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ make docker-stop
|
||||||
|
|
||||||
|
- To start **Fittrackee** (application and dramatiq workers):
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ make docker-run-all
|
||||||
|
|
||||||
|
|
||||||
|
- To run shell inside **Fittrackee** container:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ make docker-shell
|
@ -159,6 +159,7 @@ Map</a>.</div>
|
|||||||
<li class="toctree-l2"><a class="reference internal" href="installation.html#from-pypi">From PyPI</a></li>
|
<li class="toctree-l2"><a class="reference internal" href="installation.html#from-pypi">From PyPI</a></li>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="installation.html#from-sources">From sources</a></li>
|
<li class="toctree-l2"><a class="reference internal" href="installation.html#from-sources">From sources</a></li>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="installation.html#deployment">Deployment</a></li>
|
<li class="toctree-l2"><a class="reference internal" href="installation.html#deployment">Deployment</a></li>
|
||||||
|
<li class="toctree-l2"><a class="reference internal" href="installation.html#docker">Docker</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="features.html">Features</a><ul>
|
<li class="toctree-l1"><a class="reference internal" href="features.html">Features</a><ul>
|
||||||
|
@ -103,6 +103,7 @@
|
|||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a class="reference internal" href="#deployment">Deployment</a></li>
|
<li><a class="reference internal" href="#deployment">Deployment</a></li>
|
||||||
|
<li><a class="reference internal" href="#docker">Docker</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -188,7 +189,7 @@
|
|||||||
<li><p>API key from <a class="reference external" href="https://darksky.net/dev">Dark Sky</a> [not mandatory]</p></li>
|
<li><p>API key from <a class="reference external" href="https://darksky.net/dev">Dark Sky</a> [not mandatory]</p></li>
|
||||||
<li><p>SMTP provider</p></li>
|
<li><p>SMTP provider</p></li>
|
||||||
<li><p><a class="reference external" href="https://yarnpkg.com">Yarn</a> (for development only)</p></li>
|
<li><p><a class="reference external" href="https://yarnpkg.com">Yarn</a> (for development only)</p></li>
|
||||||
<li><p>Docker (for development only, to start <a class="reference external" href="https://github.com/mailhog/MailHog">MailHog</a>)</p></li>
|
<li><p>Docker (for development only, to start <a class="reference external" href="https://github.com/mailhog/MailHog">MailHog</a> or evaluation purposes)</p></li>
|
||||||
</ul>
|
</ul>
|
||||||
<div class="admonition note">
|
<div class="admonition note">
|
||||||
<p class="admonition-title">Note</p>
|
<p class="admonition-title">Note</p>
|
||||||
@ -899,6 +900,42 @@ server {
|
|||||||
<p>More information on <a class="reference external" href="https://docs.gunicorn.org/en/stable/deploy.html">Gunicorn documentation</a></p>
|
<p>More information on <a class="reference external" href="https://docs.gunicorn.org/en/stable/deploy.html">Gunicorn documentation</a></p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
<div class="section" id="docker">
|
||||||
|
<h2>Docker<a class="headerlink" href="#docker" title="Permalink to this headline">¶</a></h2>
|
||||||
|
<div class="versionadded">
|
||||||
|
<p><span class="versionmodified added">New in version 0.x.x.</span></p>
|
||||||
|
</div>
|
||||||
|
<p>For evaluation purposes (at least for now), docker files are available,
|
||||||
|
installing <strong>FitTrackee</strong> from <strong>sources</strong>.</p>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>To install <strong>FitTrackee</strong> with database initialisation and run the application and dramatiq workers:</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/SamR1/FitTrackee.git
|
||||||
|
$ <span class="nb">cd</span> FitTrackee
|
||||||
|
$ make docker-build docker-run docker-init
|
||||||
|
</pre></div>
|
||||||
|
</div>
|
||||||
|
<p>Open <a class="reference external" href="http://localhost:5000">http://localhost:5000</a>, log in as admin (the email is <cite>admin@example.com</cite> and the password <cite>mpwoadmin</cite>) or register.</p>
|
||||||
|
<p>Open <a class="reference external" href="http://localhost:8025">http://localhost:8025</a> to access <a class="reference external" href="https://github.com/mailhog/MailHog">MailHog interface</a> (email testing tool)</p>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>To stop <strong>Fittrackee</strong>:</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ make docker-stop
|
||||||
|
</pre></div>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>To start <strong>Fittrackee</strong> (application and dramatiq workers):</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ make docker-run-all
|
||||||
|
</pre></div>
|
||||||
|
</div>
|
||||||
|
<ul class="simple">
|
||||||
|
<li><p>To run shell inside <strong>Fittrackee</strong> container:</p></li>
|
||||||
|
</ul>
|
||||||
|
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ make docker-shell
|
||||||
|
</pre></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
File diff suppressed because one or more lines are too long
@ -26,7 +26,7 @@ Prerequisites
|
|||||||
- API key from `Dark Sky <https://darksky.net/dev>`__ [not mandatory]
|
- API key from `Dark Sky <https://darksky.net/dev>`__ [not mandatory]
|
||||||
- SMTP provider
|
- SMTP provider
|
||||||
- `Yarn <https://yarnpkg.com>`__ (for development only)
|
- `Yarn <https://yarnpkg.com>`__ (for development only)
|
||||||
- Docker (for development only, to start `MailHog <https://github.com/mailhog/MailHog>`__)
|
- Docker (for development only, to start `MailHog <https://github.com/mailhog/MailHog>`__ or evaluation purposes)
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
| The following steps describe an installation on Linux systems (tested
|
| The following steps describe an installation on Linux systems (tested
|
||||||
@ -635,4 +635,44 @@ Examples (to update depending on your application configuration and given distri
|
|||||||
}
|
}
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
More information on `Gunicorn documentation <https://docs.gunicorn.org/en/stable/deploy.html>`__
|
More information on `Gunicorn documentation <https://docs.gunicorn.org/en/stable/deploy.html>`__
|
||||||
|
|
||||||
|
|
||||||
|
Docker
|
||||||
|
~~~~~~
|
||||||
|
|
||||||
|
.. versionadded:: 0.x.x
|
||||||
|
|
||||||
|
For evaluation purposes (at least for now), docker files are available,
|
||||||
|
installing **FitTrackee** from **sources**.
|
||||||
|
|
||||||
|
- To install **FitTrackee** with database initialisation and run the application and dramatiq workers:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ git clone https://github.com/SamR1/FitTrackee.git
|
||||||
|
$ cd FitTrackee
|
||||||
|
$ make docker-build docker-run docker-init
|
||||||
|
|
||||||
|
Open http://localhost:5000, log in as admin (the email is `admin@example.com` and the password `mpwoadmin`) or register.
|
||||||
|
|
||||||
|
Open http://localhost:8025 to access `MailHog interface <https://github.com/mailhog/MailHog>`_ (email testing tool)
|
||||||
|
|
||||||
|
- To stop **Fittrackee**:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ make docker-stop
|
||||||
|
|
||||||
|
- To start **Fittrackee** (application and dramatiq workers):
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ make docker-run-all
|
||||||
|
|
||||||
|
|
||||||
|
- To run shell inside **Fittrackee** container:
|
||||||
|
|
||||||
|
.. code-block:: bash
|
||||||
|
|
||||||
|
$ make docker-shell
|
Loading…
Reference in New Issue
Block a user