Commit cf6d1a58 authored by Marcel Amirault's avatar Marcel Amirault

Merge branch '6692-warn-puma-single-mode-docs' into 'master'

Add `use-at-own-risk` warning on Puma Single mode

See merge request gitlab-org/gitlab!82976
parents d61313c8 b6331d65
...@@ -108,6 +108,12 @@ To change the worker timeout to 600 seconds: ...@@ -108,6 +108,12 @@ To change the worker timeout to 600 seconds:
## Disable Puma clustered mode in memory-constrained environments ## Disable Puma clustered mode in memory-constrained environments
WARNING:
This is an experimental [Alpha feature](../../policy/alpha-beta-support.md#alpha-features) and subject to change without notice. The feature
is not ready for production use. If you want to use this feature, we recommend testing
with non-production data first. See the [known issues](#puma-single-mode-known-issues)
for additional details.
In a memory-constrained environment with less than 4GB of RAM available, consider disabling Puma In a memory-constrained environment with less than 4GB of RAM available, consider disabling Puma
[clustered mode](https://github.com/puma/puma#clustered-mode). [clustered mode](https://github.com/puma/puma#clustered-mode).
...@@ -131,6 +137,8 @@ For details on Puma worker and thread settings, see the [Puma requirements](../. ...@@ -131,6 +137,8 @@ For details on Puma worker and thread settings, see the [Puma requirements](../.
The downside of running Puma in this configuration is the reduced throughput, which can be The downside of running Puma in this configuration is the reduced throughput, which can be
considered a fair tradeoff in a memory-constrained environment. considered a fair tradeoff in a memory-constrained environment.
### Puma single mode known issues
When running Puma in single mode, some features are not supported: When running Puma in single mode, some features are not supported:
- [Phased restart](https://gitlab.com/gitlab-org/gitlab/-/issues/300665) - [Phased restart](https://gitlab.com/gitlab-org/gitlab/-/issues/300665)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment