Ubuntu 22.04에 Docker로 GitLab CE 설치 및 root 비밀번호 초기화

1. 개요

GitLab CE(Community Edition)는 Git 리포지토리 관리 및 CI/CD 기능을 제공하는 강력한 도구입니다. Ubuntu 22.04에서 Docker를 사용하여 최신 GitLab CE를 설치하고, root 계정의 비밀번호를 초기화하는 과정을 정리하겠습니다.

2. GitLab CE Docker 컨테이너 설치

2.1. Docker 설치 (미설치 시)

 

 

2.2. GitLab CE 컨테이너 실행

아래 명령어를 실행하여 최신 GitLab CE를 컨테이너로 배포합니다.

docker run --detach \ 
--hostname gitlab.example.com \
--publish 80:80
--publish 443:443
--publish 2222:22 \
--name gitlab \
--restart always \
--volume /data/gitlab/config:/etc/gitlab \
--volume /data/gitlab/logs:/var/log/gitlab \
--volume /data/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:latest

 

명령어 설명:

• --hostname gitlab.example.com → GitLab의 도메인 지정 (변경 가능)
• --publish 80:80, 443:443, 2222:22 → HTTP, HTTPS, SSH 포트 설정
• --name gitlab → 컨테이너 이름을 gitlab으로 설정
• --restart always → 서버 재부팅 시 자동 시작
• /data/gitlab/config, /data/gitlab/logs, /data/gitlab/data → 데이터 유지용 볼륨 설정

컨테이너 실행 상태를 확인합니다.

docker ps -a

3. GitLab root 계정 비밀번호 초기화

GitLab 설치 후, root 계정의 초기 비밀번호를 찾거나 변경해야 합니다.

3.1. 초기 비밀번호 확인

설치 후 GitLab은 /etc/gitlab/initial_root_password에 임시 비밀번호를 저장합니다.

sudo cat /srv/gitlab/config/initial_root_password

 

위 파일이 존재한다면, 해당 비밀번호를 사용하여 로그인합니다.

3.2. 비밀번호 재설정 (초기 비밀번호 분실 시)

root 계정의 비밀번호를 초기화하려면 다음 단계를 수행합니다.

1. GitLab 컨테이너에 접속
    

   docker exec -it gitlab bash
2. GitLab Rails 콘솔 실행
    

   gitlab-rails console -e production
3. oot 계정 비밀번호 변경
   user = User.find_by(username: 'root')

   user.password = '새로운비밀번호'

   user.password_confirmation = '새로운비밀번호'

   user.save!
4. 콘솔 종료 후 컨테이너 재시작
   exit

   docker restart gitlab

4. GitLab 접속 및 초기 설정

설치가 완료되면 웹 브라우저에서 GitLab에 접속합니다.(http://<서버IP>)

 

로그인 후 사용자 계정을 추가하고 기본 설정을 진행하면 GitLab을 사용할 준비가 완료됩니다.