index.rst
122 lines
| 2.7 KiB
| text/x-rst
|
RstLexer
r279 | Welcome to RhodeCode rcstack documentation! | ||
=========================================== | |||
r276 | |||
r279 | ================= | ||
RhodeCode rcstack | |||
================= | |||
r276 | |||
r279 | RhodeCode rcstack is a multi-node highly-scalable setup to run RhodeCode services. | ||
r276 | It consists of all RhodeCode services required with additionally | ||
Edge Router(Traefik with optional SSL) and Metrics Stack (Prometheus, Loki, Grafana) in single environment using Docker. | |||
Using a docker-compose this setup creates following services for RhodeCode: | |||
r278 | **Router (mandatory to run):** | ||
.. code-block:: bash | |||
./rcstack router --help | |||
`Traefik <https://doc.traefik.io/traefik/>`_ aka Edge Router is responsible for handling all outgoing and incoming traffic to whole stack. | |||
r276 | It can do SSL termination, and handle SSL traffic with certificate management. | ||
Traefik listens to few defaults ports and | |||
handles all incoming/outgoing traffic to the stack | |||
r278 | - 80 (HTTP) | ||
- 443 (HTTPS) | |||
r276 | - 9443 (SSH for RhodeCode traffic) | ||
r278 | - 3100 (Loki log aggregation) | ||
**Services (mandatory to run):** | |||
r276 | |||
r278 | .. code-block:: bash | ||
r276 | |||
r278 | ./rcstack services --help | ||
r276 | |||
- Database (defaults to PostgreSQL) Optionally can be replaced by MySQL, or own external database if needed. | |||
- Redis, acts as cache and queue exchange | |||
- ChannelStream - live websocket communications | |||
- Elasticsearch (full text search backend) | |||
- Nginx (static file service) proxy serving RhodeCode static files | |||
r278 | **RhodeCode (mandatory to run):** | ||
.. code-block:: bash | |||
./rcstack rhodecode --help | |||
r276 | |||
- RhodeCode CE/EE web app | |||
- VCSServer for GIT/SVN/HG support | |||
- SSH server for cloning over SSH | |||
r278 | - SVN webserver for SVN protocol support | ||
r276 | - Celery workers for asynchronous tasks | ||
r278 | - Celery beat for scheduler and automation tasks | ||
**Metrics (Optional)** | |||
r276 | |||
r278 | .. code-block:: bash | ||
r276 | |||
r278 | ./rcstack metrics --help | ||
r276 | |||
- Loki, logs aggregation | |||
- Grafana, metrics Dashboard | |||
- Prometheus, metrics time-series | |||
- Statsd-exporter - statsd to Prometheus bridge | |||
- Node-exporter - machine stats and usage | |||
- Promtail - log scraping | |||
.. toctree:: | |||
:maxdepth: 1 | |||
:hidden: | |||
:caption: Installation | |||
install/installation.rst | |||
install/upgrade.rst | |||
.. toctree:: | |||
:maxdepth: 1 | |||
:hidden: | |||
:caption: Configuration | |||
configuration/configuration-overview.rst | |||
configuration/scaling-rhodecode.rst | |||
configuration/enable-ssl-on-traefik.rst | |||
configuration/data-volumes.rst | |||
configuration/set-license-file.rst | |||
r280 | configuration/set-specific-install-version.rst | ||
r276 | |||
.. toctree:: | |||
:maxdepth: 1 | |||
:hidden: | |||
:caption: Migration | |||
migration/migration-to-docker.rst | |||
.. toctree:: | |||
:maxdepth: 1 | |||
:hidden: | |||
:caption: Builds & Images | |||
builds/build-new-image.rst | |||
builds/building-images.rst | |||
.. toctree:: | |||
:maxdepth: 1 | |||
:hidden: | |||
:caption: Changelog | |||
changes.rst |