Gitlab 설치

깃랩을 설치할 것이다. 프로젝트 관리 정도는 할 수 있어야 서버라고 할 수 있지 않겠는가..

깃랩은 도커에서 깃랩 이미지를 받아서 설치할 것이다.

docker와 docker-compose 만 설치되어 있으면 된다.

 

1. gitlab 도커 이미지 다운로드

# docker pull gitlab/gitlab-ce

pulling gitlab docker image

 

2. docker-compose 파일 작성

 - gitlab에 대한 설정, 로그 파일 등을 저장하기 위해 디렉토리를 하나 만들었다.

made gitlab directory

 - 생성한 디렉토리 아래에 docker-compose.yml 파일을 만들자.

version: '3.6' services:   gitlab:     image: 'gitlab/gitlab-ce:latest'     container_name: 'gitlab_sh'     restart: always     hostname: 'gitlab.example.com'     environment:       GITLAB_OMNIBUS_CONFIG: |         external_url 'http://gitlab.example.com'     ports:        - "18080:80"       volumes:       - '$HOME/gitlab/config:/etc/gitlab'       - '$HOME/gitlab/logs:/var/log/gitlab'       - '$HOME/gitlab/data:/var/opt/gitlab'     logging:       driver: 'json-file'       options:         max-size: '10m'         max-file: '10'

contents in docker-compose.yml

 - 내려받은 docker 이미지 자체를 사용할 것이고 컨테이너 이름, 포트, 볼륨을 맺을 위치 정도를 설정해 주었다.

 - 난 "18080"으로 접속 시 깃랩에 접속되도록 설정했지만, "18080" 대신 원하는 포트로 바꿔도 된다. 이 외에 딱히 바꿀만한 요소는 없을 것 같다.

 

 

3. 컨테이너 생성 및 서비스 시작

 - docker-compose를 이용해 컨테이너를 생성하고 서비스를 시작한다.

# dc up -d

Create docker container and start it

4. 도커 상태 확인

 - docker 서비스를 처음 시작하면 "running(starting)" 상태를 가질 것이다. gitlab 서비스가 정상적으로 동작하기까지 시간이 조금 걸린다.. ( 5~10분 정도..? )

 - gitlab 서비스에 대한 로그를 확인했을 때 서비스가 정상적으로 실행됐다는 출력문이 나타나면 정상적으로 동작된다는 것을 알 수 있는데, 그 로그를 놓쳐서 캡처를 못했다..

 - 어쨌든 정상적으로 서비스가 작동하는 중이라면 docker 상태를 확인했을 때 다음과 같이 나타난다.

check docker status

 

5. 접속해 보기

 - gitlab을 설치한 호스트의 IP, docker-compose.yml에서 설정한 포트를 확인해 gitlab 웹 사이트에 접속해 보자.

 - 브라우저를 열어 "ip:port"를 입력해 접속하면 된다.

try connecting gitlab website

 

6. root 계정 접속하기

 - gitlab 을 시작하면 기본적으로 root 계정이 존재한다. 그러나 해당 암호는 처음에 시스템(?)이 설정해 준다. 

 - 그래서 root 계정에 대한 초기 암호를 찾으려면 gitlab docker 컨테이너 안에서 해당 계정에 대한 암호를 찾아야 한다.

 - docker container에 접근한 다음 암호를 담고 있는 파일을 확인해 보자.

# dc exec gitlab bash

execute docker container's bash

 - 다음 경로의 파일을 확인하여 root 계정의 암호를 확인한다. ( 해당 명령어는 반드시 컨테이너 안에서 실행해야 합니다..!)

root@gitlab:/# cat /etc/gitlab/initial_root_password

check root password

 - 파일 내의 Passwrod: ~ 부분에 root에 대한 암호가 기록되어 있다.

 - 해당 암호를 이용해 gitlab에 root 계정으로 로그인할 수 있다.

 

7. root 계정 암호 변경

 - root 계정의 암호를 초기에 생성된 암호로 계속 사용할 수는 없을 것이다. 따라서, root 계정의 암호를 변경하자.

 - gitlab에 로그인하고 좌측 상단에 있는 계정 아이콘(?)을 클릭하면 목록이 뜨는데, 해당 목록에서 [Edit profile] 버튼을 클릭한다.

 - 버튼을 클릭하면 좌측 메뉴 중에 [Password] 항목이 존재한다. 해당 버튼을 클릭하면 암호를 변경할 수 있는 페이지가 표시된다. 해당 페이지에서 암호를 변경할 수 있다.

changing password

 

- 이제 프로젝트를 소스 코드는 여기서 관리한다.