[Ubuntu] Docker gitlab 설치 및 Mail 기능 활성화

 

 

 

 

(영문도서) Automating DevOps with GitLab CI/CD Pipelines: Build efficient CI/CD pipelines to verify sec... Paperback

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

 

 

🚀 Ubuntu 22.04 LTS Gitlab Docker 설치 

    🔽 개요

        📦 소개

주니가 현재 운영중인 프로젝트 모임에서 사용하는 형상관리 툴은 외부에서 사용할 수 있는 github(깃헙), gitlab(깃랩)이 아닌 gitea(깃티)를 사용하고 있어요.

이는 구성원의 코드 하나하나가 우리의 소중한 자산이고, 최대한 보안적으로 방어하여 외부 유출을 막기 위함이에요.

하지만, 실무에서는 AWS Code Commit(코드 커밋)이나, 깃헙, 깃랩을 많이 사용하고 있기 때문에 실무 기반의 지식을 익히기 위해서 어떻게 해야 할까? 를 고민하게 되었어요.

내부에서 사용중인 서버의 메모리도 충분하고, 깃랩을 내부적으로 설치하면 좋겠다! 라는 결론을 하게 되었고, 이를 통해 도커 기반의 깃랩을 설치하여 운영해 보려고 합니다.

참고로 깃랩 관련 이미지는 gitlab-ce와 gitlab-ee가 있는데, ce는 community (무료),
ee는 enterprise (유료) 전용이에요.

아직 유료 버전을 사용할 이유가 없기 때문에 주니는 ce를 설치할 것이고, 추후 유료 버전을 사용하고 싶을 때, 다시 ee 버전을 설치할 필요가 없어요.

GitLab CE vs EE | InfoGrab, DevOps 전문 기술 기업 | 인포그랩 | GitLab기반 DevSecOps 구축,컨설팅,교육,기술

 

 

    🔽 설치하기

        📦 도커 이미지 내려받기

최초 도커 이미지를 내려 받아 주도록 할게요.

docker pull gitlab/gitlab-ce:latest

728x90

 

 

 

        📦 도커 기동

도커 이미지 기반으로 도커를 기동하는데는 두 가지 방법이 있어요.
첫번째로는 명령어를 입력해서 기동하는 방법이고, 두번째는 Docker Compose(도커 컴포즈)를 이용하는 방법이에요.

만약 명령어를 사용한다면 쉘 스크립트를 만들어서 저장해 놓는걸 추천해요.

docker run --detach \
  --hostname gitlab.example.com \
  -p 1980:80 \ 
  -p 1922:22 \
  -p 1443:443 \
  -v $HOME/gitlab/config:/etc/gitlab \
  -v $HOME/gitlab/logs:/var/log/gitlab \
  -v $HOME/gitlab/data:/var/opt/gitlab \
  --name gitlab \
  --restart=unless-stopped \
  gitlab/gitlab-ce:latest

명령어는 위와 같아요.

명령어 Option	상세 내용
detach	Back Ground 실행
hostname	gitlab 전용 도메인 설정 및 컨테이너 내부 호스트 네임 설정
p(publish)	gitlab에서는 22(ssh), 80(http), 443(https) 포트를 사용하기 때문에 이를 포트포워딩 하기 위한 옵션
name	도커 컨테이너 이름
restart	server가 기동될 때 자동으로 실행하라고 옵션으로 부팅시 자동으로 컨테이너를 재시작하며, 사용자가 종료했을 때는 부팅하지 않도록 설정.
v(volume)	호스트 서버와 도커 컨테이너 간 볼륨 매핑. 호스 서버의 $HOME/gitlab 디렉터리를 만들어주고, 그 곳에 컨테이너에 생성되는 디렉터리 내용을 저장하여 매핑

 

주니는 도커 컴포즈를 이용해서 진행해 보려고 해요.

mkdir config & mkdir logs & mkdir data & mkdir backup

위와 같이 호스트 서버에 도커 컨테이너 볼륨 매핑을 위한 디렉터리를 생성해 주었어요.

docker-compose.yml

docker-compose.yml

반응형

주니는 첫번째 사진과  같이 도커 컴포즈 파일을 만들어 주었어요.
만약 도메인이 있다면 두번째 사진처럼 해 주어도 되요.

environment의 GITLAB_OMNIBUS_CONFIG에 gitlab.rb에 있는 내용을 변경 혹은 삽입할 내용을 넣어 줄 수 있어요.
컨테이너 기동 뒤 컨테이너 내부의 /etc/gitlab 디렉터리에서 gitlab.rb를 확인하면 위 내용이 설정된걸 확인할 수 있어요.

docker-compose up -d

도커를 기동 시켜 보았어요.

docker ps -a

http:{서버 IP}:Web Port 번호

위와 같이 정상적으로 접속 되는 걸 확인할 수 있어요.

    🔽 설정하기

        📦 깃랩 루트 계정 정보 확인 및 접속

이제 깃랩의 루트 계정의 비밀번호를 찾아 볼게요.

최초 깃랩 컨테이너에 접속해 줘야 해요.

docker exec -it {Docker ID 혹은 이름} /bin/bash

 

cat /etc/gi tlab/initial_root_password

이제 접속해 볼게요.

root // 초기 비밀번호

초기 비밀번호 변경

위와 같이 초기 비밀번호를 변경해 주었어요.




이렇게 깃랩을 설치해 보았어요.

혹시라도 궁금하시거나, 피드백 주실 내용이 있으시다면 댓글 부탁드릴게요!

 

 

 

🚀 Mail 기능

    🔽 Gitlab Mail

        📦 Gmail

Gitlab을 통해 작업 등에 대한 알림을 이용자들이 등록한 Mail로 발송될 수 있도록 작업해 줄게요.

최초 주니는 Gmail을 이용해서 Mail이 발송되게 하기 위해 작업을 해줄거에요.

구글에서 위와 같은 화면이 나오면 계정을 선택해 줍니다.

 

그런 뒤 보안 Tab에서 2단계 인증을 클릭해 줄게요.

 

밑으로 내리면 위와 같이 앱 비밀번호가 있을거에요.
이 곳을 클릭해 줄게요.

 

위와 같이 이름을 입력하고, 만들기를 눌러줄게요.

 

그럼 위와 같이 나올텐데, 기기용 앱 비밀번호가 Git Lab의 비밀번호가 될거에요.

 

 

 

        📦 Gitlab 설정

docker exec -it <Container 이름> /bin/bash

위와 같이 Gitlab Docker에 접속해 줍니다.

 

vim /etc/gitlab/gitlab.rb

 

/etc/gitlab/gitlab.rb 수정 전

최초 위와 같이 Email 설정 부분이 주석 처리가 되어 있을 거에요.
이 부분을 손봐주려고 해요.

 

/etc/gitlab/gitlab.rb 수정 뒤

위와 같이 Gmail로 보낼 수 있도록 설정 해 주었어요.
여기서 Password 부분은 위에서 앱 비빌번호로 받은 내용을 넣어주면 돼요.

 

gitlab-ctl reconfigure

위 명령어를 입력하여 설정한 내용이 인식될 수 있도록 해 주었어요.

gitlab-rails console

 

Notify.test_email('junyharang8592@gmail.com', 'Gitlab Mail 테스트', 'GitLab Mailing 확인 중 입니다.').deliver_now

 

위와 같이 Mail이 정상적으로 가는지 확인해 볼 수 있어요.

위와 같이 메일도 잘 도착한 걸 확인할 수 있답니다.

만약 Mail이 오지 않거나, Mail Test 중 Error가 발생한다면 Docker Host Server의 방화벽이 차단하는 것은 아닌지 확인해 볼 필요가 있어요.

 

 

 

🧐 참고 자료

[Docker] GitLab 설치 및 접속하기

 

 

(영문도서) Automating DevOps with GitLab CI/CD Pipelines: Build efficient CI/CD pipelines to verify sec... Paperback

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."