diff --git a/knowledge base/gitlab/README.md b/knowledge base/gitlab/README.md index 7238eb0..1de8181 100644 --- a/knowledge base/gitlab/README.md +++ b/knowledge base/gitlab/README.md @@ -1,10 +1,11 @@ # GitLab 1. [TL;DR](#tldr) -1. [Package](#package) -1. [Kubernetes](#kubernetes) - 1. [Helm chart](#helm-chart) - 1. [Operator](#operator) +1. [Setup](#setup) + 1. [Package](#package) + 1. [Kubernetes](#kubernetes) + 1. [Helm chart](#helm-chart) + 1. [Operator](#operator) 1. [Create resources in GitLab using Pulumi](#create-resources-in-gitlab-using-pulumi) 1. [Forking](#forking) 1. [Repository management](#repository-management) @@ -19,10 +20,12 @@ 1. [Keep the latest artifacts for all jobs in the latest successful pipelines](#keep-the-latest-artifacts-for-all-jobs-in-the-latest-successful-pipelines) 1. [Environments](#environments) 1. [Login via Google, Github or other services](#login-via-google-github-or-other-services) +1. [Reset user's passwords](#reset-users-passwords) 1. [API](#api) 1. [Troubleshooting](#troubleshooting) 1. [Use access tokens to clone projects](#use-access-tokens-to-clone-projects) 1. [GitLab keeps answering with code 502](#gitlab-keeps-answering-with-code-502) + 1. [A user is unable to login](#a-user-is-unable-to-login) 1. [Further readings](#further-readings) 1. [Sources](#sources) @@ -50,7 +53,9 @@ curl -fsSL -H 'PRIVATE-TOKEN: glpat-something' 'https://gitlab.fqdn/api/v4/users GitLab uses [GitLab Flavored Markdown (GLFM)] to render Markdown files in its UI.
Since v17.10, one can use Alerts to highlight or call attention to something in GitHub-like fashion. -## Package +## Setup + +### Package Previously known as 'Omnibus'. @@ -269,9 +274,9 @@ sudo dnf remove 'gitlab-ee' -## Kubernetes +### Kubernetes -### Helm chart +#### Helm chart GitLab offers an official helm chart to to allow for deployments on kubernetes clusters. @@ -554,7 +559,7 @@ or consider using the [minimal Minikube example values file] as reference, as st -### Operator +#### Operator See the [operator guide] and the [operator code] for details. @@ -891,6 +896,58 @@ gitlab_rails['omniauth_providers'] = [{ +## Reset user's passwords + +Refer [Reset a user's password]. + +Users can reset their own password by selecting "Forgot your password?" on the sign-in page. + +
+ In the UI + +1. In the upper-right corner, select Admin. +1. Select _Overview_ > _Users_ from the left side menu. +1. Identify the user account to update. +1. Select _Edit_. +1. In the Password section, enter and confirm a new password. +1. Select Save changes. + +
+ +
+ Via Rake task + +```sh +sudo gitlab-rake "gitlab:password:reset" +sudo gitlab-rake "gitlab:password:reset[djones]" +``` + +
+ +
+ Via Rails console + +> [!note] +> The console might take a while to start. + +```sh +sudo gitlab-rails console +``` + +```rb +user = User.find_by_username('djones') +new_password = 'somePassword' +user.password = new_password +user.password_confirmation = new_password +user.password_automatically_set = false +user.send_only_admin_changed_your_password_notification! +user.skip_reconfirmation! +user.save! +exit +``` + +
+ ## API Refer [Extend with GitLab]. @@ -933,6 +990,18 @@ Root cause: the socket's permissions are mapped incorrectly. Solution: set the correct ownership with `docker exec 'gitlab' chown 'gitlab-www:git' '/var/opt/gitlab/gitlab-workhorse/sockets/socket'`. +### A user is unable to login + +Refer [Invalid login or password]. + +1. Check: + + 1. The user exists. + 1. The user is entering the correct credentials. + 1. The user is not blocked, deactivated, or banned. + +1. [Reset their password][reset user's passwords]. + ## Further readings - [Self-hosting] @@ -993,7 +1062,8 @@ Solution: set the correct ownership with --> -[maintenance mode]: #maintenance-mode +[Maintenance mode]: #maintenance-mode +[Reset user's passwords]: #reset-users-passwords [buildah]: ../buildah.md @@ -1032,6 +1102,7 @@ Solution: set the correct ownership with [icons]: https://gitlab-org.gitlab.io/gitlab-svgs/ [install gitlab with the linux package]: https://gitlab.com/gitlab-org/omnibus-gitlab/-/blob/master/doc/installation/index.md [install self-managed gitlab]: https://about.gitlab.com/install +[Invalid login or password]: https://support.gitlab.com/hc/en-us/articles/20488048257052-Invalid-login-or-password [merge request approval rules]: https://docs.gitlab.com/ee/user/project/merge_requests/approvals/rules.html [minimal minikube example values file]: https://gitlab.com/gitlab-org/charts/gitlab/-/blob/master/examples/values-minikube-minimum.yaml [OmniAuth]: https://docs.gitlab.com/integration/omniauth/ @@ -1040,7 +1111,7 @@ Solution: set the correct ownership with [package configuration file template]: https://gitlab.com/gitlab-org/omnibus-gitlab/-/raw/master/files/gitlab-config-template/gitlab.rb.template [Password authentication enabled]: https://gitlab.com/help/administration/settings/sign_in_restrictions.md#password-authentication-enabled [Python SDK]: https://github.com/python-gitlab/python-gitlab -[reset a user's password]: https://docs.gitlab.com/ee/security/reset_user_password.html +[reset a user's password]: https://docs.gitlab.com/security/reset_user_password/ [restore gitlab]: https://docs.gitlab.com/ee/administration/backup_restore/restore_gitlab.html [runners on kubernetes]: https://docs.gitlab.com/runner/install/kubernetes.html [sign-up restrictions]: https://docs.gitlab.com/ee/administration/settings/sign_up_restrictions.html