Merge branch 'docs-add-ssh-error-troubleshooting' into 'master'

Add section about troubleshooting SSH push/pull error

See merge request https://gitlab.com/gitlab-org/omnibus-gitlab/-/merge_requests/7534

Merged-by: Jason Plum <jplum@gitlab.com>
Approved-by: Evan Read <eread@gitlab.com>
Approved-by: Jason Plum <jplum@gitlab.com>
Reviewed-by: Evan Read <eread@gitlab.com>
Co-authored-by: Evan Read <eread@gitlab.com>
Co-authored-by: Alexandr Tanayno <atanayno@gitlab.com>
This commit is contained in:
Jason Plum 2024-04-29 16:17:28 +00:00
commit f99bb40bf8
1 changed files with 15 additions and 0 deletions

View File

@ -1048,3 +1048,18 @@ net.core.somaxconn = 1024
You may experience timeouts or HTTP 502 errors and is recommended to increase this
value by updating the `puma['somaxconn']` variable in your `gitlab.rb`.
## `exec request failed on channel 0` or `shell request failed on channel 0` errors
When pulling or pushing by using Git over SSH, you might see the following errors:
- `exec request failed on channel 0`
- `shell request failed on channel 0`
These errors can happen if the number of processes from the `git` user is above the limit.
To try and resolve this issue:
1. Increase the `nproc` setting for the `git` user in the `/etc/security/limits.conf` file on the nodes where `gitlab-shell` is running.
Typically, `gitlab-shell` runs on GitLab Rails nodes.
1. Retry the pull or push Git command.