[Docker] 깃랩(GitLab) 도커 서버 생성 및 실행 [docker-compose]

본 설치 방법은 데비안 계열의 Ubuntu 운영체제를 기준으로 설명한다.


1. 깃햅(GitLab)

  • 설명
    • 깃랩은 소스코드 관리 및 통합, 배포, 이슈 추적 및 협업을 위한 통합 개발 플랫폼 도구이다. 클라우드 버전과 오픈소스 버전이 있으며, 오픈 소스의 경우 무료 버전과 기업용 버전이 있다.
  • 장점
    • 저장소, 이슈트래커, CI/CD, 코드 검사 등의 통합 플랫폼이다.
  • 단점
    • 초기 설정이 복잡하다.
    • 리소스 소모가 크다.
  • 개인적인 의견
    • 깃랩은 여러 무료로 사용 가능한 형상관리 도구 중에 제일 강력하다. 다만, 개인이 운영하기에 가끔씩 시스템 리소스를 많이 사용한다.
    • 현재까지 나온 도구 중에 매우 만족하면서 사용 중이다. 다른 무료 도구들은 경량화되어 사용이 가볍지만 지원하는 기능이 너무 빈약하다.
  • 공식 사이트

2. 준비단계

  • docker 및 docker-compose 가상환경 설치 및 구축
    • 아래 링크 참조.

주의사항

  • GitLab 설치시 메모리 공간은 최소 8GB로 실행하는 것을 추천한다.

3. 설치 방법

  • docker-compose.yaml 파일 생성
    • 아래와 같이 설정파일을 생성한다.
    • GitLab 이미지의 경우, gitlab-ce는 무료 버전이고, gitlab-ee는 기업용 유료 버전인다.
    • hostname과 external_url는 외부 접속 도메인(DNS) 주소를 사용하는 경우 변경한다.
    • 접속 포트를 변경하고 싶은 경우 설정의 https(8443)과 ssh(2222)를 변경한다.
version: '3.4'

services:
  gitlab_server:
    image: 'gitlab/gitlab-ce:latest'
    restart: always
    hostname: 'gitlab_host'
    container_name: gitlab_server
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'https://gitlab_url'
        gitlab_rails['gitlab_shell_ssh_port'] = 2222
    ports:
      - '8443:443'
      - '2222:22'
    volumes:
      - './gitlab/config:/etc/gitlab'
      - './gitlab/logs:/var/log/gitlab'
      - './gitlab/data:/var/opt/gitlab'
      - './gitlab/backup:/var/opt/gitlab/backups'
    shm_size: '256m'

  • docker-compose 실행
    • 아래 명령어를 실행하면 이미지를 다운로드하고 gitlab-ce를 백그라운드로 실행한다.
# docker-compose 실행 명령어
docker-compose up -d

  • docker-compose 상태 확인
    • 아래 명령어를 실행을 통해 GitLab의 상태에 대해 조회한다.
    • 아래 캡처화면과 같이 STATUS가 Up상태이면 정상이다.
# docker-compose 조회 명령어
docker-compose ps

4. 접속 및 설정 방법

  • 접속 방법
    • 웹브라우저를 통해 “http://IP주소:8443″로 접속한다.
    • ex) http:// 192.168.1.100:8443
    • 초기 계정 정보는 아래와 같다.
      • 계정 : root
      • 비밀번호 : 초기 root 비밀번호 파일 위치 [./gitlab/config/initial_root_password]
      • 아래 그림과 같이 초기 root 비밀번호를 조회하면 “Password:”에 확인하고 사용하면 된다.

  • 접속화면 – 로그인
    • 상기의 root와 초기비밀번호로 입력하고 “Sign In” 버튼 클릭

  • 접속화면 – 저장소 화면
    • 로그인이 성공화면 Gitlab 저장소 화면 출력되고 이용하면 된다.

5. 추후 관리 (참고사항)

  • root 비밀번호 변경
  • 출력 언어 영어 -> 한국어 변경
  • 사용 계정 생성 및 권한 설정
  • 조직 및 저장소 생성
  • 저장소 사용 진행.

감사합니다.

Leave a Comment