gitlab 사용자 비밀번호 초기화

gitlab 사용자 비밀번호 초기화

작성자:

GitLab 사용자 비밀번호를 초기화하는 방법에는 여러 가지가 있습니다. 가장 대표적인 방법은 관리 UI, 터미널 명령(Rake), 그리고 Rails 콘솔 사용입니다.​

GitLab 관리자 UI에서 비밀번호 초기화

  • 좌측 하단의 Admin을 클릭합니다.

  • Overview > Users 메뉴로 이동합니다.

  • 비밀번호를 변경할 사용자를 선택하고 Edit을 클릭합니다.

  • Password 항목에 새 비밀번호와 확인 비밀번호를 입력한 뒤 Save changes를 클릭합니다.​

Rake 명령어로 비밀번호 초기화

서버 터미널에서 아래 명령어를 실행합니다.

text
sudo gitlab-rake "gitlab:password:reset"

  • 안내에 따라 사용자 이름, 새 비밀번호를 입력합니다.

  • username을 지정하여 한 번에 실행하려면:

text
sudo gitlab-rake "gitlab:password:reset[사용자이름]"

Rails 콘솔로 비밀번호 직접 초기화

gitlab 사용자 비밀번호 초기화

  1. 서버에 접속해 Rails 콘솔 실행:

    text
    sudo gitlab-rails console -e production

  2. 사용자 객체 조회:

    text
    user = User.find_by(username: '계정이름')

    혹은

    text
    user = User.find_by(email: '이메일주소')

  3. 패스워드 변경:

    text
    user.password = '새비밀번호'
    user.password_confirmation = '새비밀번호'
    user.save!

  4. 콘솔 종료:

    text
    exit

이 방식들은 self-managed GitLab(직접 설치형)에 적용되며, 관리자 권한이 필요합니다. Docker로 설치된 경우도 동일한 방법으로 초기화할 수 있습니다.​

비밀번호가 저장되지 않거나 로그인에 실패할 경우, 패스워드 정책(복잡성, 길이)을 확인하거나 gitlab 서비스를 재시작하여 문제를 해결할 수 있습니다.​

 

Docker에서 실행 중인 GitLab 컨테이너에서 사용자(특히 root) 비밀번호를 변경하는 절차는 아래와 같습니다.​

1. 컨테이너 내부로 진입

text
docker exec -it [컨테이너명 또는 ID] /bin/bash

  • 예: docker exec -it gitlab /bin/bash

2. GitLab Rails 콘솔 실행

text
gitlab-rails console -e production

  • 진입에 몇 초가 걸릴 수 있습니다.

3. 사용자 비밀번호 변경

아래 예시에서 username 또는 이메일로 user 객체를 찾고, 비밀번호를 재설정할 수 있습니다.

ruby
user = User.find_by(username: 'root') # root 계정 찾기 (또는 email로 검색)
user.password = '새비밀번호' # 원하는 비밀번호로 변경
user.password_confirmation = '새비밀번호' # 비밀번호 확인
user.save! # 저장 (true 응답 시 성공)

  • root가 아닌 일반 사용자일 경우 username 부분에 해당 계정명을 입력합니다.

4. 콘솔 및 컨테이너 종료

text
exit # rails console 종료
exit # 컨테이너 bash 쉘 종료

5. (필요 시) 컨테이너 재시작

비밀번호 변경 사항이 바로 반영되지 않거나 문제가 있을 때:

text
docker restart [컨테이너명 또는 ID]

  • 예: docker restart gitlab

참고 사항

  • 패스워드는 GitLab의 정책(복잡성, 길이 등)을 따라야 합니다.

  • 초기에 root 비밀번호를 찾으려면 /etc/gitlab/initial_root_password 파일을 확인할 수 있습니다(설치 후 일정 시간이 지나면 삭제될 수 있음).​

이 방식은 Docker에 올린 self-managed GitLab 인스턴스에서 표준적으로 사용하는 방법입니다.​

 

Git Bash에서 현재 계정 정보를 확인하려면 아래 명령어들을 사용할 수 있습니다.​

사용자 정보 전체 조회

  • 모든 git 설정 값(이메일, 이름 등) 리스트로 출력:

text
git config --list

  • 특정 사용자 항목만 필터링(Linux/Mac):

text
git config --list | grep '^user\.'

  • PowerShell(Windows)에서는:

text
git config --list | Select-String "^user\."

사용자 이름 및 이메일 개별 확인

  • 현재 설정된 사용자 이름:

text
git config user.name

  • 현재 설정된 사용자 이메일:

text
git config user.email

전역 계정 정보 확인

  • 시스템 전체에 적용된(user.name, user.email) 값만 확인:

text
git config --global user.name
git config --global user.email

로컬(저장소 기준) 계정 정보 확인

  • 현재 저장소에 등록된 계정 정보:

text
git config --local user.name
git config --local user.email

위 명령어를 사용해 Git Bash에서 언제든 현재 계정 정보를 확인할 수 있습니다.​